/api/v2/postsGETLists posts in your workspace with filtering and pagination. Drafts live under the drafts endpoints.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Query Parameters
status?"draft" | "pending" | "scheduled" | "publishing" | "published" | "failed" | "partial"
Filter posts by status
platforms?string
Comma-separated platform names to filter by
createdAfter?string
Only posts created after this ISO time
createdBefore?string
Only posts created before this ISO time
scheduledAfter?string
Only posts scheduled after this ISO time
scheduledBefore?string
Only posts scheduled before this ISO time
limit?number
Page size
offset?number
Pagination offset
sort?"asc" | "desc"
Sort order by creation time
Response
200
total *number
Total matched posts across all pages
posts *object[]
Show item properties
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
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