> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cronapi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List crons

> Retrieve all crons for the authenticated user

## Request

No request body or query parameters required.

### Headers

<ResponseField name="Authorization" type="string" required>
  Bearer token. Example: `Bearer your_api_key_here`
</ResponseField>

## Response

Returns an array of cron objects.

<ResponseField name="id" type="string">
  Unique identifier (UUID).
</ResponseField>

<ResponseField name="user_id" type="string">
  ID of the user who owns this cron.
</ResponseField>

<ResponseField name="name" type="string | null">
  Display name.
</ResponseField>

<ResponseField name="cron" type="string">
  Cron expression defining the schedule.
</ResponseField>

<ResponseField name="url" type="string">
  Webhook URL.
</ResponseField>

<ResponseField name="method" type="string">
  HTTP method: `GET`, `POST`, or `DELETE`.
</ResponseField>

<ResponseField name="headers" type="object">
  Custom HTTP headers.
</ResponseField>

<ResponseField name="body" type="object">
  JSON body payload.
</ResponseField>

<ResponseField name="paused" type="boolean">
  Whether the cron is paused.
</ResponseField>

<ResponseField name="next_run_at" type="string">
  ISO 8601 timestamp of the next scheduled run.
</ResponseField>

<ResponseField name="last_run_at" type="string | null">
  ISO 8601 timestamp of the last execution.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<CodeGroup>
  ```bash cURL theme={null}
  curl https://app.cronapi.dev/api/v1/crons \
    -H "Authorization: Bearer your_api_key_here"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://app.cronapi.dev/api/v1/crons", {
    headers: { "Authorization": `Bearer your_api_key_here` },
  });
  const crons = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://app.cronapi.dev/api/v1/crons",
      headers={"Authorization": "Bearer your_api_key_here"},
  )
  crons = response.json()
  ```
</CodeGroup>

```json 200 theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "user_id": "d4e5f6a7-b890-1234-cdef-567890abcdef",
    "name": "Health check",
    "cron": "*/5 * * * *",
    "url": "https://example.com/health",
    "method": "GET",
    "headers": {},
    "body": {},
    "paused": false,
    "next_run_at": "2026-04-15T14:35:00.000Z",
    "last_run_at": "2026-04-15T14:30:00.000Z",
    "created_at": "2026-04-12T10:30:00.000Z"
  }
]
```