Get Post
Retrieve the details of a post by its ID.
Retrieve the details of a post by its ID.
/api/v1/post/{postId}Retrieve the full details of a post including its status, content, and schedule.
Replace {postId} with the postId returned from the Publish endpoint.
curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/post/<postId>curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/post/<postId>{
"id": "cm3abc123def456",
"status": "PUBLISHED",
"platform": "LINKEDIN",
"text": "Hello from the dopost API!",
"media": [],
"postUrl": "https://linkedin.com/feed/update/urn:li:share:123456",
"account": {
"id": "cm3xyz789ghi012",
"platform": "LINKEDIN",
"platformUsername": "johndoe"
},
"schedule": null,
"jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"source": "api",
"createdAt": "2025-06-01T12:00:00.000Z",
"updatedAt": "2025-06-01T12:00:05.000Z"
}{
"id": "cm3abc123def456",
"status": "PUBLISHED",
"platform": "LINKEDIN",
"text": "Hello from the dopost API!",
"media": [],
"postUrl": "https://linkedin.com/feed/update/urn:li:share:123456",
"account": {
"id": "cm3xyz789ghi012",
"platform": "LINKEDIN",
"platformUsername": "johndoe"
},
"schedule": null,
"jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"source": "api",
"createdAt": "2025-06-01T12:00:00.000Z",
"updatedAt": "2025-06-01T12:00:05.000Z"
}| Field | Type | Description |
|---|---|---|
id | string | Unique post ID |
status | string | PENDING, PROCESSING, PUBLISHED, FAILED, or DRAFT |
platform | string | Target social platform |
text | string | null | Post text content |
media | array | Media URLs attached to the post |
postUrl | string | null | URL of the published post on the platform (available after publishing) |
account | object | Social account the post was published to |
schedule | object | null | Schedule details if the post was scheduled |
jobId | string | null | Group ID for tracking with the Status endpoint |
source | string | Where the post was created from (api, dashboard) |
createdAt | string | ISO 8601 creation timestamp |
updatedAt | string | ISO 8601 last update timestamp |
{
"id": "cm3def456ghi789",
"status": "PENDING",
"platform": "INSTAGRAM",
"text": "Coming soon!",
"media": ["https://cdn.dopost.co/uploads/photo.jpg"],
"postUrl": null,
"account": {
"id": "cm3jkl012mno345",
"platform": "INSTAGRAM",
"platformUsername": "janedoe"
},
"schedule": {
"scheduledFor": "2025-12-25T12:00:00.000Z",
"status": "SCHEDULED",
"publishedAt": null
},
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"source": "api",
"createdAt": "2025-06-01T10:00:00.000Z",
"updatedAt": "2025-06-01T10:00:00.000Z"
}{
"id": "cm3def456ghi789",
"status": "PENDING",
"platform": "INSTAGRAM",
"text": "Coming soon!",
"media": ["https://cdn.dopost.co/uploads/photo.jpg"],
"postUrl": null,
"account": {
"id": "cm3jkl012mno345",
"platform": "INSTAGRAM",
"platformUsername": "janedoe"
},
"schedule": {
"scheduledFor": "2025-12-25T12:00:00.000Z",
"status": "SCHEDULED",
"publishedAt": null
},
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"source": "api",
"createdAt": "2025-06-01T10:00:00.000Z",
"updatedAt": "2025-06-01T10:00:00.000Z"
}| Status | Error | Cause |
|---|---|---|
401 | Invalid or missing API key | Bad or missing x-api-key header |
403 | API key does not have permission for this action | API key lacks the required scope for this endpoint |
404 | Post not found | Invalid postId or post belongs to another workspace |
429 | Rate limit exceeded | Too many requests. Check X-RateLimit-* response headers and retry after the indicated time |
Only GOOGLE_BUSINESS posts include platformOptions (post type, category, CTA, event dates and offer fields), providerStatus, providerResourceName, and error. Error is null or { message, code, retryable, requiresReconnect, details? }; unknown values remain null. Google state is the latest returned at submission, not a live status check. Dopost PUBLISHED does not guarantee Google has made the content visible yet. Post lists include the same fields. Other platforms retain their response shape.