API reference

List the creator’s drops

Every drop on the account, newest first, with price, who can buy it, moderation status and checkout URL — including drops made in the dashboard.

View as MarkdownUpdated Oct 26, 2026

GET/api/external/v1/dropsalso served at /api/external/dropsNew

Every drop on the account, newest first, with price, who can buy it, moderation status and checkout URL — including drops made in the dashboard.

Page with cursor: pass the nextCursor of the previous page until it is null. For per-media status and sales of one drop, use GET /api/external/v1/drops/{id}.

Authentication

Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.

For a creator you manage or onboarded

GET /api/external/v1/creators/{creatorId}/drops — an agency's own key for a creator or AI persona it manages (needs canManageDrops), or your app owner's own key for an account your app onboarded. The X-Dropfans-Account header still works but is deprecated. See Acting for a creator.

Query parameters

Name	Type	Required	Description
`limit`	integer	Optional	Page size (out-of-range values are clamped). Default: `50` Min: 1 Max: 100
`cursor`	string	Optional	`nextCursor` from the previous page.

Responses

200A page of drops.

Name Type Description

drops

DropSummary[]

Newest first.

Show child attributes

`id`	string	The product (drop) id.
`name`	string \| null	Drop title.
`description`	string \| null	Drop description (only set by editing — create-drop discards it).
`price`	number	USD dollars. 0 means free.
`currency`	string	Always "USD". One of: `USD`
`accessMode`	string	`OPEN` = anyone can buy; `SUBS_FREE` = free for subscribers; `SUBS_ONLY_PAID` = only subscribers can buy. One of: `OPEN`, `SUBS_FREE`, `SUBS_ONLY_PAID`
`allowDownload`	boolean	Images only: buyers get a watermarked download.
`status`	string	The drop’s moderation status. One of: `PENDING`, `APPROVED`, `REJECTED`, `FLAGGED`
`mediaCount`	integer	Attached media items.
`buyUrl`	string	With an app key: your app’s plain buy link id (`/buy/{linkId}`) — created by POST /drops; reads return it when it exists, else `/buy/{productId}` (a drop your app created still counts for it). With a personal key: `/buy/{productId}`. For a per-fan reference, create a link with POST /api/external/v1/links. Format: uri
`linkId`	string \| null	The link id in buyUrl (app keys only); comes back as linkId on the sale.
`createdAt`	string	Creation time. Format: date-time

nextCursor string | null Pass as cursor for the next page; null on the last page.

Example response

{
  "drops": [
    {
      "id": "clxdr0p000001prod",
      "name": "Beach set — 6 photos",
      "description": null,
      "price": 25,
      "currency": "USD",
      "accessMode": "OPEN",
      "allowDownload": false,
      "status": "APPROVED",
      "mediaCount": 3,
      "buyUrl": "https://www.dropfans.io/buy/clxdr0p000001prod",
      "createdAt": "2026-08-15T09:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Errors

Status	Body	When
401	`{"error":"Unauthorized","code":"unauthorized"}`	Missing or invalid API key.
400	`{"error":"X-Dropfans-Account must be an account id (from GET /api/external/agency/creators), not a username.","code":"invalid_account_header"}`	`X-Dropfans-Account` is not an account id.
400	`{"error":"X-Dropfans-Account names a different account than the path — send one or the other.","code":"account_mismatch"}`	Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account.
403	`{"error":"This key cannot act for that account.","code":"account_not_managed"}`	The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer.
403	`{"error":"The agency does not have permission for this on that account.","code":"permission_denied","permission":"canManageDrops"}`	For a managed creator: the agency lacks `canManageDrops` on that account.
403	`{"error":"This app does not have the drops API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"drops"}`	Your app has the Drops & checkout links [API category](/developers/concepts/api-categories) switched off.

Rate limiting

Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.

Code samples

curl "https://www.dropfans.io/api/external/v1/drops" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"

const res = await fetch(`https://www.dropfans.io/api/external/v1/drops`, {
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
  },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.dropfans.io/api/external/v1/drops",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())

← Previous

Create a sellable drop from vault items

Read back a drop

Questions? support@dropfans.io