GET/v1/flowsflows:read

List flows

Run a request

GET/v1/flows

Base URL

Query

limit

cursor

updated_since

status

Resolved URL

GEThttps://coldos.justgotwyrd.com/api/v1/flows

Paste an API key in the bar at the top of the page to enable Execute.

Parameters

Query parameters

limitintegeroptionaldefault 50
Max items to return. 1-200.
cursorstringoptional
Opaque pagination cursor returned in the previous page's `next_cursor`.
updated_sinceiso8601optional
Only return rows whose `updated_at` is greater than the supplied timestamp.
statusstringoptional
Filter by status.
draftactivepausedarchived

Responses

400Invalid request — see `error.message`.
401Missing or invalid API key.
403Authenticated, but the key lacks the required scope.
404The referenced resource does not exist or is not visible to your key.
429Rate limit exceeded — see `Retry-After`.
500Unexpected server error. Safe to retry with idempotency-key.

Code samples

curl -X GET "https://coldos.justgotwyrd.com/api/v1/flows" \
  -H "Authorization: Bearer $COLD_OS_API_KEY"

Response · 200

{
  "data": [
    {
      "id": "01HZS1Q4XK9R2YQX9F7F1ZQE3T",
      "name": "APAC mid-market — 5-touch",
      "status": "active",
      "enrolled_count": 312,
      "active_count": 247,
      "send_window_start": "09:00",
      "send_window_end": "18:00",
      "send_days_of_week": [
        1,
        2,
        3,
        4,
        5
      ],
      "timezone": "Asia/Kolkata",
      "notify_on_advance": false,
      "created_at": "2026-04-30T12:00:00.000+05:30"
    },
    {
      "id": "01HZS1Q4XK9R2YQX9F7F1ZQE3T",
      "name": "APAC mid-market — 5-touch",
      "status": "active",
      "enrolled_count": 312,
      "active_count": 247,
      "send_window_start": "09:00",
      "send_window_end": "18:00",
      "send_days_of_week": [
        1,
        2,
        3,
        4,
        5
      ],
      "timezone": "Asia/Kolkata",
      "notify_on_advance": false,
      "created_at": "2026-04-30T12:00:00.000+05:30"
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjoiYzJhOGE5M2EifQ==",
  "has_more": true
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.