List posts

GET 
/posts

Returns scheduled, published, or draft posts. Supports filtering by status and platform, with pagination.

Query Parameters

Parameter	Type	Required	Description
status	string	No	Filter by post status: scheduled, published, or draft
platform	string	No	Filter by destination platform (e.g. instagram, linkedin, x)
limit	integer	No	Number of posts to return. Min 1, max 100, default 20.
offset	integer	No	Number of posts to skip. Default 0.

Request Example

GET /posts?status=scheduled&platform=instagram&limit=10&offset=0

Response Example

200 — List of posts

{
  "data": {
    "posts": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "content": "Excited to share our latest update!",
        "media": [
          {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "type": "image",
            "url": "https://imagedelivery.net/abc123/public"
          }
        ],
        "scheduled_for": "2026-04-15T14:30:00.000Z",
        "timezone": "America/New_York",
        "status": "scheduled",
        "destinations": [
          {
            "id": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
            "platform": "instagram",
            "status": "queued",
            "account_name": "@mybrand",
            "account_id": 2280,
            "published_at": null,
            "platform_post_id": null,
            "error": null,
            "attempts": 0
          }
        ],
        "created_at": "2026-04-10T12:00:00.000Z",
        "updated_at": "2026-04-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "limit": 10,
      "offset": 0
    }
  },
  "error": null,
  "meta": {
    "request_id": "a1b2c3d4",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Post object fields

Field	Type	Description
id	string (UUID)	Post unique identifier
content	string	Text content of the post
media	array or null	Attached media items
scheduled_for	string (ISO 8601) or null	Scheduled publish time
timezone	string	IANA timezone (e.g. UTC)
status	string	draft, scheduled, or published
destinations	array	Per-platform destination statuses
created_at	string (ISO 8601)	When the post was created
updated_at	string (ISO 8601)	When the post was last updated

Destination object fields

Field	Type	Description
id	string (UUID)	Destination unique identifier
platform	string	Platform name (e.g. instagram, x)
status	string	queued, published, failed
account_name	string or null	Account username
account_id	integer or null	Account ID
published_at	string (ISO 8601) or null	When it was published
platform_post_id	string or null	Platform's native post ID
error	string or null	Error message if failed
attempts	integer	Number of publish attempts

---

Request

Responses

200

List of posts

401

Missing or invalid API key

429

Rate limit exceeded

Response Headers

X-RateLimit-Limit

Request limit per window

X-RateLimit-Remaining

Remaining requests in current window

X-RateLimit-Reset

Unix timestamp when the window resets

Retry-After

Seconds to wait before retrying