List your drops
Every drop the authenticated creator owns, newest first, with its supply accounting and the brand kit it renders with resolved. Another creator's drop is not in this list.
Every drop the authenticated creator owns, newest first, with its supply accounting and the brand kit it renders with resolved. Another creator's drop is not in this list.
Authorization
bearerAuth A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/creator/drops"{ "drops": [ { "id": "string", "name": "string", "symbol": "string", "description": "string", "brandKitId": "string", "brand": { "id": "string", "name": "string", "tagline": "string", "palette": { "property1": "string", "property2": "string" }, "fonts": { "heading": { "family": "string", "weights": [ 0 ] }, "body": { "family": "string", "weights": [ 0 ] } } }, "imageUrl": "string", "priceUsd": "string", "creatorAddress": "string", "status": "draft", "supply": { "supply": 0, "minted": 0, "remaining": 0, "soldOut": true }, "mintPageUrl": "string", "createdAt": "string", "updatedAt": "string" } ]}The public drop as JSON GET
The same public view the mint page renders, as JSON, for a client that wants the drop's name, price, and remaining supply without parsing HTML. **No bearer token is required.** The shape is a strict subset of the creator's own view: no `creatorAddress` is withheld here, no brand-kit id, no status. The `supply` block is recomputed on every read, so a collector polling this never sees a stale remaining count. A draft, a foreign drop, and a missing id are the same 404.
Create a drop POST
Registers a drop: a collection rendered with one of your brand kits, with a fixed supply and a price per edition. **The drop renders with your brand kit; it does not copy it.** `brandKitId` must be a kit you own, and the drop reads its colours and fonts from that kit on every render — so editing the brand edits every drop that renders with it. A kit id belonging to another creator is refused with the same answer as one that does not exist, so this route cannot be used to find out whose kits exist. **`supply` is fixed here and can never be changed.** Every buyer of an edition was promised a collection of a given size, and a collection that grows after the fact is not that. **A drop priced above zero needs `creatorAddress` — your own wallet.** putty never holds a creator's takings: the address is handed to the payment provider so the money goes from the collector straight to you. There is no default address and no fallback, so a paid drop with no address is refused rather than quietly pointed somewhere putty controls. A `priceUsd` of "0.00" is a free mint and needs no address.