Get phone number binding

Read which agent version reference a number uses for inbound and outbound calls.

GEThttps://api.tried.com.au/phone-number-bindings/{n}

Beyond Retell Returns the version references bound to a number. A binding pins the number's agent to a version number, latest, latest_published or an environment tag such as prod, so you can roll back by moving the tag. Set it with Update phone number binding.

Request#

Path parameter	Type	Required	Description
`n`	string	Yes	The number in E.164, with `+` encoded as `%2B`.

This endpoint takes no query or body parameters.

Example request#

curl https://api.tried.com.au/phone-number-bindings/%2B61255501234 \
  -H "Authorization: Bearer $TRIED_API_KEY"

const n = encodeURIComponent("+61255501234");
const res = await fetch(`https://api.tried.com.au/phone-number-bindings/${n}`, {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const binding = await res.json();

import os, requests
from urllib.parse import quote

res = requests.get(
    f"https://api.tried.com.au/phone-number-bindings/{quote('+61255501234')}",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
binding = res.json()

Response#

200 OK

{
  "phone_number": "+61255501234",
  "inbound_version_ref": "prod",
  "outbound_version_ref": null
}

Field	Type	Description
`phone_number`	string	The number from the path.
`inbound_version_ref`	string or null	Version reference for inbound calls. `null` means no binding.
`outbound_version_ref`	string or null	Version reference for outbound calls from this number.

This endpoint does not check that the number exists: an unknown number returns both references as null.

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.