Get Post Status

Check Post Status

Endpoint

Base URL: https://backend.blotato.com/v2

URL: /posts/:postSubmissionId

Method: GET

Rate Limit: 60 requests / minute

Description

Poll this endpoint to check the publishing status of a post. After submitting a post with Create Post, use the returned postSubmissionId to track its progress.

Request

Path Parameters

Field	Type	Required	Description
postSubmissionId	string	Yes	The post submission ID returned by the Create Post endpoint.

Responses

Success Response

Status Code: 200 OK

The response shape depends on the current status:

Published (terminal - success):

{
  "postSubmissionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "published",
  "publicUrl": "https://x.com/user/status/123456"
}

Failed (terminal - error):

{
  "postSubmissionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "failed",
  "errorMessage": "Unsupported media type"
}

In Progress (keep polling):

{
  "postSubmissionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "in-progress"
}

Scheduled (queued for a future time):

{
  "postSubmissionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "scheduled",
  "scheduledTime": "2025-03-10T15:30:00Z"
}

Response Keys

Field	Type	Description
postSubmissionId	string	The post submission ID.
status	string	One of: in-progress, scheduled, published, failed.
scheduledTime	string	The scheduled publish time. Present when status is scheduled.
publicUrl	string	The live URL of the published post. Present when status is published.
errorMessage	string	Description of the failure. Present when status is failed.

Polling Strategy

1. Poll every 2 seconds after submitting a post.

2. Continue while status is in-progress.

3. If status is scheduled, the post is queued for the returned scheduledTime.

4. Stop when status is published (success) or failed (error).

5. Do not retry on failed -- most failures are permanent. Check errorMessage for details.

Failed posts are also visible at https://my.blotato.com/failed.

Example

GET https://backend.blotato.com/v2/posts/a1b2c3d4-e5f6-7890-abcd-ef1234567890 HTTP/1.1
blotato-api-key: YOUR_API_KEY