Just launched
We're actively working on new content and improvements to our documentation. We'd love to hear your thoughts, launch quick survey
Paddle Billing

Paddle IDs

Paddle IDs are unique identifiers for entities in Paddle. They easily identifiable by type and lexicographically sortable.

Every entity in Paddle has a unique identifier, called a Paddle ID. Paddle IDs are made up of a prefix for the kind of entity, followed by a unique string of alphanumeric characters.

Prefixes are typically three characters, but may be longer. They're distinctive, so it's easy to tell what kind of entity you're working with when using a Paddle ID.

Common examples

For example, here are some common Paddle IDs:

Notification destinationnftset_ntfset_01gtyac3wjcdtjs8csc0219x1p

Work with IDs

Paddle automatically generates IDs for you when you create entities using the API or dashboard. Use Paddle IDs to refer to entities throughout the Paddle platform.

Create entities

When creating entities using the API, Paddle returns the new Paddle ID for the entity in the response.

Get entities

When reading, updating, or deleting entities, use the ID to refer to the correct entity. For example:

List entities

When working with list endpoints, Paddle uses the Paddle ID of the entity you're working with as the cursor for pagination.

Relate entities

Where entities are related, use Paddle IDs to link them. For example:

Sort by ID

Paddle IDs are lexicographically sortable. Sorting by Paddle ID results in the same order as sorting by the creation date of an entity.

List endpoints return entities created oldest first (i.e. id=[ASC]).

Related pages