# List Schedules Returns a paginated list of all recurring document schedules for the account. Endpoint: GET /api/v3/schedules Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" - `page` (integer) Page number. - `per_page` (integer) Schedules per page. items_per_page and page_items are accepted as aliases. - `sort` (string) Sort field. Any other value falls back to client_name. Enum: "client_name", "next_date", "end_date" - `sort_order` (string) Sort direction (case-insensitive). Any other value falls back to ASC. Enum: "ASC", "DESC" - `term` (string) Free-text filter matched (LIKE) against the schedule description, the client's name, code, email, fiscal_id, address, country, phone, fax and postal code, and the template's item names and descriptions. ## Response 200 fields (application/json): - `schedules` (array) - `schedules.id` (integer) Example: 1 - `schedules.client_name` (string) Example: "John Doe" - `schedules.interval` (integer) Example: 1 - `schedules.type` (string) Enum: "Daily", "Monthly", "Yearly" - `schedules.description` (string) Example: "Monthly invoice" - `schedules.active` (boolean) Example: true - `schedules.document_type` (string) Enum: "invoice", "invoice_receipt", "simplified_invoice" - `schedules.to_send` (boolean) - `schedules.email_cc` (string,null) - `schedules.email_bcc` (string,null) - `schedules.start_date` (string) Example: "2026-08-01" - `schedules.next_date` (string) Example: "2020-01-01" - `schedules.end_date` (string) Example: "2030-01-01" - `schedules.total` (integer) Occurrences the schedule is planned to produce over its whole date range (a forecast, not a document count) Example: 2 - `schedules.total_remain` (integer) Occurrences still to come between now and end_date Example: 2 - `pagination` (object) - `pagination.total_entries` (integer) Example: 1 - `pagination.current_page` (integer) Example: 1 - `pagination.total_pages` (integer) Example: 1 - `pagination.per_page` (integer) Example: 10 ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string)