List phone numbers

List every phone number in your workspace, newest first.

GEThttps://api.tried.com.au/v2/list-phone-numbers

Returns all numbers in your workspace, newest first. GET /list-phone-numbers is an alias for the same handler and returns the same response.

Request#

This endpoint takes no path, query or body parameters. There is no pagination: every number is returned.

Example request#

curl https://api.tried.com.au/v2/list-phone-numbers \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/v2/list-phone-numbers", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const numbers = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/v2/list-phone-numbers",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
numbers = res.json()

Response#

200 OK

A JSON array of number objects. Each has the fields listed on Get phone number.

[
  {
    "phone_number": "+61370105588",
    "phone_number_pretty": "+61 3 7010 5588",
    "nickname": "Melbourne sales",
    "provider": "twilio",
    "inbound_agents": [],
    "outbound_agents": [{ "agent_id": "agent_41b7e9d3c05a2f68e1d94b70", "weight": 1 }],
    "inbound_webhook_url": null,
    "allowed_inbound_country_list": null,
    "allowed_outbound_country_list": ["AU", "NZ"],
    "termination_uri": "tried-3c9e5b0a7d21.pstn.twilio.com",
    "sip_trunk_auth_username": null,
    "last_modification_timestamp": 1792400400000,
    "fallback_number": null,
    "transport": "TCP",
    "media_encryption": "allowed",
    "sip_trunk_id": null,
    "cps_limit": null,
    "livekit_inbound_trunk_id": "ST_2hVb6nQe8XcM",
    "livekit_outbound_trunk_id": "ST_7rKd4wPa1ZsF",
    "livekit_dispatch_rule_id": "SDR_3yTg9mLc5JuB",
    "provisioning_status": "provisioned",
    "provisioning_error": null,
    "spam_flagged": false,
    "country_code": "AU",
    "monthly_price": 8
  },
  {
    "phone_number": "+61255501234",
    "phone_number_pretty": "+61 2 5550 1234",
    "nickname": "Sydney front desk",
    "provider": "telnyx",
    "inbound_agents": [{ "agent_id": "agent_8d2f61c0a94b3e57d1f0c2a6", "weight": 1 }],
    "outbound_agents": [],
    "inbound_webhook_url": null,
    "allowed_inbound_country_list": ["AU"],
    "allowed_outbound_country_list": null,
    "termination_uri": null,
    "sip_trunk_auth_username": null,
    "last_modification_timestamp": 1792396800000,
    "fallback_number": null,
    "transport": "TCP",
    "media_encryption": "allowed",
    "sip_trunk_id": null,
    "cps_limit": null,
    "livekit_inbound_trunk_id": "ST_4kQm8vWz2RfT",
    "livekit_outbound_trunk_id": "ST_9pLx3cHn7YbD",
    "livekit_dispatch_rule_id": "SDR_6tJe1sGa5UoK",
    "provisioning_status": "provisioned",
    "provisioning_error": null,
    "spam_flagged": false,
    "country_code": "AU",
    "monthly_price": 8
  }
]

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `numbers` scope.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Same path and method as Retell. Tried returns a plain array of every number and ignores any query parameters.