The id glossary
Every id on the wire is typed by a short prefix. Read a subject's kind at a glance, before you dereference it.
Every subject on the wire carries a typed-prefix id — a short prefix, an
underscore, then an opaque identifier. The prefix tells you the kind of thing
before you dereference it: GET /{subjectId} resolves any of them to its
universal snapshot. The VIN is the one exception — the
17-character number is itself the vehicle's address.
Reading a prefix
deal_7Qm2… a deal, resolvable at GET /deal_7Qm2…
pty_9xKf… a party (a person or a company)
mnd_3rP0… a Mandate — a delegated authority with a ceilingThe prefixes
These are the subject prefixes the catalog uses. Each resolves through the same
GET /{subjectId} primitive.
| Prefix | Subject | Seen on |
|---|---|---|
vk_ | an API key (vk_sandbox_… / vk_live_…) | POST /keys |
mnd_ | a Mandate — delegated authority { ceiling, perAction, expires, tripwires } | every act with mandate: required-when-delegated |
deal_ | a deal on the Deal ledger | the buy and commerce rows |
pty_ | a party — a person or company in the directory | party.register |
dlr_ | a dealer — a supply-side party | the dealer rows |
doc_ | a document in the vault | e-contracting and notarization |
conn_ | a connected account on the connections rail | connection.accounts |
link_ | a link session — a credential ceremony in flight | connection.link |
acc_ | an account reference behind a connection | connections sync |
pol_ | an insurance policy | insurance.prove |
clm_ | a claim | insuranceClaim.open |
pay_ | a payment on the money rail | payment.settle |
esc_ | an escrow hold | escrow.fund |
off_ | an offer | the offer rows |
poq_ | a payoff quote | payoff.quote |
lead_ | a lead | lead.capture |
job_ / ord_ | a service job / order on the quote → order chassis | the Services rows |
inv_ | an invoice | invoice.issue |
grg_ | a garage — the owner register | garage.register |
ttl_ | a title | title.transfer |
agt_ | an agent in the registry | mcp.register |
evt_ | a ledger event | the event registry |
The list is not memorized — it is read. Any prefix you meet resolves the same
way: GET /{subjectId} returns the subject's snapshot, and the snapshot names
its own kind.
Money is a decimal string
Every monetary amount on the wire is a decimal string. Never a float, never cents-as-integer. The one rule that prevents the worst class of bug.
Journeys
Curated end-to-end workflow narratives — every step a catalog capability, every snippet runnable against the sandbox world, every shown answer a deterministic claim.