Get post

View .md

Get a single post by its id, with its per-account delivery results.


Fetch a single post by its id, with its per-account delivery results (platform_post_id, platform_post_url, warnings).

GET/v1/posts/{id}
API key (dra_…) or dashboard JWT

Get a single post by id, with its per-account delivery results.

Authorizationstringheaderrequired

Bearer token. Use a Dravo API key (`dra_…`) or a dashboard JWT.

idstringpathrequired

The post id.

idstring

Dravo post id.

statusstring

Overall post status: queued, processing, published, partial, failed, canceled or scheduled.

textstring

Post body.

media_urlsstring[]

Media URLs attached to the post.

platform_optionsobject

Per-platform publish options that were applied, keyed by platform (same shape as the create request).

platformsobject[]

One entry per target account — the platform, the account, and the delivery result together. Accounts not yet delivered inherit the post status with null result fields. Each entry is an object with these fields:

platformstring

Platform this delivery targeted: instagram, facebook, x, linkedin or tiktok.

accountobjectoptional

The target account. null if the account was deleted after publishing (the delivery is still kept). Object with these fields:

idstring

Connected account id.

handlestringoptional

Account handle / username.

avatar_urlstringoptional

Account avatar URL.

platformstring

Platform of this account.

statusstring

Per-account delivery status: queued, processing, published, partial, failed or canceled.

platform_post_idstringoptional

Native id of the post on the platform.

platform_post_urlstringoptional

Direct link to the published post.

error_codestringoptional

Machine-readable error code when the delivery failed.

error_messagestringoptional

Human-readable error detail when the delivery failed.

warningsstring[]

Non-fatal notices (e.g. a first comment could not be created).

delivered_atstring (ISO 8601)optional

When this delivery was recorded. null if the account has not been delivered yet.

error_messagestringoptional

Aggregated failure detail when the post failed or partially failed.

scheduled_atstring (ISO 8601)optional

When the post is scheduled to publish, if scheduled.

queued_atstring (ISO 8601)optional

When the post entered the queue.

processing_atstring (ISO 8601)optional

When the worker started processing the post.

published_atstring (ISO 8601)optional

When the post finished publishing.

canceled_atstring (ISO 8601)optional

When the post was canceled, if canceled.

created_atstring (ISO 8601)

When the post was created.

Error codes

404

Post not found.

const response = await fetch("https://api.dravo.dev/v1/posts/{id}", {  method: "GET",  headers: {  "Authorization": "Bearer " + process.env.DRAVO_API_KEY,}});const data = await response.json();console.log(data);
{  "id": "post_2a7f93",  "status": "published",  "text": "Shipping Dravo…",  "media_urls": [    "https://cdn.dravo.dev/u/abc/2f1c....jpg"  ],  "platform_options": {    "x": {      "reply_settings": "following"    }  },  "platforms": [    {      "platform": "x",      "account": {        "id": "acc_8f2c1d",        "handle": "@dravo",        "avatar_url": "https://cdn.dravo.dev/avatars/acc_8f2c1d.jpg",        "platform": "x"      },      "status": "published",      "platform_post_id": "1890…",      "platform_post_url": "https://x.com/i/status/1890…",      "error_code": null,      "error_message": null,      "warnings": [],      "delivered_at": "2026-06-23T10:15:31Z"    },    {      "platform": "linkedin",      "account": {        "id": "acc_3b71e0",        "handle": "Dravo",        "avatar_url": null,        "platform": "linkedin"      },      "status": "published",      "platform_post_id": "urn:li:share:7890…",      "platform_post_url": "https://www.linkedin.com/feed/update/urn:li:share:7890…",      "error_code": null,      "error_message": null,      "warnings": [],      "delivered_at": "2026-06-23T10:15:32Z"    }  ],  "error_message": null,  "scheduled_at": null,  "queued_at": "2026-06-23T10:15:30Z",  "processing_at": "2026-06-23T10:15:30Z",  "published_at": "2026-06-23T10:15:32Z",  "canceled_at": null,  "created_at": "2026-06-23T10:15:30Z"}