API reference

GET /v1/ivr-flows/:id · Get an IVR flow

Business accounts only. Read-only: flows are built and edited in the dashboard. Mainly for looking up a flow's id, which is what override_ivr_flow takes. Any member of the business can read them. An account that isn't in a business gets a 403 with code: "not_a_business".

Request

text
GET https://api.spoofey.com/v1/ivr-flows/:id
Path param Notes
id A flow id from GET /v1/ivr-flows.

Example

bash
curl https://api.spoofey.com/v1/ivr-flows/9e2f1a3b-... \
  -H "Authorization: Bearer sk_live_..."

Response

One flow, same shape as in the list:

json
{
  "id": "9e2f1a3b-...",
  "name": "Verification code",
  "kind": "outbound",
  "status": "published",
  "version": 3,
  "numbers": ["12025559999"],
  "created_at": 1789700000000,
  "updated_at": 1789800000000
}

404 if it isn't one of your business's flows.

Errors

Errors come back as {"error":{"message":"...","code":"..."}}. See API errors and rate limits for every status code and the rate limit.

Was this helpful?Your answer helps us improve this page.
Still stuck?Ask Spoofey AI about your exact case, or a person on our team will reply by email.
Last modified on September 25, 2026 · 1 min read
Edit