> ## Documentation Index
> Fetch the complete documentation index at: https://developers.supapost.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List Scheduled Posts

> List all scheduled posts for the authenticated team

Returns scheduled posts sorted by scheduled time (ascending). Includes related project and social account data.

## Authentication

<ParamField header="Authorization" type="string">
  Bearer token. `Bearer <supabase-jwt>`.
</ParamField>

## Query Parameters

<ParamField query="from" type="string">
  ISO 8601 datetime. Only return posts scheduled at or after this time.
</ParamField>

<ParamField query="to" type="string">
  ISO 8601 datetime. Only return posts scheduled at or before this time.
</ParamField>

<ParamField query="status" type="string">
  Filter by status, e.g. `"scheduled"`, `"published"`, `"failed"`.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "post-uuid",
      "team_id": "team-uuid",
      "project_id": "proj-uuid",
      "social_account_id": "acct-uuid",
      "platform": "tiktok",
      "scheduled_at": "2026-04-10T14:00:00Z",
      "title": "Morning Routine Tips",
      "image_urls": ["https://cdn.supapost.so/assets/team/slide1.jpg"],
      "status": "scheduled",
      "project": {
        "id": "proj-uuid",
        "name": "Morning Routine Carousel",
        "thumbnail_url": "https://cdn.supapost.so/assets/team/thumb.jpg"
      },
      "account": {
        "id": "acct-uuid",
        "platform": "tiktok",
        "platform_username": "myaccount",
        "display_name": "My Account",
        "avatar_url": "https://example.com/avatar.jpg"
      }
    }
  ]
  ```
</ResponseExample>