> 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/run-a-schedule-now.md).

# Run a Schedule Now

Start one run of a saved schedule straight away.

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

Starts one run of a saved schedule now, in the background, and answers as soon as it has started. `next_run` then moves on as if the schedule had run on its date. Works on a paused schedule too; it stays paused.

{% hint style="info" %}
**Billed like a job search:** 0.1 credit per new job saved, plus the people and emails found at their normal rates when the schedule has `find_contact` on. `credits_estimated` is the most the jobs part can cost. The balance is checked first; if it is too low the call returns `400` and nothing runs.
{% endhint %}

## Headers

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

## Body

| Name          | Type    | Description                                                                |
| ------------- | ------- | -------------------------------------------------------------------------- |
| `api_key`     | string  | **Required.** Your API key.                                                |
| `schedule_id` | integer | **Required.** From [List Schedules](/search/job-search/list-schedules.md). |

## Response

| Field               | Description                                            |
| ------------------- | ------------------------------------------------------ |
| `data.run_started`  | `true` when the run started.                           |
| `data.next_run`     | The schedule's new next date.                          |
| `credits_estimated` | The most the jobs part can cost (`0.1 x max_results`). |
| `credits_used`      | `0`: the run is billed as it happens.                  |

## Example

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

```json
{
  "api_key": "your_api_key",
  "schedule_id": 62
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "credits_used": 0.0,
  "credits_remaining": 6012.5,
  "credits_estimated": 1.0,
  "message": "The run has started.",
  "data": {
    "schedule_id": 62,
    "list_name": "Roofing Estimator Jobs TX",
    "run_started": true,
    "next_run": "2026-10-05"
  }
}
```

{% endtab %}
{% endtabs %}

Check the result a few minutes later with [Schedule Run History](/search/job-search/schedule-run-history.md).