Check one post’s moderation status
One post, as a **bare object** (not wrapped). The polling endpoint after a PENDING create: check `status` and `live`.
/api/external/v1/posts/{id}also served at /api/external/posts/{id}One post, as a bare object (not wrapped). The polling endpoint after a PENDING create: check status and live.
A sensible poll cadence is every 30–60 seconds while PENDING; media moderation usually resolves within minutes.
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}/posts/{id} — 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.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The post id. |
Responses
| Name | Type | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | string | Post id. | |||||||||||||||
kind | string | Post shape. DROP is derived from productId at creation — it is not an accepted request value. One of: TEXT, DROP, SUBSCRIPTION, COMMUNITY, MEDIA | |||||||||||||||
caption | string | null | Post text. Null for caption-less media posts. | |||||||||||||||
status | string | Moderation state. PENDING is normal for media posts and is not an error — poll until it becomes APPROVED. One of: PENDING, APPROVED, REJECTED, FLAGGED | |||||||||||||||
live | boolean | True only when the post is APPROVED and its publish time has passed. | |||||||||||||||
scheduledAt | string | null | When the post is scheduled to go live, or null for immediate posts. Format: date-time | |||||||||||||||
publishedAt | string | Effective publish time. Format: date-time | |||||||||||||||
createdAt | string | Creation time. Format: date-time | |||||||||||||||
productId | string | null | The attached drop, for kind=DROP. Null otherwise. | |||||||||||||||
likes | integer | Like count. | |||||||||||||||
comments | integer | Comment count. | |||||||||||||||
media | PostMedia[] | Media entries in display order. Empty for TEXT posts.Show child attributes
|
{
"id": "clxp0st000001feed",
"kind": "MEDIA",
"caption": "rate my fit 1-10",
"status": "APPROVED",
"live": true,
"scheduledAt": null,
"publishedAt": "2026-08-18T19:00:00.000Z",
"createdAt": "2026-08-18T18:59:40.000Z",
"productId": null,
"likes": 14,
"comments": 3,
"media": [
{
"id": "clxpm3d1a0001post",
"vaultItemId": "clxv1a2b30001item",
"isPaid": false,
"order": 0,
"type": "image"
}
]
}Errors
| Status | Body | When |
|---|---|---|
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 404 | {"error":"Post not found"} | No such post on your account. Deliberately 404 (not 403) for another creator’s post — ids cannot be probed. |
| 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 posts API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"posts"} | Your app has the For You posts [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/posts/$POST_ID" \
-H "Authorization: Bearer $DROPFANS_API_KEY"const postId = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/v1/posts/${postId}`, {
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
},
});
console.log(await res.json());import os
import requests
post_id = "…" # from an earlier response
res = requests.get(
f"https://www.dropfans.io/api/external/v1/posts/{post_id}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())Questions? support@dropfans.io