> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/search/job-search/list-schedules.md).

# List Schedules

Every saved job search schedule on the account.

<mark style="color:green;">`POST`</mark> `/jobs_schedules`

Returns every saved job search schedule: its search settings, its timing, whether it is paused, and when it last ran and runs next. These are the same schedules as the **Schedules** tab on the Job Search page, so a schedule made in either place shows in both.

{% hint style="info" %}
**Free.** `credits_used` is always `0`.
{% endhint %}

## Headers

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

## Body

| Name      | Type   | Description                 |
| --------- | ------ | --------------------------- |
| `api_key` | string | **Required.** Your API key. |

## Response

`data.schedules` is a list. Each schedule has:

| Field                                                                                                                                               | Description                                                            |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `schedule_id`                                                                                                                                       | The schedule's id. Use it with the other schedule endpoints.           |
| `list_name`                                                                                                                                         | The list every run saves into.                                         |
| `is_active`                                                                                                                                         | `false` when the schedule is paused.                                   |
| `schedule_type`                                                                                                                                     | `daily`, `weekly` or `every_x_days`.                                   |
| `run_every_x_days`                                                                                                                                  | With `every_x_days`.                                                   |
| `schedule_days`                                                                                                                                     | With `weekly`, e.g. `["Monday"]`.                                      |
| `last_run`, `next_run`                                                                                                                              | Dates (`YYYY-MM-DD`).                                                  |
| `keywords`, `job_location`, `time_posted`, `job_types`, `experience_levels`, `salary_min`, `max_results`, `unique_jobs`, `exclude_staffing_company` | The job search settings.                                               |
| `find_contact`, `titles`, `company_size`, `contact_location`, `max_contacts`, `find_job_posters`                                                    | The people search that runs after the jobs, when `find_contact` is on. |

`total` is the number of schedules.

## Example

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "credits_used": 0.0,
  "credits_remaining": 6014.5,
  "total": 1,
  "data": {
    "schedules": [
      {
        "schedule_id": 50,
        "list_name": "Python Developer Jobs",
        "is_active": true,
        "schedule_type": "every_x_days",
        "run_every_x_days": 7,
        "schedule_days": [],
        "last_run": "2026-09-24",
        "next_run": "2026-10-01",
        "keywords": "\"Python Developer\"",
        "job_location": "United States",
        "time_posted": "Any Time",
        "job_types": [],
        "experience_levels": [],
        "salary_min": "Any",
        "max_results": 100,
        "unique_jobs": true,
        "exclude_staffing_company": false,
        "find_contact": true,
        "titles": ["CEO"],
        "company_size": ["11-50", "51-200"],
        "contact_location": ["united states"],
        "max_contacts": 10,
        "find_job_posters": false
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}