# List boosts — CacheBoost API

> Retrieve all boost campaigns for the authenticated user.

Source: https://www.cache-boost.com/support/api-reference/boosts/list.md
Language: en

---



Returns all boosts belonging to the authenticated user.

**`GET /v1/boosts`** — Scope: `boosts:read`

## Example request

```bash
curl https://api.cache-boost.com/v1/boosts \
  -H "Authorization: Bearer cb_live_YOUR_KEY"
```

## Response

`200 OK` — array of boost objects.

```json
[
  {
    "id": 15,
    "site_id": 42,
    "name": "Daily warm",
    "status": "pending",
    "source_type": "sitemap",
    "region": ["fr"],
    "schedule": "0 1 * * *",
    "next_run_at": "2025-01-16T01:00:00Z",
    "created_at": "2025-01-10T09:00:00Z"
  }
]
```

### Boost status values

| Value | Description |
|-------|-------------|
| `pending` | Waiting to be scheduled or triggered |
| `running` | A run is currently in progress |
| `paused` | Boost is paused (manually or due to high error rate) |
| `done` | Last run completed successfully |
| `failed` | Last run failed |

## Errors

| Code | Description |
|------|-------------|
| `401` | Missing or invalid API key |
| `403` | Insufficient scope |



---

**CacheBoost** — Automatic cache warming for faster websites.

- Website: https://www.cache-boost.com
- Full content (all pages): https://www.cache-boost.com/llms-full.txt
- LLM index: https://www.cache-boost.com/llms.txt
- Documentation: https://www.cache-boost.com/support/getting-started/introduction
- Start free: https://www.cache-boost.com/try