---
title: List Reload Schedules
description: "Lists Warehouse Native experiments, gates or holdouts that have a scheduled reload hour, one entityType per request, sorted by id . Each item shows its sched…"
product: general
lang: en
token_estimate: 2302
---
# List Reload Schedules

## List Reload Schedules

**GET** `/console/v1/reload_schedules`

Full URL: `https://statsigapi.net/console/v1/reload_schedules`

> For AI agents: a documentation index is available at [/llms.txt](/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

List Reload Schedules

Lists Warehouse Native experiments, gates or holdouts that have a scheduled reload hour, one `entityType` per request, sorted by `id`. Each item shows its schedule and whether the scheduler selects it.

`eligible` is `true` when the scheduler's rules select the entity. It doesn't guarantee a reload runs. The scheduler can still skip an eligible entity at run time, and `skipReasons` doesn't report these skips: a scheduled reload already ran that UTC day, scheduled reloads are paused for the project, a gate rule is at 0% or 100%, or a gate rule is inside its real-time auto-reload window.

To change many schedules, collect every `id` first, then send the `PATCH` requests. Changing schedules while you page can skip rows, because each change moves entities in or out of the filtered list.

List requests don't count toward the Console API write limit. Each `PATCH` does: by default, 1,800 writes per 15 minutes and 30 writes per 10 seconds per project, shared by every key and every Console API write.

## Authorizations

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| STATSIG-API-KEY | string | Yes | — | apiKey (header) |

## Query parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| limit (query) | integer | No | 10 | Results per page Constraints: string, number |
| page (query) | integer | No | 1 | Page number Constraints: string, number |
| entityType (query) | string | Yes | experiment | Type of entity to list. Each request lists one type. Allowed values: experiment, gate, holdout |
| eligible (query) | string | No | — | When `true`, returns only entities the scheduler selects (`eligible: true`). When omitted or `false`, returns every entity with a scheduled reload hour. Allowed values: true, false |
| hour (query) | integer | No | 0 | Returns only entities scheduled at this UTC hour, from 0 to 23. |

## Response (application/json)

**200** — List reload schedules response

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| message | string | Yes | — | A simple string explaining the result of the operation. |
| data | object[] | Yes | — | — |
| data.entityType | string | Yes | — | Type of the entity, matching the `entityType` you requested. Allowed values: experiment, gate, holdout |
| data.id | string | Yes | — | ID to use with `/console/v1/experiments/{id}`, `/console/v1/gates/{id}` or `/console/v1/holdouts/{id}`. |
| data.name | string | Yes | — | Display name. |
| data.scheduledReloadHour | integer | Yes | — | UTC hour, from 0 to 23, at which scheduled reloads start. Constraints: format: int64 |
| data.scheduledReloadDays | integer[] | Yes | — | Days of the week with scheduled reloads, from 0 to 6, where 0 is Sunday. `null` means every day. An empty list means no day, so the entity never reloads (`no_days`). Constraints: nullable |
| data.scheduledReloadType | string | Yes | — | Reload type for scheduled reloads. An unset type reads as `incremental`. Allowed values: full, incremental |
| data.turboMode | boolean | Yes | — | Whether scheduled reloads use Turbo mode. `null` means unset, so scheduled reloads keep the latest reload's setting. For experiments, an organization that enforces Turbo mode overrides this value. Constraints: nullable |
| data.eligible | boolean | Yes | — | `true` when the scheduler's rules select this entity, so `skipReasons` is empty. The scheduler can still skip it at run time. |
| data.skipReasons | string[] | Yes | — | Each scheduler rule this entity fails. Every type: `no_days` (`scheduledReloadDays` is an empty list). Gates and holdouts: `disabled`, `archived`, `no_partial_rollout` (no rule passes between 0% and 100%). Experiments: `not_started`, `launched`, `analysis_ended` (the analysis end time has passed), `cloud_results` (Statsig Cloud computes this experiment's results), `incremental_with_secondary_id` (incremental reloads don't support a secondary ID type; send `scheduledReloadType: "full"`). |
| pagination | object | Yes | — | Pagination metadata for checking if there is next page for example. |
| pagination.itemsPerPage | number | Yes | — | Constraints: format: double |
| pagination.pageNumber | number | Yes | — | Constraints: format: double |
| pagination.nextPage | string | Yes | — | Constraints: nullable |
| pagination.previousPage | string | Yes | — | Constraints: nullable |
| pagination.totalItems | number | No | — | Constraints: format: double |
| pagination.all | string | No | — | — |

```json
{
  "message": "Reload schedules listed successfully.",
  "data": [
    {
      "entityType": "gate",
      "id": "checkout_flow",
      "name": "Checkout flow",
      "scheduledReloadHour": 0,
      "scheduledReloadDays": [
        1,
        2,
        3,
        4,
        5
      ],
      "scheduledReloadType": "incremental",
      "turboMode": false,
      "eligible": true,
      "skipReasons": []
    },
    {
      "entityType": "gate",
      "id": "old_banner",
      "name": "Old banner",
      "scheduledReloadHour": 0,
      "scheduledReloadDays": null,
      "scheduledReloadType": "full",
      "turboMode": null,
      "eligible": false,
      "skipReasons": [
        "archived",
        "no_partial_rollout"
      ]
    }
  ],
  "pagination": {
    "itemsPerPage": 100,
    "pageNumber": 1,
    "nextPage": null,
    "previousPage": null,
    "totalItems": 2
  }
}
```

**400** — Invalid query parameters, or the project doesn't use Warehouse Native

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| status | integer | Yes | — | Allowed values: 400 |
| message | string | Yes | — | — |

```json
{
  "status": 400,
  "message": "Reload schedules are only available in Warehouse Native projects. This project doesn't use Warehouse Native, so it has no scheduled reloads."
}
```

**401** — This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| status | integer | Yes | — | Allowed values: 401 |
| message | string | Yes | — | — |

```json
{
  "status": 401,
  "message": "This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx"
}
```

## Code samples

### cURL

```bash
curl -X GET "https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0" \
  -H "Content-Type: application/json" \
  -H "STATSIG-API-KEY: YOUR_API_KEY"
```

### Python

```python
import requests

response = requests.get(
    "https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0",
    headers={
        "Content-Type": "application/json",
        "STATSIG-API-KEY": "YOUR_API_KEY"
    }
)
data = response.json()
```

### JavaScript

```javascript
const response = await fetch("https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "STATSIG-API-KEY": "YOUR_API_KEY"
  }
});
const data = await response.json();
```

### PHP

```php
<?php
$ch = curl_init("https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "STATSIG-API-KEY: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
```

### Go

```go
package main

import (
  "bytes"
  "net/http"
)

func main() {
req, _ := http.NewRequest("GET", "https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0", nil)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("STATSIG-API-KEY", "YOUR_API_KEY")
  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()
}
```

### Java

```java
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0"))
      .method("GET", HttpRequest.BodyPublishers.noBody())
.header("Content-Type", "application/json")
      .header("STATSIG-API-KEY", "YOUR_API_KEY")
      .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
```

### Ruby

```ruby
require "net/http"
require "json"

uri = URI("https://statsigapi.net/console/v1/reload_schedules?limit=10&page=1&entityType=experiment&hour=0")
request = Net::HTTP::Get.new(uri)
request["Content-Type"] = "application/json"
request["STATSIG-API-KEY"] = "YOUR_API_KEY"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end
```

