List Phone Numbers - Agntix

Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.

Use this endpoint to discover the phone_number_id you need when triggering an outbound call. The returned id values are stable — cache them on your side.

Query parameters

integer

default:"50"

Maximum number of items to return.

Code examples

curl "https://api.agntix.ai/api/v1/phone-numbers?size=50" \
  -H "x-api-key: $AGNTIX_API_KEY" \
  -H "Accept: application/json"

const { items } = await fetch(
  "https://api.agntix.ai/api/v1/phone-numbers?size=50",
  { headers: { "x-api-key": process.env.AGNTIX_API_KEY } },
).then((r) => r.json());

for (const n of items) {
  console.log(`${n.phone_number} — ${n.label ?? "(no label)"}`);
}

import os, requests

result = requests.get(
    "https://api.agntix.ai/api/v1/phone-numbers",
    headers={"x-api-key": os.environ["AGNTIX_API_KEY"]},
    params={"size": 50},
).json()

for n in result["items"]:
    print(f"{n['phone_number']} — {n.get('label', '(no label)')}")

Sample response

{
  "items": [
    {
      "id": "fba8677f-e464-4362-ba4f-55bbdc3dab94",
      "phone_number": "+9714XXXXXXX",
      "provider": "twilio",
      "label": "Outbound-Dubai"
    }
  ]
}