> ## Documentation Index
> Fetch the complete documentation index at: https://connect.trypost.it/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List posts

> List posts for the current account, newest schedule first. Paginated.

REST has **no** `status` or `search` query. Those filters exist only on MCP `list-posts-tool`.

## Request

<ParamField query="page" type="integer">
  Page number. Defaults to `1`.
</ParamField>

## Response

Laravel pagination envelope. Ordered by `scheduled_at` descending. Page size is `meta.per_page` (default 25).

Each item matches [`GET /posts/{id}`](/docs/api-reference/posts/get). Nested `social_account` uses the [social account](/docs/api-reference/social-accounts/list) shape (`id`, `set_id`, `platform`, `display_name`, `username`, `avatar_url`, `status`).

<RequestExample>
  ```bash theme={null}
  curl https://connect.trypost.it/api/posts \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
        "content": "Excited to announce our new feature!",
        "media": [],
        "status": "scheduled",
        "scheduled_at": "2026-01-15 10:00:00",
        "published_at": null,
        "platforms": [
          {
            "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
            "platform": "linkedin",
            "content_type": "linkedin_post",
            "custom_content": null,
            "custom_media": null,
            "meta": {},
            "status": "pending",
            "enabled": true,
            "platform_url": null,
            "published_at": null,
            "error_message": null,
            "display_name": "Jane Doe",
            "display_username": "janedoe",
            "display_avatar": "https://media.licdn.com/…/avatar.jpg",
            "social_account": {
              "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
              "set_id": null,
              "platform": "linkedin",
              "display_name": "Jane Doe",
              "username": "janedoe",
              "avatar_url": "https://media.licdn.com/…/avatar.jpg",
              "status": "connected"
            }
          }
        ],
        "created_at": "2026-01-14 09:00:00",
        "updated_at": "2026-01-14 09:00:00"
      }
    ],
    "links": {
      "first": "https://connect.trypost.it/api/posts?page=1",
      "last": "https://connect.trypost.it/api/posts?page=1",
      "prev": null,
      "next": null
    },
    "meta": {
      "current_page": 1,
      "from": 1,
      "to": 1,
      "last_page": 1,
      "per_page": 25,
      "total": 1,
      "path": "https://connect.trypost.it/api/posts"
    }
  }
  ```
</ResponseExample>