Local US and Canadian numbers you can buy now, each with its monthly price. within_free_allowance is true when your plan covers it, and then the price is 0.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Brilo","colors":{"primary":"#8C7AE6","light":"#ADB5BD","dark":"#343A40"},"logo":{"light":"https://mintcdn.com/brilo/MxABbmjUyMnseUhC/logo/light.png?fit=max\u0026auto=format\u0026n=MxABbmjUyMnseUhC\u0026q=85\u0026s=d4d6fb2d6eb070743955e91ad4de3991","dark":"https://mintcdn.com/brilo/pWKPO3fYjsyPFmaW/logo/dark.svg?fit=max\u0026auto=format\u0026n=pWKPO3fYjsyPFmaW\u0026q=85\u0026s=bdc949595db36f3fd5eb662601ca3208"},"favicon":"https://mintcdn.com/brilo/QQo147ZHWnpiYhnW/favicon.svg?fit=max\u0026auto=format\u0026n=QQo147ZHWnpiYhnW\u0026q=85\u0026s=2aada838f7a27240e42ba75002f91501","appearance":{"default":"dark"},"navbar":{"links":[{"href":"mailto:support@brilo.ai","label":"Support"}],"primary":{"type":"button","label":"Get Keys","href":"https://dashboard.brilo.ai/settings/developer/api-keys"}},"footer":{"socials":{"x":"https://x.com/hellobrilo","linkedin":"https://www.linkedin.com/company/brilo"}},"seo":{"metatags":{"og:locale":"en_US","twitter:site":"@hellobrilo"},"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","chatgpt","claude","add-mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://brilo.ai/resources"},{"anchor":"Community","icon":{"style":"brands","name":"discord","library":"fontawesome"},"href":"https://discord.gg/4rjVc2Zt6P"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"brilo","hasAudioNarration":false,"actualSubdomain":"brilo","customDomains":["docs.brilo.ai"],"gitSource":{"type":"github","owner":"briloai","repo":"brilo-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adf421757ec93adba5508c1","collectionId":"0012b6ef-369c-4569-bcbd-75c5677595a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf421757ec93adba5508c1"},"entitlements":{},"buildId":"6ae35c66b905b386f716bd12","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Guides","count":115},{"language":"default","tag":"API Reference","count":51},{"language":"default","tag":"Configure","count":39},{"language":"default","tag":"Agents","count":34},{"language":"default","tag":"Campaigns","count":17},{"language":"default","tag":"Agents and versions","count":16},{"language":"default","tag":"Deploy","count":14},{"language":"default","tag":"Phone numbers","count":13},{"language":"default","tag":"Actions","count":10},{"language":"default","tag":"Endpoints","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"byok-sep-25","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":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agents-public/search-numbers-to-buy","slug":"/api-reference/agents-public/search-numbers-to-buy","pageMetadata":{"title":"Search numbers to buy","description":"Local US and Canadian numbers you can buy now, each with its monthly price. `within_free_allowance` is true when your plan covers it, and then the price is 0.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone_numbers/available","href":"/api-reference/agents-public/search-numbers-to-buy","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Local US and Canadian numbers you can buy now, each with its monthly price. \", _jsx(_components.code, {\n children: \"within_free_allowance\"\n }), \" is true when your plan covers it, and then the price is 0.\"]\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":"Search numbers to buy","description":"Local US and Canadian numbers you can buy now, each with its monthly price. `within_free_allowance` is true when your plan covers it, and then the price is 0.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone_numbers/available","href":"/api-reference/agents-public/search-numbers-to-buy","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Local US and Canadian numbers you can buy now, each with its monthly price. `within_free_allowance` is true when your plan covers it, and then the price is 0.","operationId":"searchAvailablePhoneNumbers","parameters":["eb574636-93db-4317-b21e-422ee4f35ba4","f682a1e4-75cb-454e-8232-581e1e54edc1","238c609b-4be6-4e91-bd0e-8ec68adac215"],"responses":{"200":"b1bff7f8-4bf2-49be-a1e9-6e2a6b064a28","400":"e85f6a22-e6dc-4cfe-bb3b-d6e690c8b181","502":"332eaea7-a8b5-4a19-a142-3aad613cb89d","503":"91d42e7e-5648-4fc9-9086-d180da4af3a8"},"security":["07b5d41b-b956-4937-a16b-b5c3472e5152"],"summary":"Search numbers to buy","tags":["Agents (public)"],"method":"get","type":"path","servers":["0abd13eb-12ec-4ab7-bd7e-251d9efb036d"],"path":"/phone_numbers/available","baseUrlOptions":["https://api.brilo.ai/v1"],"title":"Search numbers to buy","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"eb574636-93db-4317-b21e-422ee4f35ba4":{"description":"Two-letter country code. US and CA are sold.","in":"query","name":"country","required":false,"schema":{"default":"US","description":"Two-letter country code. US and CA are sold.","maxLength":2,"minLength":2,"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"f682a1e4-75cb-454e-8232-581e1e54edc1":{"description":"Only numbers in this area code, for example 512.","in":"query","name":"area_code","required":false,"schema":{"description":"Only numbers in this area code, for example 512.","pattern":"^\\d{3}$","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"238c609b-4be6-4e91-bd0e-8ec68adac215":{"description":"How many numbers to return, at most 30.","in":"query","name":"limit","required":false,"schema":{"default":10,"description":"How many numbers to return, at most 30.","maximum":30,"minimum":1,"type":"integer","isRequired":false,"uniqueKey":"","typeLabel":"integer"}}},"responses":{"b1bff7f8-4bf2-49be-a1e9-6e2a6b064a28":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"data":{"items":{"additionalProperties":false,"properties":{"country":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].country","typeLabel":"string"},"currency":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].currency","typeLabel":"string"},"locality":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].locality.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].locality.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].locality","typeLabel":"string | null"},"monthly_price":{"description":"What the number costs each month. 0 inside your plan allowance.","type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].monthly_price","typeLabel":"number"},"phone_number":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].phone_number","typeLabel":"string"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].region","typeLabel":"string | null"},"within_free_allowance":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].within_free_allowance","typeLabel":"boolean"}},"required":["phone_number","country","locality","region","monthly_price","currency","within_free_allowance"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"country":"\u003cstring>","currency":"\u003cstring>","locality":"\u003cstring>","monthly_price":123,"phone_number":"\u003cstring>","region":"\u003cstring>","within_free_allowance":true}]}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"e85f6a22-e6dc-4cfe-bb3b-d6e690c8b181":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error_code":{"type":"string","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"details":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"details","typeLabel":"object"},"errors":{"items":{"additionalProperties":false,"properties":{"error_code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].error_code","typeLabel":"string"},"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","error_code","message"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"hint":{"type":"string","uniqueKey":"hint","typeLabel":"string"},"next_action":{"additionalProperties":false,"properties":{"method":{"type":"string","isRequired":true,"uniqueKey":"next_action.method","typeLabel":"string"},"path":{"type":"string","isRequired":true,"uniqueKey":"next_action.path","typeLabel":"string"},"tool":{"type":"string","isRequired":true,"uniqueKey":"next_action.tool","typeLabel":"string"},"body":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"next_action.body.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"next_action.body","typeLabel":"object"}},"required":["tool","method","path"],"type":"object","uniqueKey":"next_action","typeLabel":"object"}},"required":["status","error_code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","message":"\u003cstring>","status":0,"details":{},"errors":[{"error_code":"\u003cstring>","field":"\u003cstring>","message":"\u003cstring>"}],"hint":"\u003cstring>","next_action":{"method":"\u003cstring>","path":"\u003cstring>","tool":"\u003cstring>","body":{}}}}},"exampleType":"generated"}},"description":"validation_failed, country_not_supported, toll_free_not_supported","exampleType":"generated"},"332eaea7-a8b5-4a19-a142-3aad613cb89d":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error_code":{"type":"string","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"details":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"details","typeLabel":"object"},"errors":{"items":{"additionalProperties":false,"properties":{"error_code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].error_code","typeLabel":"string"},"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","error_code","message"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"hint":{"type":"string","uniqueKey":"hint","typeLabel":"string"},"next_action":{"additionalProperties":false,"properties":{"method":{"type":"string","isRequired":true,"uniqueKey":"next_action.method","typeLabel":"string"},"path":{"type":"string","isRequired":true,"uniqueKey":"next_action.path","typeLabel":"string"},"tool":{"type":"string","isRequired":true,"uniqueKey":"next_action.tool","typeLabel":"string"},"body":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"next_action.body.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"next_action.body","typeLabel":"object"}},"required":["tool","method","path"],"type":"object","uniqueKey":"next_action","typeLabel":"object"}},"required":["status","error_code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","message":"\u003cstring>","status":0,"details":{},"errors":[{"error_code":"\u003cstring>","field":"\u003cstring>","message":"\u003cstring>"}],"hint":"\u003cstring>","next_action":{"method":"\u003cstring>","path":"\u003cstring>","tool":"\u003cstring>","body":{}}}}},"exampleType":"generated"}},"description":"carrier_unavailable: the number search failed; try again","exampleType":"generated"},"91d42e7e-5648-4fc9-9086-d180da4af3a8":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error_code":{"type":"string","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"details":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"details","typeLabel":"object"},"errors":{"items":{"additionalProperties":false,"properties":{"error_code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].error_code","typeLabel":"string"},"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","error_code","message"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"hint":{"type":"string","uniqueKey":"hint","typeLabel":"string"},"next_action":{"additionalProperties":false,"properties":{"method":{"type":"string","isRequired":true,"uniqueKey":"next_action.method","typeLabel":"string"},"path":{"type":"string","isRequired":true,"uniqueKey":"next_action.path","typeLabel":"string"},"tool":{"type":"string","isRequired":true,"uniqueKey":"next_action.tool","typeLabel":"string"},"body":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"next_action.body.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"next_action.body","typeLabel":"object"}},"required":["tool","method","path"],"type":"object","uniqueKey":"next_action","typeLabel":"object"}},"required":["status","error_code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","message":"\u003cstring>","status":0,"details":{},"errors":[{"error_code":"\u003cstring>","field":"\u003cstring>","message":"\u003cstring>"}],"hint":"\u003cstring>","next_action":{"method":"\u003cstring>","path":"\u003cstring>","tool":"\u003cstring>","body":{}}}}},"exampleType":"generated"}},"description":"billing_unavailable","exampleType":"generated"}},"security":{"07b5d41b-b956-4937-a16b-b5c3472e5152":{"bearerAuth":{"bearerFormat":"JWT","description":"Enter your API key (Bearer token)","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0abd13eb-12ec-4ab7-bd7e-251d9efb036d":{"description":"Production","url":"https://api.brilo.ai/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","description":"Enter your API key (Bearer token)","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Enter your API key (Bearer token)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"brilo","siteName":"Brilo","title":"Search numbers to buy - Brilo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T14:47:21.819Z","originalFileLocation":"api-reference/agents-public/search-numbers-to-buy.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=\"Local US and Canadian numbers you can buy now, each with its monthly price. within_free_allowance is true when your plan covers it, and then the price is 0.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Brilo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_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/brilo/ASd0F1aN8luMwk5v/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search numbers to buy - Brilo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Local US and Canadian numbers you can buy now, each with its monthly price. within_free_allowance is true when your plan covers it, and then the price is 0.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Brilo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://brilo.mintlify.app/_mintlify/api/og/v2?division=Phone+numbers\u0026amp;title=Search+numbers+to+buy\u0026amp;description=Local+US+and+Canadian+numbers+you+can+buy+now%2C+each+with+its+monthly+price.+%60within_free_allowance%60+is+true+when+your+plan+covers+it%2C+and+then+the+price+is+0.\u0026amp;theme=766990d7eeea0701fa1fd69f\u0026amp;signature=749cef28422dca7291a79df048ad0b1ac2279ca79e77e07494b21a023c66ee21\">\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=\"Search numbers to buy - Brilo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Local US and Canadian numbers you can buy now, each with its monthly price. within_free_allowance is true when your plan covers it, and then the price is 0.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://brilo.mintlify.app/_mintlify/api/og/v2?division=Phone+numbers\u0026amp;title=Search+numbers+to+buy\u0026amp;description=Local+US+and+Canadian+numbers+you+can+buy+now%2C+each+with+its+monthly+price.+%60within_free_allowance%60+is+true+when+your+plan+covers+it%2C+and+then+the+price+is+0.\u0026amp;theme=766990d7eeea0701fa1fd69f\u0026amp;signature=749cef28422dca7291a79df048ad0b1ac2279ca79e77e07494b21a023c66ee21\">\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/brilo/ASd0F1aN8luMwk5v/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Brilo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8C7AE6\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents-public/search-numbers-to-buy.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.brilo.ai/#organization\",\"name\":\"Brilo\",\"url\":\"https://docs.brilo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/brilo/MxABbmjUyMnseUhC/logo/light.png?fit=max\u0026auto=format\u0026n=MxABbmjUyMnseUhC\u0026q=85\u0026s=d4d6fb2d6eb070743955e91ad4de3991\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.brilo.ai#website\",\"name\":\"Brilo\",\"url\":\"https://docs.brilo.ai\",\"publisher\":{\"@id\":\"https://docs.brilo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy#webpage\",\"url\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy\",\"name\":\"Search numbers to buy\",\"description\":\"Local US and Canadian numbers you can buy now, each with its monthly price. within_free_allowance is true when your plan covers it, and then the price is 0.\",\"dateModified\":\"2026-10-29T14:47:21.819Z\",\"isPartOf\":{\"@id\":\"https://docs.brilo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.brilo.ai/api-reference/agents/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search numbers to buy\",\"item\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy#apireference\",\"headline\":\"Search numbers to buy\",\"name\":\"Search numbers to buy\",\"description\":\"Local US and Canadian numbers you can buy now, each with its monthly price. within_free_allowance is true when your plan covers it, and then the price is 0.\",\"url\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy\",\"mainEntityOfPage\":{\"@id\":\"https://docs.brilo.ai/api-reference/agents-public/search-numbers-to-buy#webpage\"},\"dateModified\":\"2026-10-29T14:47:21.819Z\",\"publisher\":{\"@id\":\"https://docs.brilo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.brilo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Brilo\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Brilo","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://brilo.ai/resources"},{"anchor":"Community","icon":{"style":"brands","name":"discord","library":"fontawesome"},"href":"https://discord.gg/4rjVc2Zt6P"}]},"tabs":[{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","icon":"code-xml","groups":[{"group":"Endpoints","icon":"code-xml","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":null,"href":"/api-reference/endpoint/agent-builder"},{"title":"Call","href":"/api-reference/endpoint/call"},{"title":null,"href":"/api-reference/endpoint/call-tag"},{"title":null,"href":"/api-reference/endpoint/campaign"},{"title":null,"href":"/api-reference/endpoint/contact"},{"title":null,"href":"/api-reference/endpoint/custom-field"},{"title":null,"href":"/api-reference/endpoint/memory"},{"title":null,"href":"/api-reference/endpoint/list"},{"title":null,"href":"/api-reference/endpoint/voice"}]},{"group":"Agents","icon":"bot","pages":[{"title":"Change an agent through the API","href":"/api-reference/agents/quickstart"},{"title":"Versions are branches","href":"/api-reference/agents/versions"},{"title":"Buy and release phone numbers through the API","href":"/api-reference/agents/phone-numbers"},{"group":"Agents and versions","icon":"bot","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents-public/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents-public/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}","href":"/api-reference/agents-public/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{id}","href":"/api-reference/agents-public/update-an-agent"},{"title":"Publish an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/publish","href":"/api-reference/agents-public/publish-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{id}","href":"/api-reference/agents-public/delete-an-agent"},{"title":"List versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/versions","href":"/api-reference/agents-public/list-versions"},{"title":"Create a version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/versions","href":"/api-reference/agents-public/create-a-version"},{"title":"Get a version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/versions/{vid}","href":"/api-reference/agents-public/get-a-version"},{"title":"Update a version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{id}/versions/{vid}","href":"/api-reference/agents-public/update-a-version"},{"title":"Discard a draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{id}/versions/{vid}/draft","href":"/api-reference/agents-public/discard-a-draft"},{"title":"Publish a version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/versions/{vid}/publish","href":"/api-reference/agents-public/publish-a-version"},{"title":"Make a version live","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/versions/{vid}/go_live","href":"/api-reference/agents-public/make-a-version-live"},{"title":"List commits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/versions/{vid}/history","href":"/api-reference/agents-public/list-commits"},{"title":"Restore a commit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/versions/{vid}/restore","href":"/api-reference/agents-public/restore-a-commit"},{"title":"Delete a version","description":"Deletes a version that is not live, with its draft and commits.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{id}/versions/{vid}","href":"/api-reference/agents-public/delete-a-version"}]},{"group":"Phone numbers","icon":"phone","pages":[{"title":"Search numbers to buy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone_numbers/available","href":"/api-reference/agents-public/search-numbers-to-buy"},{"title":"Buy a phone number","description":"Buys a number from search for its monthly price. `accept_monthly_price` must equal the current price, so nothing is bought at a price the owner did not see. Answers 202 with `status: provisioning` and an id that stays the same once the number is active; poll it, or pass `?wait=` seconds (at most 30). With `agent_id` the number answers for that agent once active. At most 5 a day per workspace through the API; paired-assistant keys cannot buy.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /phone_numbers","href":"/api-reference/agents-public/buy-a-phone-number"},{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone_numbers","href":"/api-reference/agents-public/list-phone-numbers"},{"title":"Get a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone_numbers/{id}","href":"/api-reference/agents-public/get-a-phone-number"},{"title":"Keep a number set to be released","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /phone_numbers/{id}","href":"/api-reference/agents-public/keep-a-number-set-to-be-released"},{"title":"Release a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /phone_numbers/{id}","href":"/api-reference/agents-public/release-a-phone-number"},{"title":"List an agent's phone numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/phone_numbers","href":"/api-reference/agents-public/list-an-agents-phone-numbers"},{"title":"Attach phone numbers to an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/phone_numbers/attach","href":"/api-reference/agents-public/attach-phone-numbers-to-an-agent"},{"title":"Detach phone numbers from an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/phone_numbers/detach","href":"/api-reference/agents-public/detach-phone-numbers-from-an-agent"}]},{"group":"Share links","icon":"link","pages":[{"title":"Share Links","href":"/api-reference/endpoint/share-link"},{"title":"Create a share link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/{agent_id}/share-link","href":"/api-reference/share-links/create-a-share-link"},{"title":"Get an agent's share link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent/{agent_id}/share-link","href":"/api-reference/share-links/get-an-agents-share-link"},{"title":"Update a share link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agent/{agent_id}/share-link/{link_id}","href":"/api-reference/share-links/update-a-share-link"},{"title":"Replace a share link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/{agent_id}/share-link/{link_id}/regenerate","href":"/api-reference/share-links/replace-a-share-link"},{"title":"Turn off a share link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agent/{agent_id}/share-link/{link_id}","href":"/api-reference/share-links/turn-off-a-share-link"}]}]},{"group":"MCP server","icon":"unplug","pages":[{"title":"Brilo MCP server","href":"/api-reference/mcp/overview"},{"title":"Connect an MCP client","href":"/api-reference/mcp/connect"},{"title":"MCP tools","href":"/api-reference/mcp/tools"}]},{"group":"Agent pairing","icon":"smartphone","pages":[{"title":"Start pairing this assistant with a Brilo phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/onboarding/start","href":"/api-reference/agent-pairing/start-pairing-this-assistant-with-a-brilo-phone-number"},{"title":"Check whether the user has finished, and collect the API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent/onboarding/poll","href":"/api-reference/agent-pairing/check-whether-the-user-has-finished-and-collect-the-api-key"},{"title":"How much of the plan is left right now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /usage","href":"/api-reference/usage/how-much-of-the-plan-is-left-right-now"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Post-Call Webhook","href":"/api-reference/webhooks/post-call"}]}]},{"tab":"Integrations","icon":"unplug","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Search numbers to buy - Brilo","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}