> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/post-scheduler — List Post Schedulers

> Returns a paginated list of post schedulers for your team. Each scheduler posts content to one or more Facebook groups on a schedule.

Retrieve all post schedulers for a team. Each scheduler automates posting content to Facebook group URLs on either an interval or fixed schedule.

## Query parameters

<ParamField query="team_id" type="integer" required>
  The ID of the team whose schedulers you want to list.
</ParamField>

<ParamField query="page" type="integer">
  Page number for pagination. Defaults to the first page if omitted.
</ParamField>

<ParamField query="per_page" type="integer">
  Number of schedulers to return per page.
</ParamField>

## Example request

```bash theme={null}
curl -X GET "https://reachowl.com/api/v1/post-scheduler?team_id=1&page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Example response

```json theme={null}
{
  "data": [
    {
      "id": 42,
      "name": "Morning Promos",
      "executor_id": 7,
      "team_id": 1,
      "group_urls": [
        "https://www.facebook.com/groups/group1",
        "https://www.facebook.com/groups/group2"
      ],
      "schedule_type": "interval",
      "interval": 120,
      "status": 1
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 20,
    "total": 55
  }
}
```

<ResponseField name="data" type="array">
  List of post scheduler objects.
</ResponseField>

<ResponseField name="meta" type="object">
  Pagination metadata including `current_page`, `last_page`, `per_page`, and `total`.
</ResponseField>