> 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/funding-rounds/list-schedules.md).

# List Schedules

Every Funding Rounds list set to repeat.

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

Returns every list set to repeat with [List Lookup](https://developer.parvenu.io/search/funding-rounds/list-lookup.md) (`repeat` set to `daily` or `weekly`): its filters, when it runs next, and how its last run went.

{% 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` is a list. Each entry has:

| Field         | Description                                                                                                                          |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `list_name`   | The list every run saves into. Use it with [Stop a Schedule](https://developer.parvenu.io/search/funding-rounds/stop-a-schedule.md). |
| `repeat`      | `daily` or `weekly`.                                                                                                                 |
| `filters`     | The search filters the list runs with.                                                                                               |
| `max_results` | Most rounds per run.                                                                                                                 |
| `next_run_at` | When it runs next.                                                                                                                   |
| `last_run_at` | When it last ran, or `null`.                                                                                                         |
| `last_status` | How the last run went, or `null`.                                                                                                    |

`total` is the number of repeating lists.

## Example

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

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

{% endtab %}

{% tab title="Output" %}
An example of the response shape.

```json
{
  "status": "success",
  "data": [
    {
      "list_name": "Series A in Georgia",
      "repeat": "weekly",
      "filters": {
        "stages": ["seed", "series_a"],
        "include_other_rounds": true,
        "state": "GA"
      },
      "max_results": 25,
      "next_run_at": "2026-10-30T19:00:00Z",
      "last_run_at": "2026-10-23T19:00:00Z",
      "last_status": "done"
    }
  ],
  "credits_used": 0,
  "total": 1,
  "success": true
}
```

{% endtab %}
{% endtabs %}
