/api/v1/postsGETLists posts in your workspace with filtering and pagination.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Query Parameters
status?"DRAFT" | "SCHEDULED" | "POSTED" | "ERROR" | "DELETED" | "PROCESSING" | "REVIEW" | "RETRYING"
Filter posts by status
platforms?string
Comma-separated platform names to filter by
q?string
Search in post titles and content
postDateFrom?string
Only posts scheduled after this ISO time
postDateTo?string
Only posts scheduled before this ISO time
limit?number
Page size
offset?number
Pagination offset
Response
200
items *object[]
Show item properties
id *string
Post ID
title?string
referenceKey?string | null
postDate?string | null
postedDate?string | null
status?"DRAFT" | "SCHEDULED" | "POSTED" | "ERROR" | "DELETED" | "PROCESSING" | "REVIEW" | "RETRYING"
data?object
error?string | null
Top-level failure details
errors?object | null
Per-platform failure details
externalData?object | null
retryCount?number
createdAt?string | null
updatedAt?string | null
total *number
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
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details