Object IDs

Every Trile object has a string ID of the form <prefix>_<ULID>, e.g. sub_01ARZ3NDEKTSV4RRFFQ69G5FAZ.

Properties

• Prefixed — the prefix tells you the object type at a glance (and in logs).
• ULID-based — the 26-character suffix is a ULID: lexicographically sortable by creation time, so sorting IDs sorts by age.
• Opaque — treat the whole string as the identifier. Don’t parse or construct IDs yourself; store them as given.
• Stable — an object’s ID never changes.

Prefix reference

Prefix	Object
biz	Business (merchant account)
cus	Customer
prod	Product
price	Price
sub	Subscription
inv	Invoice
evt	Event (domain event in the log)
txn	Wallet transaction
led	Wallet ledger entry
wal	Wallet
pnd	Pending top-up
wdr	Withdrawal
cs	Checkout session
clink	Checkout link
whk	Webhook endpoint
wda	Webhook delivery attempt
br	Billing run
ipa	IP allowlist entry
tmem	Team member
tinv	Team invite
aud	Audit log entry
req	Request correlation ID (in meta.requestId; a short nanoid, not a ULID)

Tip

Because IDs sort by time, you can use them as stable tiebreakers in your own storage. But for paging the API, use the cursor Trile gives you rather than rolling your own ID comparison.