Skip to main content

Get post results

GET 

/posts/:id/results

Returns per-platform publishing results for a post, including published URLs, error messages, attempt counts, and retry schedules.

When to use this endpoint

GET /v1/posts/{post_id} already returns a destinations[] array with the same per-platform state. Use /results when you want a lighter response focused on publish outcomes (no content, no media hydration, no platform_content). Both endpoints use the same canonical field names — post_id, platform, account_id, status, platform_post_url, published_at.

Path Parameters

ParameterTypeRequiredDescription
post_idstring (UUID)YesUUID of the post whose results you want. Accepts id as a deprecated alias in the URL path.

Response Example

200 — Post results

{
"data": {
"post_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"post_status": "published",
"results": [
{
"account_id": 2280,
"account_name": "@mybrand",
"platform": "instagram",
"status": "published",
"published_at": "2026-04-15T14:30:05.000Z",
"platform_post_id": "17895432678901234",
"platform_post_url": "https://www.instagram.com/p/ABC123/",
"error": null,
"attempts": 1,
"next_retry_at": null
},
{
"account_id": 2282,
"account_name": "@mybrand",
"platform": "x",
"status": "published",
"published_at": "2026-04-15T14:30:03.000Z",
"platform_post_id": "1780123456789012345",
"platform_post_url": "https://x.com/mybrand/status/1780123456789012345",
"error": null,
"attempts": 1,
"next_retry_at": null
},
{
"account_id": 2285,
"account_name": "My Brand Inc.",
"platform": "linkedin",
"status": "failed",
"published_at": null,
"platform_post_id": null,
"platform_post_url": null,
"error": "Token expired. Please reconnect your LinkedIn account.",
"attempts": 3,
"next_retry_at": null
}
]
},
"error": null,
"meta": {
"request_id": "a1b2c3d4",
"timestamp": "2026-04-15T15:00:00.000Z"
}
}

Result object fields

Each entry in results[] represents the post's outcome on one connected social account.

FieldTypeDescription
account_idintegerAccount ID (matches an entry in the original request's account_ids)
account_namestring or nullAccount username or display name
platformstringPlatform name (e.g. instagram, x, linkedin)
statusstringqueued, publishing, published, or failed
published_atstring (ISO 8601) or nullUTC timestamp of successful publish on this platform (Z suffix)
platform_post_idstring or nullThe platform's native post ID
platform_post_urlstring or nullDirect URL to the published post on the platform
errorstring or nullHuman-readable error message if the destination failed
attemptsintegerNumber of publish attempts made
next_retry_atstring (ISO 8601) or nullUTC timestamp of the next scheduled retry (null if not retrying)

Request

Responses

Post results