{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Sendo","colors":{"primary":"#30B2E3","light":"#EBF7FD","dark":"#222222"},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/winno/tzmbI69cVq0zXOlX/logo/light.png?fit=max\u0026auto=format\u0026n=tzmbI69cVq0zXOlX\u0026q=85\u0026s=f409898703163a5aacfe9831eb13e54b","dark":"https://mintcdn.com/winno/tzmbI69cVq0zXOlX/logo/dark.png?fit=max\u0026auto=format\u0026n=tzmbI69cVq0zXOlX\u0026q=85\u0026s=f376aacbe9796f6858e72819bf223bf4"},"api":{"mdx":{"server":"https://api.sendo.dev/v1/","auth":{"method":"bearer","name":null}}},"background":{"decoration":null,"color":{"light":null,"dark":"#0a0a0a"}},"navbar":{"links":[{"label":"Support","href":"mailto:support@sendo.dev"}],"primary":{"type":"button","label":"Dashboard","href":"https://sendo.dev/dashboard"}},"footer":{"socials":{"twitter":"https://twitter.com/usewinno","linkedin":"https://www.linkedin.com/company/usewinno"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"winno","hasAudioNarration":false,"actualSubdomain":"winno","customDomains":["docs.sendo.dev"],"gitSource":{"type":"github","owner":"winno-inc","repo":"sendo-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21c923633bafcd4b6530a2","collectionId":"d2e30d28-97ad-4f0f-ac0d-86b8578a626d","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21c923633bafcd4b6530a2:success","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":35},{"language":"default","tag":"Knowledge Base","count":17},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Campaign","count":6},{"language":"default","tag":"Registrations","count":5},{"language":"default","tag":"Number","count":4},{"language":"default","tag":"Brand","count":3},{"language":"default","tag":"Message","count":3},{"language":"default","tag":"Webhook","count":3},{"language":"default","tag":"Compliance","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/number/retrieve","slug":"/api-reference/number/retrieve","pageMetadata":{"title":"Retrieve number","api":"GET https://api.sendo.dev/v1/number/{number}","description":"Get details for a phone number.","href":"/api-reference/number/retrieve"},"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: \"Get details for a phone number.\"\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={code:`code`,p:`p`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(ParamField,{path:`number`,type:`string`,required:true,id:`param-number`,children:_jsxs(_components.p,{children:[`Phone number to retrieve (with country code) e.g. `,_jsx(_components.code,{children:`14157271367`})]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`number`,type:`object`,id:`param-number-1`,children:[_jsx(_components.p,{children:`The details of the phone number.`}),_jsxs(Expandable,{title:`number fields`,children:[_jsx(ResponseField,{name:`phoneNumber`,type:`string`,id:`param-phone-number`,children:_jsx(_components.p,{children:`The phone number in E.164 format.`})}),_jsx(ResponseField,{name:`campaignId`,type:`string`,id:`param-campaign-id`,children:_jsx(_components.p,{children:`The ID of the associated campaign.`})}),_jsx(ResponseField,{name:`isDefault`,type:`boolean`,id:`param-is-default`,children:_jsx(_components.p,{children:`Whether the number is default for the campaign.`})}),_jsxs(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:[_jsx(_components.p,{children:`The status of the phone number.`}),_jsxs(Expandable,{title:`number statuses`,children:[_jsx(ResponseField,{name:`PENDING`,type:`string`,id:`param-pending`,children:_jsx(_components.p,{children:`The number is waiting for provisioning.`})}),_jsx(ResponseField,{name:`ACTIVE`,type:`string`,id:`param-active`,children:_jsx(_components.p,{children:`The phone number is fully active.`})}),_jsx(ResponseField,{name:`DELETED`,type:`string`,id:`param-deleted`,children:_jsx(_components.p,{children:`The phone number has been deleted.`})})]})]}),_jsx(ResponseField,{name:`forwardNumber`,type:`boolean`,id:`param-forward-number`,children:_jsx(_components.p,{children:`Phone number for call forwarding (optional).`})}),_jsx(ResponseField,{name:`forwardEnabled`,type:`boolean`,id:`param-forward-enabled`,children:_jsx(_components.p,{children:`Whether call forwarding is enabled.`})}),_jsx(ResponseField,{name:`formattedNumber`,type:`string`,id:`param-formatted-number`,children:_jsx(_components.p,{children:`The phone number formatted for display.`})}),_jsx(ResponseField,{name:`monthlyPrice`,type:`number`,id:`param-monthly-price`,children:_jsx(_components.p,{children:`Monthly price of the number (in dollars).`})}),_jsx(ResponseField,{name:`purchasedAt`,type:`timestamp`,id:`param-purchased-at`,children:_jsx(_components.p,{children:`Time at which the number was purchased.`})})]})]}),`\n`,_jsx(ResponseField,{name:`error`,type:`string`,id:`param-error`,children:_jsx(_components.p,{children:`Error message if the request fails.`})})]})}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":"Retrieve number","api":"GET https://api.sendo.dev/v1/number/{number}","description":"Get details for a phone number.","href":"/api-reference/number/retrieve"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(ParamField,{path:`number`,type:`string`,required:true,id:`param-number`,children:_jsxs(_components.p,{children:[`Phone number to retrieve (with country code) e.g. `,_jsx(_components.code,{children:`14157271367`})]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`number`,type:`object`,id:`param-number-1`,children:[_jsx(_components.p,{children:`The details of the phone number.`}),_jsxs(Expandable,{title:`number fields`,children:[_jsx(ResponseField,{name:`phoneNumber`,type:`string`,id:`param-phone-number`,children:_jsx(_components.p,{children:`The phone number in E.164 format.`})}),_jsx(ResponseField,{name:`campaignId`,type:`string`,id:`param-campaign-id`,children:_jsx(_components.p,{children:`The ID of the associated campaign.`})}),_jsx(ResponseField,{name:`isDefault`,type:`boolean`,id:`param-is-default`,children:_jsx(_components.p,{children:`Whether the number is default for the campaign.`})}),_jsxs(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:[_jsx(_components.p,{children:`The status of the phone number.`}),_jsxs(Expandable,{title:`number statuses`,children:[_jsx(ResponseField,{name:`PENDING`,type:`string`,id:`param-pending`,children:_jsx(_components.p,{children:`The number is waiting for provisioning.`})}),_jsx(ResponseField,{name:`ACTIVE`,type:`string`,id:`param-active`,children:_jsx(_components.p,{children:`The phone number is fully active.`})}),_jsx(ResponseField,{name:`DELETED`,type:`string`,id:`param-deleted`,children:_jsx(_components.p,{children:`The phone number has been deleted.`})})]})]}),_jsx(ResponseField,{name:`forwardNumber`,type:`boolean`,id:`param-forward-number`,children:_jsx(_components.p,{children:`Phone number for call forwarding (optional).`})}),_jsx(ResponseField,{name:`forwardEnabled`,type:`boolean`,id:`param-forward-enabled`,children:_jsx(_components.p,{children:`Whether call forwarding is enabled.`})}),_jsx(ResponseField,{name:`formattedNumber`,type:`string`,id:`param-formatted-number`,children:_jsx(_components.p,{children:`The phone number formatted for display.`})}),_jsx(ResponseField,{name:`monthlyPrice`,type:`number`,id:`param-monthly-price`,children:_jsx(_components.p,{children:`Monthly price of the number (in dollars).`})}),_jsx(ResponseField,{name:`purchasedAt`,type:`timestamp`,id:`param-purchased-at`,children:_jsx(_components.p,{children:`Time at which the number was purchased.`})})]})]}),`\n`,_jsx(ResponseField,{name:`error`,type:`string`,id:`param-error`,children:_jsx(_components.p,{children:`Error message if the request fails.`})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`Success`,numberOfLines:`13`,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:`13`,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:` \"number\"`}),_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:` \"phoneNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+14157271367\"`}),_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:` \"campaignId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"U7fQ39nA\"`}),_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:` \"isDefault\"`}),_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:` \"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:` \"forwardNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_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:` \"forwardEnabled\"`}),_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:` \"formattedNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"(415) 727-1367\"`}),_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:` \"monthlyPrice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_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:` \"purchasedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2023-09-21T00:42:01.013Z\"`})]}),`\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`]})})}),_jsx(CodeBlock,{filename:`Error`,numberOfLines:`3`,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:`3`,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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Number not found\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\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":"Retrieve number","api":"GET https://api.sendo.dev/v1/number/{number}","description":"Get details for a phone number.","href":"/api-reference/number/retrieve"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Success","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"phoneNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"+14157271367\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"campaignId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"U7fQ39nA\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"isDefault\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ACTIVE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"forwardNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"forwardEnabled\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"formattedNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"(415) 727-1367\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"monthlyPrice\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"purchasedAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2023-09-21T00:42:01.013Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Error","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Number not found\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Retrieve number","path":"/v1/number/{number}","servers":[{"url":"https://api.sendo.dev"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"number":{"schema":[{"type":"string","description":"Phone number to retrieve (with country code) e.g. `14157271367`","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"number":[{"type":"object","properties":{"phoneNumber":[{"type":"string","description":"The phone number in E.164 format."}],"campaignId":[{"type":"string","description":"The ID of the associated campaign."}],"isDefault":[{"type":"boolean","description":"Whether the number is default for the campaign."}],"status":[{"type":"string","description":"The status of the phone number."}],"forwardNumber":[{"type":"boolean","description":"Phone number for call forwarding (optional)."}],"forwardEnabled":[{"type":"boolean","description":"Whether call forwarding is enabled."}],"formattedNumber":[{"type":"string","description":"The phone number formatted for display."}],"monthlyPrice":[{"type":"number","description":"Monthly price of the number (in dollars)."}],"purchasedAt":[{"type":"object","properties":{},"description":"Time at which the number was purchased."}]},"description":"The details of the phone number."}],"error":[{"type":"string","description":"Error message if the request fails."}]}}],"examples":{"example":{"value":{"number":{"phoneNumber":"\u003cstring>","campaignId":"\u003cstring>","isDefault":true,"status":"\u003cstring>","forwardNumber":true,"forwardEnabled":true,"formattedNumber":"\u003cstring>","monthlyPrice":123,"purchasedAt":{}},"error":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"winno","siteName":"Sendo","title":"Retrieve number - Sendo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T23:44:23.758Z","originalFileLocation":"api-reference/number/retrieve.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get details for a phone number.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sendo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_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/winno/W0yqjplxwklRlTq3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve number - Sendo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get details for a phone number.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sendo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sendo.dev/api-reference/number/retrieve\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://winno.mintlify.app/_mintlify/api/og/v2?division=Number\u0026amp;title=Retrieve+number\u0026amp;description=Get+details+for+a+phone+number.\u0026amp;theme=b1059a098190172a140d9d9c\u0026amp;signature=8a3ad56cff8c1838408356f48578e6d1e5202894d89594f6c1ba8eb5fc956aa3\">\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=\"Retrieve number - Sendo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get details for a phone number.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://winno.mintlify.app/_mintlify/api/og/v2?division=Number\u0026amp;title=Retrieve+number\u0026amp;description=Get+details+for+a+phone+number.\u0026amp;theme=b1059a098190172a140d9d9c\u0026amp;signature=8a3ad56cff8c1838408356f48578e6d1e5202894d89594f6c1ba8eb5fc956aa3\">\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/winno/W0yqjplxwklRlTq3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sendo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#30B2E3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sendo.dev/api-reference/number/retrieve\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/number/retrieve.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sendo.dev/#organization\",\"name\":\"Sendo\",\"url\":\"https://docs.sendo.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/winno/tzmbI69cVq0zXOlX/logo/light.png?fit=max\u0026auto=format\u0026n=tzmbI69cVq0zXOlX\u0026q=85\u0026s=f409898703163a5aacfe9831eb13e54b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sendo.dev#website\",\"name\":\"Sendo\",\"url\":\"https://docs.sendo.dev\",\"publisher\":{\"@id\":\"https://docs.sendo.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sendo.dev/api-reference/number/retrieve#webpage\",\"url\":\"https://docs.sendo.dev/api-reference/number/retrieve\",\"name\":\"Retrieve number\",\"description\":\"Get details for a phone number.\",\"dateModified\":\"2026-01-06T23:44:23.758Z\",\"isPartOf\":{\"@id\":\"https://docs.sendo.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sendo.dev/api-reference/number/retrieve#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sendo.dev/api-reference/number/retrieve#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Number\",\"item\":\"https://docs.sendo.dev/api-reference/number/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve number\",\"item\":\"https://docs.sendo.dev/api-reference/number/retrieve\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sendo.dev/api-reference/number/retrieve#apireference\",\"headline\":\"Retrieve number\",\"name\":\"Retrieve number\",\"description\":\"Get details for a phone number.\",\"url\":\"https://docs.sendo.dev/api-reference/number/retrieve\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sendo.dev/api-reference/number/retrieve#webpage\"},\"dateModified\":\"2026-01-06T23:44:23.758Z\",\"publisher\":{\"@id\":\"https://docs.sendo.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sendo.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sendo\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sendo","nav":{"global":null,"anchors":[{"anchor":"API Reference","icon":"rectangle-terminal","groups":[{"group":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"MMS Messaging","sidebarTitle":"Sending MMS","href":"/api-reference/media"},{"title":"Sending vCards","sidebarTitle":"Contact cards","href":"/api-reference/vcards"},{"title":"Multiple senders","sidebarTitle":"Multiple senders","href":"/api-reference/senders"},{"title":"Errors","sidebarTitle":"Error codes","href":"/api-reference/errors"},{"title":"Carrier limits","sidebarTitle":"Carrier limits","href":"/api-reference/limits"},{"title":"Custom metadata","sidebarTitle":"Metadata","href":"/api-reference/metadata"}]},{"group":"Message","pages":[{"title":"Send message","api":"POST https://api.sendo.dev/v1/message/send","href":"/api-reference/message/send"},{"title":"Retrieve message","api":"GET https://api.sendo.dev/v1/message/{id}","href":"/api-reference/message/retrieve"},{"title":"List messages","api":"GET https://api.sendo.dev/v1/message/list","href":"/api-reference/message/list"}]},{"group":"Brand","pages":[{"title":"Create brand","api":"POST https://api.sendo.dev/v1/brand/create","href":"/api-reference/brand/create"},{"title":"Retrieve brand","api":"GET https://api.sendo.dev/v1/brand/{id}","href":"/api-reference/brand/retrieve"},{"title":"List brands","api":"GET https://api.sendo.dev/v1/brand/list","href":"/api-reference/brand/list"}]},{"group":"Campaign","pages":[{"title":"Create campaign","api":"POST https://api.sendo.dev/v1/campaign/create","href":"/api-reference/campaign/create"},{"title":"Retrieve campaign","api":"GET https://api.sendo.dev/v1/campaign/{id}","href":"/api-reference/campaign/retrieve"},{"title":"List campaigns","api":"GET https://api.sendo.dev/v1/campaign/list","href":"/api-reference/campaign/list"},{"title":"Create webhook","api":"POST https://api.sendo.dev/v1/campaign/{id}/webhooks","href":"/api-reference/campaign/create-webhook"},{"title":"List webhooks","api":"GET https://api.sendo.dev/v1/campaign/{id}/webhooks","href":"/api-reference/campaign/webhooks"},{"title":"List numbers","api":"GET https://api.sendo.dev/v1/campaign/{id}/numbers","href":"/api-reference/campaign/numbers"}]},{"group":"Number","pages":[{"title":"Search numbers","api":"GET https://api.sendo.dev/v1/number/search","href":"/api-reference/number/search"},{"title":"Buy number","api":"POST https://api.sendo.dev/v1/number/buy","description":"Purchase a number for a campaign.","href":"/api-reference/number/buy"},{"title":"Retrieve number","api":"GET https://api.sendo.dev/v1/number/{number}","href":"/api-reference/number/retrieve"},{"title":"Set forwarding","api":"PATCH https://api.sendo.dev/v1/number/{number}/forwarding","description":"Update call forwarding for a number.","href":"/api-reference/number/forward"}]},{"group":"Webhook","pages":[{"title":"Retrieve webhook","api":"GET https://api.sendo.dev/v1/webhook/{id}","href":"/api-reference/webhook/retrieve"},{"title":"Update webhook","api":"PATCH https://api.sendo.dev/v1/webhook/{id}","href":"/api-reference/webhook/update"},{"title":"Delete webhook","api":"DELETE https://api.sendo.dev/v1/webhook/{id}","href":"/api-reference/webhook/delete"}]}]},{"anchor":"Knowledge Base","icon":"books","pages":[{"title":"Knowledge Base","href":"/knowledge-base/overview"}]},{"anchor":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/changelog"}]},{"anchor":"RCS Support","icon":"message-dots","pages":[{"title":"RCS Support","href":"/rcs/upcoming"}]},{"anchor":"API Status","href":"https://status.sendo.dev","icon":"signal-bars"}]},"basePath":"","title":"Retrieve number - Sendo","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js"]}