---
title: "Get WhatsApp Business Account Schedules"
method: GET
path: "/{Version}/{WABA-ID}/schedules"
tags: ["Schedule Management"]
---

# Get WhatsApp Business Account Schedules

`GET /{Version}/{WABA-ID}/schedules`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{WABA-ID}/schedules`
- Auth: HTTP bearer

Retrieve all schedules associated with a WhatsApp Business Account, including their
configuration, status, and execution details.

**Use Cases:**
- List all schedules in a WhatsApp Business Account
- Monitor schedule status and performance
- Check schedule configuration and timing details
- Retrieve schedule execution history and metrics

**Filtering:**
You can filter results using the `filtering` parameter with JSON-encoded filter conditions.
Supported filters include status, schedule_type, and is_active.

**Sorting:**
Results can be sorted by created_time or updated_time in ascending or descending order.

**Rate Limiting:**
Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

**Caching:**
Schedule data can be cached for short periods, but status information may change
frequently. Implement appropriate cache invalidation strategies.

## Path parameters

- `Version` string, required
- `WABA-ID` string, required

## Query parameters

- `fields` string
- `filtering` string
- `sort` 'created_time.asc' | 'created_time.desc' | 'updated_time.asc' | 'updated_time.desc'
- `limit` integer
- `after` string
- `before` string

## Headers

- `User-Agent` string
- `Authorization` string, required

## Response `200`

Successfully retrieved WhatsApp Business Account schedules

- WhatsAppBusinessAccountSchedulesConnection: Paginated collection of WhatsApp Business Account schedules
  - `data` WhatsAppBusinessAccountSchedule[], required: Array of schedule records
    - `id` string, required: Unique identifier for the schedule
    - `name` string, required: Human-readable name for the schedule
    - `status` 'ACTIVE' | 'INACTIVE' | 'PAUSED' | 'EXPIRED' | 'DRAFT', required: Current status of the schedule
    - `schedule_type` 'BUSINESS_HOURS' | 'AUTOMATED_RESPONSE' | 'MESSAGE_CAMPAIGN' | 'MAINTENANCE_WINDOW' | 'CUSTOM', required: Type of schedule configuration
    - `description` string: Optional description of the schedule purpose
    - `start_time` string, time: Schedule start time in HH:MM format
    - `end_time` string, time: Schedule end time in HH:MM format
    - `timezone` string: Timezone identifier for the schedule
    - `days_of_week` DayOfWeek[]: Days of the week when the schedule is active
    - `created_time` string, date-time: ISO 8601 timestamp when the schedule was created
    - `updated_time` string, date-time: ISO 8601 timestamp when the schedule was last updated
    - `is_active` boolean: Whether the schedule is currently active
    - `recurrence_pattern` RecurrencePattern: Pattern for recurring schedules
      - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY'
      - `interval` integer: Interval between recurrences
      - `end_date` string, date: End date for the recurrence pattern
  - `paging` CursorPaging: Cursor-based pagination information
    - `cursors` object
      - `before` string: Cursor pointing to the start of the page of data
      - `after` string: Cursor pointing to the end of the page of data
    - `previous` string: URL for the previous page of results
    - `next` string: URL for the next page of results

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - WhatsApp Business Account ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)