Skip to main content
GET
/
crons
List crons
curl --request GET \
  --url https://api.example.com/crons
{
  "Authorization": "<string>",
  "id": "<string>",
  "user_id": "<string>",
  "name": {},
  "cron": "<string>",
  "url": "<string>",
  "method": "<string>",
  "headers": {},
  "body": {},
  "paused": true,
  "next_run_at": "<string>",
  "last_run_at": {},
  "created_at": "<string>"
}

​
Request

No request body or query parameters required.

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer your_api_key_here

​
Response

Returns an array of cron objects.
​
id
string
Unique identifier (UUID).
​
user_id
string
ID of the user who owns this cron.
​
name
string | null
Display name.
​
cron
string
Cron expression defining the schedule.
​
url
string
Webhook URL.
​
method
string
HTTP method: GET, POST, or DELETE.
​
headers
object
Custom HTTP headers.
​
body
object
JSON body payload.
​
paused
boolean
Whether the cron is paused.
​
next_run_at
string
ISO 8601 timestamp of the next scheduled run.
​
last_run_at
string | null
ISO 8601 timestamp of the last execution.
​
created_at
string
ISO 8601 timestamp.
curl https://app.cronapi.dev/api/v1/crons \
  -H "Authorization: Bearer your_api_key_here"
200
[
  {
    "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"
  }
]