curl "https://api.nedzo.ai/v1/phone-numbers?limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"items": [
{
"id": "4d1f6b52-8c0e-4a51-9b7d-2f3c4e5a6b7c",
"workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
"number": "+14155551234",
"status": "active",
"type": "inbound_outbound",
"friendlyName": "Main line",
"inboundAgentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"chatAgentId": null,
"fallbackEnabled": false,
"fallbackNumber": null,
"fallbackRingDuration": 20,
"activeHours": null,
"monthlyPriceCents": 99,
"purchasedAt": "2026-10-11T12:00:00Z",
"createdAt": "2026-10-11T12:00:00Z",
"updatedAt": "2026-10-11T12:00:00Z"
}
],
"total": 1,
"limit": 50,
"offset": 0,
"hasMore": false
}
Phone Numbers
List phone numbers
List the phone numbers a workspace owns, newest first.
GET
/
phone-numbers
curl "https://api.nedzo.ai/v1/phone-numbers?limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"items": [
{
"id": "4d1f6b52-8c0e-4a51-9b7d-2f3c4e5a6b7c",
"workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
"number": "+14155551234",
"status": "active",
"type": "inbound_outbound",
"friendlyName": "Main line",
"inboundAgentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"chatAgentId": null,
"fallbackEnabled": false,
"fallbackNumber": null,
"fallbackRingDuration": 20,
"activeHours": null,
"monthlyPriceCents": 99,
"purchasedAt": "2026-10-11T12:00:00Z",
"createdAt": "2026-10-11T12:00:00Z",
"updatedAt": "2026-10-11T12:00:00Z"
}
],
"total": 1,
"limit": 50,
"offset": 0,
"hasMore": false
}
This endpoint is for the VIP plan only. Other plans get a
403. See Plan access.string
Workspace UUID. Required for an account API key. A workspace API key uses its own workspace.
integer
default:"100"
Numbers per page, 1 to 1,000.
integer
default:"0"
How many numbers to skip, up to 100,000.
curl "https://api.nedzo.ai/v1/phone-numbers?limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"items": [
{
"id": "4d1f6b52-8c0e-4a51-9b7d-2f3c4e5a6b7c",
"workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
"number": "+14155551234",
"status": "active",
"type": "inbound_outbound",
"friendlyName": "Main line",
"inboundAgentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"chatAgentId": null,
"fallbackEnabled": false,
"fallbackNumber": null,
"fallbackRingDuration": 20,
"activeHours": null,
"monthlyPriceCents": 99,
"purchasedAt": "2026-10-11T12:00:00Z",
"createdAt": "2026-10-11T12:00:00Z",
"updatedAt": "2026-10-11T12:00:00Z"
}
],
"total": 1,
"limit": 50,
"offset": 0,
"hasMore": false
}
Fields
| Field | Meaning |
|---|---|
status | pending, active, payment_failed or activation_failed |
type | inbound_outbound or outbound_only |
inboundAgentId | The voice agent that answers and calls from this number |
chatAgentId | The chat agent that answers texts on this number |
fallbackEnabled | Ring a person first, then the agent |
fallbackNumber | The person to ring first |
fallbackRingDuration | Seconds to ring the person before the agent answers |
activeHours | When to ring the person first. null uses the workspace office hours |
monthlyPriceCents | What the number costs each month, in cents |
Was this page helpful?