/api/v2/posts/{postId}GETFetches a single post by ID, including per-platform status,
publish errors, and native post IDs/URLs once published.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Path Parameters
postId *string
Post ID
Response
200
postId *string
Post ID
content?string
status?"draft" | "pending" | "scheduled" | "publishing" | "published" | "failed" | "partial"
scheduledFor?string | null
ISO 8601 scheduled datetime
timezone?string | null
mediaItems?object[] | null
platforms?object[]
Show item properties
platform *"twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
status?"draft" | "pending" | "scheduled" | "publishing" | "published" | "failed" | "partial"
content?string | null
Per-platform text override used for this platform, null when the top-level content was used
platformPostId?string | null
Native post ID on the platform
platformPostUrl?string | null
Direct URL to the published post
publishedAt?string | null
errorMessage?string | null
warningMessage?string | null
createdAt?string | null
updatedAt?string | null
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
404 · Resource not found
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
429 · Upstream rate limit reached
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
503 · Upstream service temporarily unavailable or submission outcome unknown
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details