Zones within a multi-zone sip_infra_region to register the number on. The zones that come up are returned as availability_zones. Only for organizations with multi-zone routing enabled.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Verbex Docs","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/hishabsingaporepteltd/hKDJJlbuwj-_7GRI/light.png?fit=max\u0026auto=format\u0026n=hKDJJlbuwj-_7GRI\u0026q=85\u0026s=8e51283f8c4e5daa2b06e4c7b010036a","dark":"https://mintcdn.com/hishabsingaporepteltd/Bd-nkhA8cT0nKgAS/dark.png?fit=max\u0026auto=format\u0026n=Bd-nkhA8cT0nKgAS\u0026q=85\u0026s=c7eab5a32b4f7a91d7d0a702fa7aa1d1"},"favicon":"https://mintcdn.com/hishabsingaporepteltd/Bd-nkhA8cT0nKgAS/favicon.png?fit=max\u0026auto=format\u0026n=Bd-nkhA8cT0nKgAS\u0026q=85\u0026s=b848ae01a88c70cb541c5bf4ba708435","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://console.verbex.ai/dashboard"}},"footer":{"socials":{"discord":"https://discord.gg/9c6b2GAq5t","youtube":"https://www.youtube.com/@verbexadmin","facebook":"https://web.facebook.com/hishabltd","linkedin":"https://www.linkedin.com/company/hishab"}},"fonts":{"heading":{"family":"Poppins-Thin 100"},"body":{"family":"Poppins-Thin 100"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hishabsingaporepteltd","hasAudioNarration":false,"actualSubdomain":"hishabsingaporepteltd","customDomains":["docs.verbex.ai"],"gitSource":{"type":"github","owner":"verbex-ai","repo":"verbex-platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeaeb1bd4a2465447e7da11","collectionId":"599b3f16-9c4d-4600-a542-c97711032bed","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeaeb1bd4a2465447e7da11"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeaec36337b7de1552f3025","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":74},{"language":"default","tag":"Documentation","count":38},{"language":"default","tag":"Build Your AI Agent - Step by Step","count":23},{"language":"default","tag":"Knowledge Bases","count":13},{"language":"default","tag":" Connect Tools","count":11},{"language":"default","tag":"Webhook Subscriptions","count":6},{"language":"default","tag":" Configure Your AI Agent","count":5},{"language":"default","tag":"AI Agents v2","count":5},{"language":"default","tag":"AI Agents v3","count":5},{"language":"default","tag":"Built-in Tools","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/phone-numbers/get-a-phone-number","slug":"/api-reference/phone-numbers/get-a-phone-number","pageMetadata":{"title":"Get a phone number","description":"Retrieve detailed information about a specific phone number configuration, including:\n\n- Phone number details and provider\n- Associated inbound and outbound AI agents\n- SIP trunk configuration\n- Concurrency limits and advanced SIP settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/get-a-phone-number","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieve detailed information about a specific phone number configuration, including:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Phone number details and provider\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Associated inbound and outbound AI agents\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"SIP trunk configuration\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Concurrency limits and advanced SIP settings\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a phone number","description":"Retrieve detailed information about a specific phone number configuration, including:\n\n- Phone number details and provider\n- Associated inbound and outbound AI agents\n- SIP trunk configuration\n- Concurrency limits and advanced SIP settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/get-a-phone-number","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Phone Numbers"],"summary":"Get a phone number","description":"Retrieve detailed information about a specific phone number configuration, including:\n\n- Phone number details and provider\n- Associated inbound and outbound AI agents\n- SIP trunk configuration\n- Concurrency limits and advanced SIP settings","operationId":"get_phone_number_v1_phone_numbers__phone_number_id__get","parameters":["6d541045-8353-4aa5-b05e-e6c91a3524ae"],"responses":{"200":"588a203e-cf10-4e68-a082-3a429076685e","401":"c9fac9d8-d048-4bdd-bbcc-0431842c8f2a","404":"1be05dcf-66e9-4677-a937-e012f2d790fe","500":"eda2a8e7-0606-4049-98ba-f5460933a019"},"method":"get","type":"path","servers":[],"security":[],"path":"/v1/phone-numbers/{phone_number_id}","baseUrlOptions":[],"title":"Get a phone number","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6d541045-8353-4aa5-b05e-e6c91a3524ae":{"name":"phone_number_id","in":"path","required":true,"schema":{"type":"string","title":"Phone Number Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"588a203e-cf10-4e68-a082-3a429076685e":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"phone_number":{"type":"string","title":"Phone Number","description":"The phone number","isRequired":true,"uniqueKey":"phone_number","typeLabel":"string"},"_id":{"type":"string","title":"Id","description":"Unique identifier for this phone number record","uniqueKey":"_id","typeLabel":"string"},"provider":{"type":"string","const":"sip","title":"Provider","description":"Phone number provider","uniqueKey":"provider","typeLabel":"string"},"friendly_name":{"oneOf":[{"type":"string","title":"Friendly Name","description":"A human-readable label for this phone number. Cannot be blank when provided.","uniqueKey":"friendly_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Friendly Name","description":"A human-readable label for this phone number. Cannot be blank when provided.","uniqueKey":"friendly_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"friendly_name","typeLabel":"string | null"},"sip_termination_uri":{"oneOf":[{"type":"string","title":"Sip Termination Uri","description":"The SIP URI that outbound calls are sent to. The host must be an IP address or domain. Optional for inbound-only numbers.","uniqueKey":"sip_termination_uri.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sip Termination Uri","description":"The SIP URI that outbound calls are sent to. The host must be an IP address or domain. Optional for inbound-only numbers.","uniqueKey":"sip_termination_uri.oneOf.1","typeLabel":"null"}],"uniqueKey":"sip_termination_uri","typeLabel":"string | null"},"sip_trunk_username":{"oneOf":[{"type":"string","title":"Sip Trunk Username","description":"Username for authenticating with the SIP trunk provider","uniqueKey":"sip_trunk_username.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sip Trunk Username","description":"Username for authenticating with the SIP trunk provider","uniqueKey":"sip_trunk_username.oneOf.1","typeLabel":"null"}],"uniqueKey":"sip_trunk_username","typeLabel":"string | null"},"sip_trunk_password":{"oneOf":[{"type":"string","title":"Sip Trunk Password","description":"Password for authenticating with the SIP trunk provider","uniqueKey":"sip_trunk_password.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sip Trunk Password","description":"Password for authenticating with the SIP trunk provider","uniqueKey":"sip_trunk_password.oneOf.1","typeLabel":"null"}],"uniqueKey":"sip_trunk_password","typeLabel":"string | null"},"inbound_agent_id":{"oneOf":[{"type":"string","title":"Inbound Agent Id","description":"ID of the AI agent that handles incoming calls to this number. Cannot be blank when provided.","uniqueKey":"inbound_agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Inbound Agent Id","description":"ID of the AI agent that handles incoming calls to this number. Cannot be blank when provided.","uniqueKey":"inbound_agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"inbound_agent_id","typeLabel":"string | null"},"outbound_agent_id":{"oneOf":[{"type":"string","title":"Outbound Agent Id","description":"ID of the AI agent used for outbound calls from this number. Cannot be blank when provided.","uniqueKey":"outbound_agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Outbound Agent Id","description":"ID of the AI agent used for outbound calls from this number. Cannot be blank when provided.","uniqueKey":"outbound_agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"outbound_agent_id","typeLabel":"string | null"},"sip_infra_region":{"oneOf":[{"type":"string","title":"Sip Infra Region","description":"The infrastructure region for SIP routing","uniqueKey":"sip_infra_region.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sip Infra Region","description":"The infrastructure region for SIP routing","uniqueKey":"sip_infra_region.oneOf.1","typeLabel":"null"}],"uniqueKey":"sip_infra_region","typeLabel":"string | null"},"sip_infra_zones":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"sip_infra_zones.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Sip Infra Zones","description":"Zones within a multi-zone `sip_infra_region` to register the number on. The zones that come up are returned as `availability_zones`. Only for organizations with multi-zone routing enabled.","uniqueKey":"sip_infra_zones.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Sip Infra Zones","description":"Zones within a multi-zone `sip_infra_region` to register the number on. The zones that come up are returned as `availability_zones`. Only for organizations with multi-zone routing enabled.","uniqueKey":"sip_infra_zones.oneOf.1","typeLabel":"null"}],"uniqueKey":"sip_infra_zones","typeLabel":"string[] | null"},"call_concurrency":{"oneOf":[{"type":"integer","title":"Call Concurrency","description":"Maximum number of concurrent calls allowed on this number","minimum":1,"uniqueKey":"call_concurrency.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Call Concurrency","description":"Maximum number of concurrent calls allowed on this number","uniqueKey":"call_concurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"call_concurrency","typeLabel":"integer | null"},"max_concurrent_inbound_calls":{"oneOf":[{"type":"integer","title":"Max Concurrent Inbound Calls","description":"Maximum number of concurrent inbound calls","minimum":0,"uniqueKey":"max_concurrent_inbound_calls.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Concurrent Inbound Calls","description":"Maximum number of concurrent inbound calls","uniqueKey":"max_concurrent_inbound_calls.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_concurrent_inbound_calls","typeLabel":"integer | null"},"max_concurrent_outbound_calls":{"oneOf":[{"type":"integer","title":"Max Concurrent Outbound Calls","description":"Maximum number of concurrent outbound calls","minimum":0,"uniqueKey":"max_concurrent_outbound_calls.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Concurrent Outbound Calls","description":"Maximum number of concurrent outbound calls","uniqueKey":"max_concurrent_outbound_calls.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_concurrent_outbound_calls","typeLabel":"integer | null"},"expires":{"oneOf":[{"type":"integer","title":"Expires","description":"SIP registration expiry, in seconds","minimum":1,"uniqueKey":"expires.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Expires","description":"SIP registration expiry, in seconds","uniqueKey":"expires.oneOf.1","typeLabel":"null"}],"uniqueKey":"expires","typeLabel":"integer | null"},"advanced":{"oneOf":[{"type":"object","title":"AdvancedSipConfig","description":"Advanced SIP configuration","properties":{"realm":{"oneOf":[{"type":"string","title":"Realm","description":"SIP realm. Defaults to the SIP domain when empty. Cannot be blank when provided.","example":"asterisk","uniqueKey":"advanced.oneOf.0.realm.oneOf.0","typeLabel":"string"},{"type":"null","title":"Realm","description":"SIP realm. Defaults to the SIP domain when empty. Cannot be blank when provided.","example":"asterisk","uniqueKey":"advanced.oneOf.0.realm.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced.oneOf.0.realm","typeLabel":"string | null"},"ip":{"oneOf":[{"type":"string","title":"Ip","description":"Carrier IP address or CIDR to allow (e.g. `1.2.3.4/24`)","example":"1.2.3.4/24","uniqueKey":"advanced.oneOf.0.ip.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ip","description":"Carrier IP address or CIDR to allow (e.g. `1.2.3.4/24`)","example":"1.2.3.4/24","uniqueKey":"advanced.oneOf.0.ip.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced.oneOf.0.ip","typeLabel":"string | null"},"prefix":{"oneOf":[{"type":"string","title":"Prefix","description":"Dial prefix (digits only) prepended to the outbound trunk username","pattern":"^\\d+$","example":"0","uniqueKey":"advanced.oneOf.0.prefix.oneOf.0","typeLabel":"string"},{"type":"null","title":"Prefix","description":"Dial prefix (digits only) prepended to the outbound trunk username","example":"0","uniqueKey":"advanced.oneOf.0.prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced.oneOf.0.prefix","typeLabel":"string | null"},"register":{"oneOf":[{"type":"boolean","title":"Register","description":"Whether to register outbound to the carrier","default":true,"uniqueKey":"advanced.oneOf.0.register.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Register","description":"Whether to register outbound to the carrier","uniqueKey":"advanced.oneOf.0.register.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced.oneOf.0.register","typeLabel":"boolean | null"}},"uniqueKey":"advanced.oneOf.0","typeLabel":"AdvancedSipConfig · object"},{"type":"null","title":"Advanced","description":"Advanced SIP configuration","uniqueKey":"advanced.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced","typeLabel":"AdvancedSipConfig · object | null"},"availability_zones":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"availability_zones.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Availability Zones","description":"Zones the number is registered and available on. Omitted when not set.","uniqueKey":"availability_zones.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Availability Zones","description":"Zones the number is registered and available on. Omitted when not set.","uniqueKey":"availability_zones.oneOf.1","typeLabel":"null"}],"uniqueKey":"availability_zones","typeLabel":"string[] | null"},"workspace_id":{"oneOf":[{"type":"string","title":"Workspace Id","description":"Workspace the phone number belongs to","uniqueKey":"workspace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Workspace Id","description":"Workspace the phone number belongs to","uniqueKey":"workspace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"workspace_id","typeLabel":"string | null"}},"type":"object","required":["phone_number"],"title":"GetSIPPhoneNumberResponse","x-unpublished-properties":{"_note":"Hidden until published. To publish, move these back into `properties`.","inbound_sip_headers":{"anyOf":[{"$ref":"#/components/schemas/SipHeaderConfig"},{"type":"null"}],"title":"Inbound Sip Headers","description":"Custom inbound SIP header configuration"}},"uniqueKey":"","typeLabel":"GetSIPPhoneNumberResponse · object"},"examples":{"Example":{"title":"Example","value":{"phone_number":"\u003cstring>","_id":"\u003cstring>","provider":"sip","friendly_name":"\u003cstring>","sip_termination_uri":"\u003cstring>","sip_trunk_username":"\u003cstring>","sip_trunk_password":"\u003cstring>","inbound_agent_id":"\u003cstring>","outbound_agent_id":"\u003cstring>","sip_infra_region":"\u003cstring>","sip_infra_zones":["\u003cstring>"],"call_concurrency":2,"max_concurrent_inbound_calls":1,"max_concurrent_outbound_calls":1,"expires":2,"advanced":{"realm":"asterisk","ip":"1.2.3.4/24","prefix":"0","register":true},"availability_zones":["\u003cstring>"],"workspace_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c9fac9d8-d048-4bdd-bbcc-0431842c8f2a":{"description":"Unauthorized - missing or invalid API key (returned by the gateway).","content":{"application/json":{"schema":{"type":"object","title":"GatewayAuthErrorResponse","description":"Returned by the API gateway when the API key is missing or invalid (the request never reaches the service).","properties":{"error":{"type":"string","title":"Error","example":"Authentication","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","title":"Message","example":"Authentication failed","uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","title":"Trace Id","example":"e679120f-1d1c-41d2-947c-34e194d5a4a1","uniqueKey":"traceId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"GatewayAuthErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":"Authentication","message":"Authentication failed","traceId":"e679120f-1d1c-41d2-947c-34e194d5a4a1"}}},"exampleType":"generated"}},"exampleType":"generated"},"1be05dcf-66e9-4677-a937-e012f2d790fe":{"description":"Phone number not found, not active, or not in your organization/workspace.","content":{"application/json":{"schema":{"properties":{"status":{"type":"integer","title":"Status","description":"HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"Error type. Each type always maps to the same HTTP status:\n\n| HTTP | `type` |\n|---|---|\n| 400 | `BAD_REQUEST` |\n| 404 | `NOT_FOUND`, `PHONE_NOT_FOUND`, `AGENT_NOT_FOUND` |\n| 409 | `PHONE_ALREADY_EXISTS`, `CONFLICT` |\n| 422 | `VALIDATION_ERROR`, `MISSING_REQUIRED_FIELD` |\n| 500 | `INTERNAL_ERROR`, `KAMAILIO_SYNC_ERROR` |","enum":["VALIDATION_ERROR","MISSING_REQUIRED_FIELD","NOT_FOUND","PHONE_NOT_FOUND","AGENT_NOT_FOUND","CONFLICT","PHONE_ALREADY_EXISTS","BAD_REQUEST","KAMAILIO_SYNC_ERROR","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","title":"Message","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"trace_id":{"type":"string","title":"Trace Id","description":"Trace identifier to share with support","uniqueKey":"trace_id","typeLabel":"string"},"details":{"type":"object","title":"Details","description":"Additional error details. For body validation errors it holds `fields` (field name -> message). Omitted when empty.","uniqueKey":"details","typeLabel":"Details · object"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"When the error occurred (UTC)","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"path":{"type":"string","title":"Path","description":"Request path that produced the error","uniqueKey":"path","typeLabel":"string"}},"type":"object","required":["status","type","message"],"title":"PhoneNumberErrorResponse","example":{"status":422,"type":"VALIDATION_ERROR","message":"Invalid phone number format: '12'. Must be an optional '+' followed by 3 to 20 digits (e.g., +1234567890 or 999)","timestamp":"2026-11-01T10:00:00Z","path":"/v1/phone-numbers"},"uniqueKey":"","typeLabel":"PhoneNumberErrorResponse · object"},"example":{"status":404,"type":"PHONE_NOT_FOUND","message":"Phone number not found in Organization Id: ddd6f1d8-b232-497e-bf1e-ea7317622d17","trace_id":"341b5325-a0be-4533-85dd-6f697476dfc3","timestamp":"2026-11-01T10:00:00Z","path":"/v1/phone-numbers/6650f1c2a9b3e45d7c8f0a12"},"examples":{"Example":{"title":"Example","value":{"status":404,"type":"PHONE_NOT_FOUND","message":"Phone number not found in Organization Id: ddd6f1d8-b232-497e-bf1e-ea7317622d17","trace_id":"341b5325-a0be-4533-85dd-6f697476dfc3","timestamp":"2026-11-01T10:00:00Z","path":"/v1/phone-numbers/6650f1c2a9b3e45d7c8f0a12"}}},"exampleType":"examples"}},"exampleType":"examples"},"eda2a8e7-0606-4049-98ba-f5460933a019":{"description":"Internal server error, including SIP provisioning failures (`KAMAILIO_SYNC_ERROR`). Partial changes are rolled back.","content":{"application/json":{"schema":{"properties":{"status":{"type":"integer","title":"Status","description":"HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"Error type. Each type always maps to the same HTTP status:\n\n| HTTP | `type` |\n|---|---|\n| 400 | `BAD_REQUEST` |\n| 404 | `NOT_FOUND`, `PHONE_NOT_FOUND`, `AGENT_NOT_FOUND` |\n| 409 | `PHONE_ALREADY_EXISTS`, `CONFLICT` |\n| 422 | `VALIDATION_ERROR`, `MISSING_REQUIRED_FIELD` |\n| 500 | `INTERNAL_ERROR`, `KAMAILIO_SYNC_ERROR` |","enum":["VALIDATION_ERROR","MISSING_REQUIRED_FIELD","NOT_FOUND","PHONE_NOT_FOUND","AGENT_NOT_FOUND","CONFLICT","PHONE_ALREADY_EXISTS","BAD_REQUEST","KAMAILIO_SYNC_ERROR","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","title":"Message","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"trace_id":{"type":"string","title":"Trace Id","description":"Trace identifier to share with support","uniqueKey":"trace_id","typeLabel":"string"},"details":{"type":"object","title":"Details","description":"Additional error details. For body validation errors it holds `fields` (field name -> message). Omitted when empty.","uniqueKey":"details","typeLabel":"Details · object"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"When the error occurred (UTC)","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"path":{"type":"string","title":"Path","description":"Request path that produced the error","uniqueKey":"path","typeLabel":"string"}},"type":"object","required":["status","type","message"],"title":"PhoneNumberErrorResponse","example":{"status":422,"type":"VALIDATION_ERROR","message":"Invalid phone number format: '12'. Must be an optional '+' followed by 3 to 20 digits (e.g., +1234567890 or 999)","timestamp":"2026-11-01T10:00:00Z","path":"/v1/phone-numbers"},"uniqueKey":"","typeLabel":"PhoneNumberErrorResponse · object"},"examples":{"internal":{"title":"internal","value":{"status":500,"type":"INTERNAL_ERROR","message":"An unexpected error occurred","trace_id":"341b5325-a0be-4533-85dd-6f697476dfc3","timestamp":"2026-11-01T10:00:00Z","path":"/v1/phone-numbers"}},"kamailio":{"title":"kamailio","value":{"status":500,"type":"KAMAILIO_SYNC_ERROR","message":"Failed to provision Kamailio SIP tables","trace_id":"341b5325-a0be-4533-85dd-6f697476dfc3","timestamp":"2026-11-01T10:00:00Z","path":"/v1/phone-numbers"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"hishabsingaporepteltd","siteName":"Verbex Docs","title":"Get a phone number - Verbex Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T08:21:29.937Z","originalFileLocation":"api-reference/phone-numbers/get-a-phone-number.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve detailed information about a specific phone number configuration, including: - Phone number details and provider - Associated inbound and outbound AI agents - SIP trunk configuration - Concurrency limits and advanced SIP settings\">\u003cmeta data-mint-head name=\"application-name\" content=\"Verbex Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a phone number - Verbex Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve detailed information about a specific phone number configuration, including: - Phone number details and provider - Associated inbound and outbound AI agents - SIP trunk configuration - Concurrency limits and advanced SIP settings\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Verbex Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hishabsingaporepteltd.mintlify.app/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Get+a+phone+number\u0026amp;description=Retrieve+detailed+information+about+a+specific+phone+number+configuration%2C+including%3A%0A%0A-+Phone+number+details+and+provider%0A-+Associated+inbound+and+outbound+AI+\u0026amp;theme=70c8dcbcb80920d3074a2878\u0026amp;signature=87d2772b9aa1f985db649103429a122d9a38f3a6942cce7c480957af9bd6d5a7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a phone number - Verbex Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve detailed information about a specific phone number configuration, including: - Phone number details and provider - Associated inbound and outbound AI agents - SIP trunk configuration - Concurrency limits and advanced SIP settings\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hishabsingaporepteltd.mintlify.app/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Get+a+phone+number\u0026amp;description=Retrieve+detailed+information+about+a+specific+phone+number+configuration%2C+including%3A%0A%0A-+Phone+number+details+and+provider%0A-+Associated+inbound+and+outbound+AI+\u0026amp;theme=70c8dcbcb80920d3074a2878\u0026amp;signature=87d2772b9aa1f985db649103429a122d9a38f3a6942cce7c480957af9bd6d5a7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Verbex Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/phone-numbers/get-a-phone-number.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.verbex.ai/#organization\",\"name\":\"Verbex Docs\",\"url\":\"https://docs.verbex.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hishabsingaporepteltd/hKDJJlbuwj-_7GRI/light.png?fit=max\u0026auto=format\u0026n=hKDJJlbuwj-_7GRI\u0026q=85\u0026s=8e51283f8c4e5daa2b06e4c7b010036a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.verbex.ai#website\",\"name\":\"Verbex Docs\",\"url\":\"https://docs.verbex.ai\",\"publisher\":{\"@id\":\"https://docs.verbex.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number#webpage\",\"url\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number\",\"name\":\"Get a phone number\",\"description\":\"Retrieve detailed information about a specific phone number configuration, including: - Phone number details and provider - Associated inbound and outbound AI agents - SIP trunk configuration - Concurrency limits and advanced SIP settings\",\"dateModified\":\"2026-11-04T08:21:29.937Z\",\"isPartOf\":{\"@id\":\"https://docs.verbex.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Phone Numbers\",\"item\":\"https://docs.verbex.ai/api-reference/phone-numbers/list-phone-numbers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a phone number\",\"item\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number#apireference\",\"headline\":\"Get a phone number\",\"name\":\"Get a phone number\",\"description\":\"Retrieve detailed information about a specific phone number configuration, including: - Phone number details and provider - Associated inbound and outbound AI agents - SIP trunk configuration - Concurrency limits and advanced SIP settings\",\"url\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number\",\"mainEntityOfPage\":{\"@id\":\"https://docs.verbex.ai/api-reference/phone-numbers/get-a-phone-number#webpage\"},\"dateModified\":\"2026-11-04T08:21:29.937Z\",\"publisher\":{\"@id\":\"https://docs.verbex.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.verbex.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Verbex Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Verbex Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Getting an API Key","href":"/api-reference/introduction"},{"title":"Migrate from v2 to v3","href":"/api-reference/ai-agents-v3/migrate-from-v2"}]},{"group":"AI Agents v3","pages":[{"title":"List AI Agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/ai-agents","href":"/api-reference/ai-agents-v3/list-ai-agents"},{"title":"Create AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v3/ai-agents","href":"/api-reference/ai-agents-v3/create-ai-agent"},{"title":"Get AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v3/get-ai-agent"},{"title":"Update AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v3/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v3/update-ai-agent"},{"title":"Delete AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v3/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v3/delete-ai-agent"}]},{"group":"AI Agents v2","pages":[{"title":"List AI Agents","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/","href":"/api-reference/ai-agents-v2/list-ai-agents"},{"title":"Create AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/","href":"/api-reference/ai-agents-v2/create-ai-agent"},{"title":"Get AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v2/get-ai-agent"},{"title":"Update AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v2/update-ai-agent"},{"title":"Delete AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v2/delete-ai-agent"}]},{"group":"LLM Models","pages":[{"title":"List LLM models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/llm-models","href":"/api-reference/llm-models/list-llm-models"},{"title":"Get LLM model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/llm-models/{llm_model_id}","href":"/api-reference/llm-models/get-llm-model"}]},{"group":"Speech Providers","pages":[{"title":"List STT providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/stt/providers","href":"/api-reference/speech-providers/list-stt-providers"},{"title":"Get STT provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/stt/providers/{provider_name}","href":"/api-reference/speech-providers/get-stt-provider"},{"title":"List TTS providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/tts/providers","href":"/api-reference/speech-providers/list-tts-providers"},{"title":"Get TTS provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/tts/providers/{provider_name}","href":"/api-reference/speech-providers/get-tts-provider"}]},{"group":"Built-in Tools","pages":[{"title":"List built-in tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/builtin-tools/","href":"/api-reference/built-in-tools/list-built-in-tools"},{"title":"Create built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/{ai_agent_id}/builtin-tools/","href":"/api-reference/built-in-tools/create-built-in-tool"},{"title":"Get built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/builtin-tools/{tool_id}","href":"/api-reference/built-in-tools/get-built-in-tool"},{"title":"Update built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{ai_agent_id}/builtin-tools/{tool_id}","href":"/api-reference/built-in-tools/update-built-in-tool"},{"title":"Delete built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{ai_agent_id}/builtin-tools/{tool_id}","href":"/api-reference/built-in-tools/delete-built-in-tool"}]},{"group":"Custom Tools","pages":[{"title":"List custom tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/custom-tools/","href":"/api-reference/custom-tools/list-custom-tools"},{"title":"Create custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/{ai_agent_id}/custom-tools/","href":"/api-reference/custom-tools/create-custom-tool"},{"title":"Get custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/custom-tools/{tool_id}","href":"/api-reference/custom-tools/get-custom-tool"},{"title":"Update custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{ai_agent_id}/custom-tools/{tool_id}","href":"/api-reference/custom-tools/update-custom-tool"},{"title":"Delete custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{ai_agent_id}/custom-tools/{tool_id}","href":"/api-reference/custom-tools/delete-custom-tool"}]},{"group":"Calls","pages":[{"title":"Create Web Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/calls/create-web-call","href":"/api-reference/calls/create-web-call"},{"title":"Create Web Call (Public Shared)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/public/create-web-call","href":"/api-reference/calls/create-web-call-public-shared"},{"title":"Dial Outbound Phone Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/calls/dial-outbound-phone-call","href":"/api-reference/calls/dial-outbound-phone-call"},{"title":"Get Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/{call_id}","href":"/api-reference/calls/get-call"},{"title":"List Calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/","href":"/api-reference/calls/list-calls"}]},{"group":"Call Recording","pages":[{"title":"Get Signed URL for Call Recording","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/call-recording/signed-url","href":"/api-reference/call-recording/get-signed-url-for-call-recording"},{"title":"Download Call Recording","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/call-recording/download","href":"/api-reference/call-recording/download-call-recording"}]},{"group":"Post-call Analysis","pages":[{"title":"Get post-call analysis configuration for an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/get-post-call-analysis-configuration-for-an-agent"},{"title":"Update an existing post-call analysis configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/update-an-existing-post-call-analysis-configuration"},{"title":"Create a new post-call analysis configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/create-a-new-post-call-analysis-configuration"},{"title":"Delete an existing post-call analysis configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/delete-an-existing-post-call-analysis-configuration"},{"title":"Get Post Call Analysis Results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/postcall-analysis/results/{call_id}","href":"/api-reference/post-call-analysis/get-post-call-analysis-results"}]},{"group":"Phone Numbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/phone-numbers/","href":"/api-reference/phone-numbers/list-phone-numbers"},{"title":"Create a new phone number","description":"Import a phone number into the Verbex Platform through a SIP trunk.\n\nOnly Import Phone Numbers (SIP provider, `\"provider\": \"sip\"`) are supported. Use this to connect numbers from any SIP trunk, including Twilio Elastic SIP Trunking.\n\nThe phone number is validated and registered. You can then associate it with AI agents to handle inbound and outbound calls.\n\nDefaults applied when omitted: `call_concurrency` = 1, `expires` = 60.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/phone-numbers/","href":"/api-reference/phone-numbers/create-a-new-phone-number"},{"title":"Get a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/get-a-phone-number"},{"title":"Delete a phone number","description":"Remove a phone number from your account. This action:\n\n- Removes the phone number from your account\n- Disconnects any AI agent associations\n- Cleans up the SIP trunk configuration\n- Removes routing rules and dispatch configurations\n\nReturns the deleted phone number record.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/delete-a-phone-number"},{"title":"Update a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/update-a-phone-number"}]},{"group":"Knowledge Bases","pages":[{"title":"List Knowledge Bases","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases","href":"/api-reference/knowledge-bases/list-knowledge-bases"},{"title":"Create Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-bases","href":"/api-reference/knowledge-bases/create-knowledge-base"},{"title":"Get Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}","href":"/api-reference/knowledge-bases/get-knowledge-base"},{"title":"Delete Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/knowledge-bases/{kb_id}","href":"/api-reference/knowledge-bases/delete-knowledge-base"},{"title":"Update Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge-bases/{kb_id}","href":"/api-reference/knowledge-bases/update-knowledge-base"},{"title":"Upload a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-bases/{kb_id}/documents/file","href":"/api-reference/knowledge-bases/upload-a-file"},{"title":"Discover a Website's URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/documents/website/sitemaps","href":"/api-reference/knowledge-bases/discover-a-websites-urls"},{"title":"Crawl Web Pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-bases/{kb_id}/documents/website","href":"/api-reference/knowledge-bases/crawl-web-pages"},{"title":"List Documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}/documents","href":"/api-reference/knowledge-bases/list-documents"},{"title":"Get Document Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}/documents/{document_id}/status","href":"/api-reference/knowledge-bases/get-document-status"},{"title":"Inspect Indexed Chunks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}/documents/{document_id}/chunks","href":"/api-reference/knowledge-bases/inspect-indexed-chunks"},{"title":"Delete a Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/knowledge-bases/{kb_id}/documents/{document_id}","href":"/api-reference/knowledge-bases/delete-a-document"},{"title":"Semantic Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/vector/search","href":"/api-reference/knowledge-bases/semantic-search"}]},{"group":"Prompt Generation","pages":[{"title":"Generate Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/prompt-generation/prompt/generate","href":"/api-reference/prompt-generation/generate-prompt"}]},{"group":"Public Sharing","pages":[{"title":"Create Share","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/public-sharing/","href":"/api-reference/public-sharing/create-share"},{"title":"Get Share","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/public-sharing/{ai_agent_id}","href":"/api-reference/public-sharing/get-share"},{"title":"Delete Share","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/public-sharing/{share_id}","href":"/api-reference/public-sharing/delete-share"}]},{"group":"Webhook Subscriptions","pages":[{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/public/webhook/subscription","href":"/api-reference/webhook-subscriptions/create-a-subscription"},{"title":"Get a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/public/webhook/subscription/{id}","href":"/api-reference/webhook-subscriptions/get-a-subscription"},{"title":"Update a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/public/webhook/subscription/{id}","href":"/api-reference/webhook-subscriptions/update-a-subscription"},{"title":"Delete a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/public/webhook/subscription/{id}","href":"/api-reference/webhook-subscriptions/delete-a-subscription"},{"title":"Rotate the signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/public/webhook/subscription/{id}/rotate/secret","href":"/api-reference/webhook-subscriptions/rotate-the-signing-secret"},{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/public/webhook/subscriptions","href":"/api-reference/webhook-subscriptions/list-subscriptions"}]},{"group":"API Keys","pages":[{"title":"List API Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys/","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/","href":"/api-reference/api-keys/create-api-key"},{"title":"Get API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys/{key_id}","href":"/api-reference/api-keys/get-api-key"},{"title":"Revoke API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{key_id}/revoke","href":"/api-reference/api-keys/revoke-api-key"}]}]},{"tab":"Video Tutorials","pages":[{"title":"Video Tutorials","href":"/video-tutorials/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/changelog"}]}]},"basePath":"","title":"Get a phone number - Verbex Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}