View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.
← Partner API ReferenceView and monitor the DID (Direct Inward Dialing) phone number inventory assigned to each customer, or get a global view across all accounts. Customers need at least one active DID to receive inbound calls.
All Partner API requests use X-Auth-ID and X-Auth-Token headers. See Authentication for details.
These endpoints are read-only. They show you what numbers are assigned to each customer. To assign or release numbers, use the Vobiz Console or contact your account manager.
Numbers across every customer under your partner account. See All Numbers (Global).
Read-only inventory. Use the Partner API to view your inventory. To assign, purchase, or release phone numbers, use the Vobiz Partner Console, or contact support@vobiz.ai for bulk number provisioning.
Returns all phone numbers assigned to a specific customer account. Use to verify a customer’s number inventory, check allocation status, and identify the application each number is routed to.
Per-channel flags - voice, sms, mms, fax. Indian DIDs are typically voice-only.
application_id
The Vobiz application the number is routed to. A number with no application has nowhere to route inbound calls.
setup_fee / monthly_fee
One-time and recurring rental cost in currency. Add monthly_fee to the customer’s invoice.
last_billing_date / next_billing_date
When the DID was last charged and when it next renews. There is no separate expires_at; a number stops routing only when released or when the account can’t cover the next rental.
aadhaar_verification_required / aadhaar_verified
Indian regulatory flag. If aadhaar_verification_required is true and aadhaar_verified is false, the number may be restricted until the customer completes KYC.
Returns all phone numbers across every customer account under your partner umbrella. Use to audit your complete DID inventory, identify unassigned numbers, or find numbers that are expiring soon.
Every customer needs at least one active number - A customer with no assigned numbers cannot receive inbound calls. After creating a customer account, assign at least one DID via the Vobiz Console.
Monitor renewals - Watch next_billing_date. A DID stops routing only when it is released or when the customer’s wallet can’t cover the next rental. Build a weekly check that flags numbers renewing within 14 days against customers whose balance is low.
Verify application routing after assignment - After assigning a number, confirm application_id is set. A number with no application receives calls but has nowhere to route them, causing immediate hangups for callers.
Track costs for billing - Use monthly_fee (recurring) and setup_fee (one-time) for the DID rental cost per number. Add these to the customer invoice alongside call usage from the CDR endpoint.
Watch Aadhaar status (India) - If aadhaar_verification_required is true but aadhaar_verified is false, the number may be regulatorily restricted until the customer completes KYC.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Vobiz","colors":{"primary":"#E83C00","light":"#E86A00","dark":"#c93400"},"logo":{"light":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c","dark":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/dark.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=57b37e5694f01e6933c9ec02a871250a","href":"https://www.vobiz.ai/docs/introduction"},"favicon":"https://mintcdn.com/vobizai/BDRzOqCvIsC8CJvN/favicon.svg?fit=max\u0026auto=format\u0026n=BDRzOqCvIsC8CJvN\u0026q=85\u0026s=b38182f12bc6b0e3a5df2a8ae1474f83","api":{"openapi":["openapi.yaml","openapi-sms.yaml"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"mdx":{"auth":{"method":"key","name":"X-Auth-Token"},"server":"https://api.vobiz.ai"}},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@vobiz.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.vobiz.ai"}},"footer":{"socials":{"x":"https://x.com/Vobiz_Ai","github":"https://github.com/vobiz-ai","linkedin":"https://linkedin.com/company/vobizai"}},"seo":{"metatags":{"canonical":"https://www.vobiz.ai/docs","og:site_name":"Vobiz Docs","og:type":"website","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@Vobiz_Ai","twitter:creator":"@Vobiz_Ai","theme-color":"#E83C00","color-scheme":"dark light","author":"Vobiz","publisher":"Vobiz","copyright":"Copyright 2025 Vobiz","reply-to":"support@vobiz.ai","robots":"index, follow","format-detection":"telephone=no","referrer":"origin-when-cross-origin","rating":"general","language":"en","category":"Technology","coverage":"Worldwide","distribution":"global","target":"all"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-YD6M3FF3P4"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vobizai","hasAudioNarration":false,"actualSubdomain":"vobizai","customDomains":["www.vobiz.ai"],"gitSource":{"type":"github","owner":"vobiz-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae8948acb9fa025302af88e"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec3ffcdd9d9f5b04d709a3","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":381},{"language":"default","tag":"Voice \u0026 XML","count":118},{"language":"default","tag":"Documentation","count":95},{"language":"default","tag":"SMS \u0026 RCS","count":90},{"language":"default","tag":"Integrations","count":77},{"language":"default","tag":"Examples \u0026 Tutorials","count":58},{"language":"default","tag":"Blogs","count":56},{"language":"default","tag":"Articles","count":54},{"language":"default","tag":"Regular APIs","count":40},{"language":"default","tag":"SIP Trunking","count":32}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@vobiz.ai","showHelpButton":true}},"basePath":"/docs","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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","href":"/docs/_mintlify/custom/vobizai/d66dbca68df51c68/custom.css"}],"page":{"pagePath":"partner/api/numbers","slug":"/partner/api/numbers","pageMetadata":{"title":"Phone Numbers (DIDs)","openapi":"GET /api/v1/partner/accounts/{customer_auth_id}/numbers","description":"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.","keywords":["partner DID API","Vobiz partner phone numbers","DID inventory API","reseller phone number management","partner number assignment API","Indian DID partner API","partner phone number purchase","DID release API partner","reseller phone number list","partner virtual number API","partner number search API","DID allocation reseller","Vobiz DID endpoint partner","partner number porting API","phone number inventory partner","partner DID rental","telephony DID reseller","partner number release endpoint","Vobiz partner number assignment"],"href":"/partner/api/numbers"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.a,{href:`/partner/api`,children:`← Partner API Reference`})}),`\n`,_jsx(_components.p,{children:`View and monitor the DID (Direct Inward Dialing) phone number inventory assigned to each customer, or get a global view across all accounts. Customers need at least one active DID to receive inbound calls.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`All Partner API requests use `,_jsx(_components.code,{children:`X-Auth-ID`}),` and `,_jsx(_components.code,{children:`X-Auth-Token`}),` headers. See `,_jsx(_components.a,{href:`/partner/api/authentication`,children:`Authentication`}),` for details.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`These endpoints are `,_jsx(_components.strong,{children:`read-only`}),`. They show you what numbers are assigned to each customer. To assign or release numbers, use the Vobiz Console or contact your account manager.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Returns`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/partner/accounts/{customer_auth_id}/numbers`})}),_jsxs(_components.td,{children:[`Numbers assigned to one customer. See `,_jsx(_components.a,{href:`#customer-numbers`,children:`Customer Numbers`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/partner/numbers`})}),_jsxs(_components.td,{children:[`Numbers across every customer under your partner account. See `,_jsx(_components.a,{href:`#all-numbers-global`,children:`All Numbers (Global)`}),`.`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Read-only inventory.`}),` Use the Partner API to view your inventory. To assign, purchase, or release phone numbers, use the `,_jsx(_components.a,{href:`https://console.vobiz.ai`,children:`Vobiz Partner Console`}),`, or contact `,_jsx(_components.a,{href:`mailto:support@vobiz.ai`,children:`support@vobiz.ai`}),` for bulk number provisioning.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`customer-numbers`,children:`Customer Numbers`}),`\n`,_jsx(_components.p,{children:`Returns all phone numbers assigned to a specific customer account. Use to verify a customer’s number inventory, check allocation status, and identify the application each number is routed to.`}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_auth_id`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`The customer’s `,_jsx(_components.code,{children:`auth_id`}),`, as returned when you `,_jsx(_components.a,{href:`/partner/api/customers#create-customer-account`,children:`created the customer`}),`.`]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1`})}),_jsx(_components.td,{children:`Page number (1-indexed)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`per_page`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`20`})}),_jsxs(_components.td,{children:[`Items per page (max `,_jsx(_components.code,{children:`100`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`search`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`}),_jsx(_components.td,{children:`Filter by partial number match`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/numbers?page=1\u0026per_page=20\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {your_partner_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {your_auth_token}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Accept: application/json\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/numbers?search=9122712\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {your_partner_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {your_auth_token}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Accept: application/json\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`35`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`35`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"aabbccdd-1234-5678-90ab-cdef12345678\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MA_XXXXXXXX\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"e164\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+918012345678\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"IN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"region\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Karnataka\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"capabilities\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"voice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"sms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"mms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"fax\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"provider\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"setup_fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"monthly_fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`300`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"application_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20577609616603585\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"voice_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"purchased_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-25T06:58:38Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_blocked\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-03-31T18:30:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-25T06:58:54Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_trial_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_billing_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-25T06:58:38Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"next_billing_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-25T06:58:38Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minimum_commitment_months\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"aadhaar_verification_required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"aadhaar_verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"purchased\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"per_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_auth_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MA_XXXXXXXX\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`e164`})}),_jsx(_components.td,{children:`The number in E.164 format.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`active`}),` once the number is routing.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`capabilities`})}),_jsxs(_components.td,{children:[`Per-channel flags - `,_jsx(_components.code,{children:`voice`}),`, `,_jsx(_components.code,{children:`sms`}),`, `,_jsx(_components.code,{children:`mms`}),`, `,_jsx(_components.code,{children:`fax`}),`. Indian DIDs are typically voice-only.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`application_id`})}),_jsx(_components.td,{children:`The Vobiz application the number is routed to. A number with no application has nowhere to route inbound calls.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`setup_fee`}),` / `,_jsx(_components.code,{children:`monthly_fee`})]}),_jsxs(_components.td,{children:[`One-time and recurring rental cost in `,_jsx(_components.code,{children:`currency`}),`. Add `,_jsx(_components.code,{children:`monthly_fee`}),` to the customer’s invoice.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`last_billing_date`}),` / `,_jsx(_components.code,{children:`next_billing_date`})]}),_jsxs(_components.td,{children:[`When the DID was last charged and when it next renews. There is no separate `,_jsx(_components.code,{children:`expires_at`}),`; a number stops routing only when released or when the account can’t cover the next rental.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`aadhaar_verification_required`}),` / `,_jsx(_components.code,{children:`aadhaar_verified`})]}),_jsxs(_components.td,{children:[`Indian regulatory flag. If `,_jsx(_components.code,{children:`aadhaar_verification_required`}),` is `,_jsx(_components.code,{children:`true`}),` and `,_jsx(_components.code,{children:`aadhaar_verified`}),` is `,_jsx(_components.code,{children:`false`}),`, the number may be restricted until the customer completes KYC.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`source`})}),_jsxs(_components.td,{children:[`How the number was obtained, e.g. `,_jsx(_components.code,{children:`purchased`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`all-item-fields`,children:`All item fields`}),`\n`,_jsxs(_components.p,{children:[`Every item in `,_jsx(_components.code,{children:`items`}),` carries these fields. The example values come from the response above.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Example`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string (UUID)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`aabbccdd-…`})}),_jsx(_components.td,{children:`Identifier of the number record.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MA_XXXXXXXX`})}),_jsxs(_components.td,{children:[`The customer `,_jsx(_components.code,{children:`auth_id`}),` the number is assigned to.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`e164`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`+918012345678`})}),_jsx(_components.td,{children:`The number in E.164 format.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`country`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`IN`})}),_jsx(_components.td,{children:`ISO country code of the number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`region`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Karnataka`})}),_jsx(_components.td,{children:`Region of the number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`capabilities`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"voice\": true, … }`})}),_jsxs(_components.td,{children:[`Per-channel flags: `,_jsx(_components.code,{children:`voice`}),`, `,_jsx(_components.code,{children:`sms`}),`, `,_jsx(_components.code,{children:`mms`}),`, `,_jsx(_components.code,{children:`fax`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`voice_enabled`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsx(_components.td,{children:`Whether voice is enabled on the number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`active`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`active`}),` once the number is routing.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`provider`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsx(_components.td,{children:`Upstream provider, empty when not set.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`application_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`20577609616603585`})}),_jsx(_components.td,{children:`The Vobiz application inbound calls are routed to.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`setup_fee`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`100`})}),_jsxs(_components.td,{children:[`One-time rental cost in `,_jsx(_components.code,{children:`currency`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`monthly_fee`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`300`})}),_jsxs(_components.td,{children:[`Recurring rental cost in `,_jsx(_components.code,{children:`currency`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INR`})}),_jsxs(_components.td,{children:[`Currency of `,_jsx(_components.code,{children:`setup_fee`}),` and `,_jsx(_components.code,{children:`monthly_fee`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`minimum_commitment_months`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`0`})}),_jsx(_components.td,{children:`Minimum rental commitment, in months.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`purchased_at`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2026-03-25T06:58:38Z`})}),_jsx(_components.td,{children:`When the number was purchased.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`last_billing_date`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2026-03-25T06:58:38Z`})}),_jsx(_components.td,{children:`When the rental was last charged.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`next_billing_date`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2026-04-25T06:58:38Z`})}),_jsx(_components.td,{children:`When the rental next renews.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_blocked`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Whether the number is blocked.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_trial_number`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Whether the number is a trial number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`aadhaar_verification_required`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Whether Indian Aadhaar verification is required for the number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`aadhaar_verified`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Whether that verification is complete.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tags`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`[]`})}),_jsx(_components.td,{children:`Tags on the number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`source`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`purchased`})}),_jsx(_components.td,{children:`How the number was obtained.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_at`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2025-03-31T18:30:00Z`})}),_jsx(_components.td,{children:`When the number record was created.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updated_at`})}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2026-03-25T06:58:54Z`})}),_jsx(_components.td,{children:`When the number record was last updated.`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`pagination-fields`,children:`Pagination fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`The numbers on this page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Current page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`per_page`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Items per page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`total`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Numbers across all pages.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_auth_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The customer the numbers belong to.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`all-numbers-global`,children:`All Numbers (Global)`}),`\n`,_jsx(_components.p,{children:`Returns all phone numbers across every customer account under your partner umbrella. Use to audit your complete DID inventory, identify unassigned numbers, or find numbers that are expiring soon.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/partner/numbers?page=1\u0026per_page=50\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {your_partner_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {your_auth_token}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Accept: application/json\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The global response uses the same item schema as the per-customer endpoint, paginated across every account under your umbrella.`}),`\n`,_jsx(Heading,{level:`2`,id:`number-management-guide`,children:`Number Management Guide`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Every customer needs at least one active number`}),` - A customer with no assigned numbers cannot receive inbound calls. After creating a customer account, assign at least one DID via the Vobiz Console.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Monitor renewals`}),` - Watch `,_jsx(_components.code,{children:`next_billing_date`}),`. A DID stops routing only when it is released or when the customer’s wallet can’t cover the next rental. Build a weekly check that flags numbers renewing within 14 days against customers whose balance is low.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verify application routing after assignment`}),` - After assigning a number, confirm `,_jsx(_components.code,{children:`application_id`}),` is set. A number with no application receives calls but has nowhere to route them, causing immediate hangups for callers.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Track costs for billing`}),` - Use `,_jsx(_components.code,{children:`monthly_fee`}),` (recurring) and `,_jsx(_components.code,{children:`setup_fee`}),` (one-time) for the DID rental cost per number. Add these to the customer invoice alongside call usage from the `,_jsx(_components.a,{href:`/partner/api/cdrs`,children:`CDR endpoint`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Watch Aadhaar status (India)`}),` - If `,_jsx(_components.code,{children:`aadhaar_verification_required`}),` is `,_jsx(_components.code,{children:`true`}),` but `,_jsx(_components.code,{children:`aadhaar_verified`}),` is `,_jsx(_components.code,{children:`false`}),`, the number may be regulatorily restricted until the customer completes `,_jsx(_components.a,{href:`/partner/api/kyc-sessions`,children:`KYC`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Phone Numbers (DIDs)","openapi":"GET /api/v1/partner/accounts/{customer_auth_id}/numbers","description":"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.","keywords":["partner DID API","Vobiz partner phone numbers","DID inventory API","reseller phone number management","partner number assignment API","Indian DID partner API","partner phone number purchase","DID release API partner","reseller phone number list","partner virtual number API","partner number search API","DID allocation reseller","Vobiz DID endpoint partner","partner number porting API","phone number inventory partner","partner DID rental","telephony DID reseller","partner number release endpoint","Vobiz partner number assignment"],"href":"/partner/api/numbers"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Customer Numbers","slug":"customer-numbers","depth":2,"children":[{"title":"Path Parameters","slug":"path-parameters","depth":3,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":3,"children":[]},{"title":"Response fields","slug":"response-fields","depth":3,"children":[]},{"title":"All item fields","slug":"all-item-fields","depth":4,"children":[]},{"title":"Pagination fields","slug":"pagination-fields","depth":4,"children":[]}]},{"title":"All Numbers (Global)","slug":"all-numbers-global","depth":2,"children":[]},{"title":"Number Management Guide","slug":"number-management-guide","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/vobizai/478834ae2c200a0e/blog-schema.js"],"openApiReferenceData":{"operation":{"operationId":"list-customer-numbers","summary":"List customer numbers","description":"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.","tags":["Partner API"],"parameters":["fba5162b-c97d-4043-891d-9a76ea5e5fd8","ebaaf0ec-4c6f-41e6-9a0f-ecadb75068df","7a1fe392-c5a8-4d85-9eca-765cdc6d71c6","17cd770d-16cf-4b65-9cbe-311c7aabe5f3"],"responses":{"200":"c3488aaf-1676-46fa-a89d-8e24a53eeec8"},"method":"get","type":"path","servers":["63df1293-34a2-4314-96e6-4cfcad0f4404"],"security":["c50d337f-92a2-4e86-b2c1-8be733ff0e0b"],"path":"/api/v1/partner/accounts/{customer_auth_id}/numbers","baseUrlOptions":["https://api.vobiz.ai"],"title":"List customer numbers","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"fba5162b-c97d-4043-891d-9a76ea5e5fd8":{"name":"customer_auth_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"ebaaf0ec-4c6f-41e6-9a0f-ecadb75068df":{"name":"search","in":"query","description":"Substring match against the E.164 number.","schema":{"type":"string","description":"Substring match against the E.164 number.","uniqueKey":"","typeLabel":"string"}},"7a1fe392-c5a8-4d85-9eca-765cdc6d71c6":{"name":"page","in":"query","schema":{"type":"integer","default":1,"uniqueKey":"","typeLabel":"integer"}},"17cd770d-16cf-4b65-9cbe-311c7aabe5f3":{"name":"per_page","in":"query","schema":{"type":"integer","default":20,"uniqueKey":"","typeLabel":"integer"}}},"responses":{"c3488aaf-1676-46fa-a89d-8e24a53eeec8":{"description":"Customer numbers","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","isRequired":true,"uniqueKey":"\\items","typeLabel":"array"},"page":{"type":"integer","isRequired":true,"uniqueKey":"page","typeLabel":"integer"},"per_page":{"type":"integer","isRequired":true,"uniqueKey":"per_page","typeLabel":"integer"},"total":{"type":"integer","isRequired":true,"uniqueKey":"total","typeLabel":"integer"},"account_auth_id":{"type":"string","isRequired":true,"uniqueKey":"account_auth_id","typeLabel":"string"}},"required":["items","page","per_page","total","account_auth_id"],"uniqueKey":"","typeLabel":"object"},"example":{"items":[{"id":"aabbccdd-1234-5678-90ab-cdef12345678","account_id":"MA_XXXXXXXX","e164":"+918012345678","country":"IN","region":"Karnataka","capabilities":{"voice":true,"sms":false,"mms":false,"fax":false},"status":"active","provider":"","setup_fee":100,"monthly_fee":300,"currency":"INR","application_id":"20577609616603585","voice_enabled":true,"tags":[],"purchased_at":"2026-03-25T06:58:38Z","is_blocked":false,"created_at":"2025-03-31T18:30:00Z","updated_at":"2026-03-25T06:58:54Z","is_trial_number":false,"last_billing_date":"2026-03-25T06:58:38Z","next_billing_date":"2026-04-25T06:58:38Z","minimum_commitment_months":0,"aadhaar_verification_required":false,"aadhaar_verified":false,"source":"purchased"},{"id":"11223344-1234-5678-90ab-cdef12345678","account_id":"MA_XXXXXXXX","e164":"+919876543210","country":"IN","region":"Mumbai","capabilities":{"voice":true,"sms":false,"mms":false,"fax":false},"status":"active","provider":"","setup_fee":100,"monthly_fee":200,"currency":"INR","application_id":"31985999331899218","voice_enabled":true,"tags":[],"purchased_at":"2026-02-17T10:25:30Z","is_blocked":false,"created_at":"2026-02-14T09:30:04Z","updated_at":"2026-02-17T10:29:35Z","is_trial_number":false,"last_billing_date":"2026-02-17T10:25:30Z","next_billing_date":"2026-03-17T10:25:30Z","minimum_commitment_months":0,"aadhaar_verification_required":false,"aadhaar_verified":false,"source":"purchased"}],"page":1,"per_page":20,"total":2,"account_auth_id":"MA_XXXXXXXX"},"examples":{"Example":{"title":"Example","value":{"items":[{"id":"aabbccdd-1234-5678-90ab-cdef12345678","account_id":"MA_XXXXXXXX","e164":"+918012345678","country":"IN","region":"Karnataka","capabilities":{"voice":true,"sms":false,"mms":false,"fax":false},"status":"active","provider":"","setup_fee":100,"monthly_fee":300,"currency":"INR","application_id":"20577609616603585","voice_enabled":true,"tags":[],"purchased_at":"2026-03-25T06:58:38Z","is_blocked":false,"created_at":"2025-03-31T18:30:00Z","updated_at":"2026-03-25T06:58:54Z","is_trial_number":false,"last_billing_date":"2026-03-25T06:58:38Z","next_billing_date":"2026-04-25T06:58:38Z","minimum_commitment_months":0,"aadhaar_verification_required":false,"aadhaar_verified":false,"source":"purchased"},{"id":"11223344-1234-5678-90ab-cdef12345678","account_id":"MA_XXXXXXXX","e164":"+919876543210","country":"IN","region":"Mumbai","capabilities":{"voice":true,"sms":false,"mms":false,"fax":false},"status":"active","provider":"","setup_fee":100,"monthly_fee":200,"currency":"INR","application_id":"31985999331899218","voice_enabled":true,"tags":[],"purchased_at":"2026-02-17T10:25:30Z","is_blocked":false,"created_at":"2026-02-14T09:30:04Z","updated_at":"2026-02-17T10:29:35Z","is_trial_number":false,"last_billing_date":"2026-02-17T10:25:30Z","next_billing_date":"2026-03-17T10:25:30Z","minimum_commitment_months":0,"aadhaar_verification_required":false,"aadhaar_verified":false,"source":"purchased"}],"page":1,"per_page":20,"total":2,"account_auth_id":"MA_XXXXXXXX"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c50d337f-92a2-4e86-b2c1-8be733ff0e0b":{"AuthID":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"AuthToken":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"}}},"servers":{"63df1293-34a2-4314-96e6-4cfcad0f4404":{"url":"https://api.vobiz.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"schema":{"title":"X-Auth-ID","type":"string","description":"Your Vobiz account Auth ID","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthID","name":"X-Auth-ID"},{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"},"schema":{"title":"X-Auth-Token","type":"string","description":"Your Vobiz account Auth Token","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthToken","name":"X-Auth-Token"}],"title":"AuthID \u0026 AuthToken"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"vobizai","siteName":"Vobiz","title":"Phone Numbers (DIDs) - Vobiz","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T13:20:05.316Z","originalFileLocation":"partner/api/numbers.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=\"dark\"}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=\"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_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=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Phone Numbers (DIDs) - Vobiz\">\u003cmeta data-mint-head property=\"og:description\" content=\"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vobiz Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vobiz.ai/docs/partner/api/numbers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Phone+Numbers+%28DIDs%29\u0026amp;description=View+and+monitor+DID+phone+number+assignments+for+each+customer+in+your+Vobiz+partner+ecosystem+-+list+per-customer+numbers+or+get+a+global+inventory+overview.\u0026amp;theme=7ca89684cd0aa2e26b6f330f\u0026amp;signature=98d72220de8e62bc7a29e71b69e88a410345d260db30743018a3ae6aa44ced87\">\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=\"Phone Numbers (DIDs) - Vobiz\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Phone+Numbers+%28DIDs%29\u0026amp;description=View+and+monitor+DID+phone+number+assignments+for+each+customer+in+your+Vobiz+partner+ecosystem+-+list+per-customer+numbers+or+get+a+global+inventory+overview.\u0026amp;theme=7ca89684cd0aa2e26b6f330f\u0026amp;signature=98d72220de8e62bc7a29e71b69e88a410345d260db30743018a3ae6aa44ced87\">\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=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@Vobiz_Ai\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"dark light\">\u003cmeta data-mint-head name=\"author\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"publisher\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2025 Vobiz\">\u003cmeta data-mint-head name=\"reply-to\" content=\"support@vobiz.ai\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin-when-cross-origin\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"target\" content=\"all\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.vobiz.ai/docs/partner/api/numbers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/partner/api/numbers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.vobiz.ai/#organization\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.vobiz.ai/docs#website\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai/docs\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.vobiz.ai/docs/partner/api/numbers#webpage\",\"url\":\"https://www.vobiz.ai/docs/partner/api/numbers\",\"name\":\"Phone Numbers (DIDs)\",\"description\":\"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.\",\"dateModified\":\"2026-11-04T13:20:05.316Z\",\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vobiz.ai/docs/partner/api/numbers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vobiz.ai/docs/partner/api/numbers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://www.vobiz.ai/docs/partner/api/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Phone Numbers (DIDs)\",\"item\":\"https://www.vobiz.ai/docs/partner/api/numbers\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vobiz.ai/docs/partner/api/numbers#apireference\",\"headline\":\"Phone Numbers (DIDs)\",\"name\":\"Phone Numbers (DIDs)\",\"description\":\"View and monitor DID phone number assignments for each customer in your Vobiz partner ecosystem - list per-customer numbers or get a global inventory overview.\",\"url\":\"https://www.vobiz.ai/docs/partner/api/numbers\",\"mainEntityOfPage\":{\"@id\":\"https://www.vobiz.ai/docs/partner/api/numbers#webpage\"},\"dateModified\":\"2026-11-04T13:20:05.316Z\",\"keywords\":\"partner DID API, Vobiz partner phone numbers, DID inventory API, reseller phone number management, partner number assignment API, Indian DID partner API, partner phone number purchase, DID release API partner, reseller phone number list, partner virtual number API, partner number search API, DID allocation reseller, Vobiz DID endpoint partner, partner number porting API, phone number inventory partner, partner DID rental, telephony DID reseller, partner number release endpoint, Vobiz partner number assignment\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vobiz\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vobiz","nav":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","anchors":[{"anchor":"Regular APIs","icon":"database","pages":[{"title":"Regular APIs","href":"/account"}]},{"anchor":"SIP Trunking","icon":"network-wired","pages":[{"title":"SIP Trunking","href":"/trunks"}]},{"anchor":"Voice \u0026 XML","icon":"microphone","pages":[{"title":"Voice \u0026 XML","href":"/applications"}]},{"anchor":"SMS \u0026 RCS","icon":"comment-sms","pages":[{"title":"SMS \u0026 RCS","href":"/sms/overview"}]},{"anchor":"WhatsApp","icon":"comment-dots","pages":[{"title":"WhatsApp","href":"/whatsapp/getting-started/introduction"}]},{"anchor":"Partner API","icon":"handshake","groups":[{"group":"Overview \u0026 Flow","icon":"map","root":{"title":"Vobiz Partner Portal — Reseller Telephony \u0026 Sub-Account Program","sidebarTitle":"Partner Portal","href":"/partner"},"pages":[{"title":"Partner Integration Flow","sidebarTitle":"Example Flow","href":"/partner/flow"},{"title":"Partner API Reference","href":"/partner/api"}]},{"group":"Endpoints","icon":"terminal","pages":[{"title":"Partner API Authentication","sidebarTitle":"Authentication","href":"/partner/api/authentication"},{"title":"Partner Profile","sidebarTitle":"Profile","openapi":"GET /api/v1/partner/me","href":"/partner/api/profile"},{"title":"Dashboard \u0026 Analytics","openapi":"GET /api/v1/partner/dashboard","href":"/partner/api/analytics"},{"title":"Customer Accounts","openapi":"GET /api/v1/partner/accounts","href":"/partner/api/customers"},{"title":"Balance Transfer","openapi":"POST /api/v1/partner/accounts/{customer_auth_id}/transfer-balance","href":"/partner/api/balance"},{"title":"Vobiz partner CPS and concurrency allocation","sidebarTitle":"CPS and concurrency","href":"/partner/api/capacity"},{"title":"KYC Sessions","href":"/partner/api/kyc-sessions"},{"title":"Partner Transactions","sidebarTitle":"Transactions","openapi":"GET /api/v1/partner/accounts/{customer_auth_id}/transactions","href":"/partner/api/transactions"},{"title":"CDRs (Call History)","openapi":"GET /api/v1/partner/accounts/{customer_auth_id}/cdrs","description":"Fetch call detail records for every voice session across your Vobiz partner ecosystem - filter by date, direction, or hangup cause for billing and quality.","href":"/partner/api/cdrs"},{"title":"Phone Numbers (DIDs)","openapi":"GET /api/v1/partner/accounts/{customer_auth_id}/numbers","href":"/partner/api/numbers"}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Examples \u0026 Tutorials","pages":[{"title":"Examples \u0026 Tutorials","href":"/guides/ai-voice-agent"}]},{"tab":"Blogs","pages":[{"title":"Blogs","href":"/blogs"}]}]},"basePath":"","title":"Phone Numbers (DIDs) - Vobiz","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CePXnjd1.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","clsx-apD-Q0Oo.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-qmLwQyWY.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Dc4qTkWx.js"]}