OptimalDial API key, prefixed od_live_, sent as Authorization: Bearer ....
Mint keys in the in-app developer panel; they are scoped to a single organization.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OptimalDial","colors":{"primary":"#0a0436"},"logo":{"light":"https://mintcdn.com/neeloptimaldialcom/0TTegglm6A11jkFF/logo/light.svg?fit=max\u0026auto=format\u0026n=0TTegglm6A11jkFF\u0026q=85\u0026s=ae33049d862b1b21cb9361bbcf855ebb","dark":"https://mintcdn.com/neeloptimaldialcom/0TTegglm6A11jkFF/logo/dark.svg?fit=max\u0026auto=format\u0026n=0TTegglm6A11jkFF\u0026q=85\u0026s=dc5af00025e85e5271eb42b8d6147b05","href":"https://docs.optimaldial.com"},"favicon":"https://mintcdn.com/neeloptimaldialcom/0TTegglm6A11jkFF/favicon.ico?fit=max\u0026auto=format\u0026n=0TTegglm6A11jkFF\u0026q=85\u0026s=9604492a61cdf83fc172f3ba6e9603a3","navbar":{"primary":{"type":"button","label":"Open app","href":"https://app.optimaldial.com"}},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"neeloptimaldialcom","hasAudioNarration":false,"actualSubdomain":"neeloptimaldialcom","customDomains":["docs.optimaldial.com"],"gitSource":{"type":"github","owner":"neel-rawlani","repo":"optimaldial-app","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aaa2c98e06921fec696e81c","collectionId":"148b4a30-79e6-4443-bda8-ecb5f4693344","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aaa2c98e06921fec696e81c"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aaa2c98e06921fec696e81c","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"spam","count":8},{"language":"default","tag":"contacts","count":6},{"language":"default","tag":"uploads","count":6},{"language":"default","tag":"webhooks","count":6},{"language":"default","tag":"Endpoint guides","count":5},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Resources","count":2},{"language":"default","tag":"Webhooks","count":2},{"language":"default","tag":"credits","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"editor-nav-generations","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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"endpoints/spam/retrieve-a-monitored-number","slug":"/endpoints/spam/retrieve-a-monitored-number","pageMetadata":{"title":"Retrieve a monitored number","description":null,"deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/spam/numbers/{number_id}","href":"/endpoints/spam/retrieve-a-monitored-number","autogeneratedByOpenApi":true},"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":"Retrieve a monitored number","description":null,"deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/spam/numbers/{number_id}","href":"/endpoints/spam/retrieve-a-monitored-number","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["spam"],"summary":"Retrieve a monitored number","operationId":"getMonitoredNumber","responses":{"200":"0e6ae2df-0a2c-46c2-9ca3-11c6ffa4c15f","401":"e62d4bfc-3b9e-47a7-99ef-0689589e1143","403":"81e5add3-adda-4427-9b63-ca95867d40a4","404":"137853f1-6495-428b-b753-e55265361f0c","429":"37963c03-8cf1-4d4c-ae14-73d349c225f5"},"method":"get","type":"path","servers":["a9a380bc-2e8e-4e03-961e-d527e5f51a4e"],"security":["a15c37a2-8163-4b8c-96ef-64e57d0723da"],"path":"/api/v1/spam/numbers/{number_id}","baseUrlOptions":["https://api.optimaldial.com"],"title":"Retrieve a monitored number","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6e79b537-1ae2-411a-9d9f-9bdc3f4a36ae":{"in":"path","name":"number_id","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"0e6ae2df-0a2c-46c2-9ca3-11c6ffa4c15f":{"description":"The number and its latest per-carrier status.","content":{"application/json":{"schema":{"type":"object","required":["id","phone_number","verified","same_carrier_warning","status","created_at","carrier_statuses"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"phone_number":{"type":"string","description":"E.164-normalized phone number (US/CA only).","example":"+15551234567","isRequired":true,"uniqueKey":"phone_number","typeLabel":"string"},"verified":{"type":"boolean","description":"Whether the number has completed verification. Monitoring\nonly runs for verified numbers.\n","isRequired":true,"uniqueKey":"verified","typeLabel":"boolean"},"same_carrier_warning":{"type":"boolean","description":"`true` when a test was run from the same carrier as the monitored\nnumber, which can skew the spam result. Treat such results with care.\n","isRequired":true,"uniqueKey":"same_carrier_warning","typeLabel":"boolean"},"status":{"type":"string","enum":["active","paused"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"carrier_statuses":{"type":"array","description":"Latest status for each carrier OptimalDial tests against.","items":{"type":"object","required":["carrier","status","screenshot_available"],"properties":{"carrier":{"type":"string","description":"Carrier this row applies to (e.g. `at\u0026t`, `t-mobile`, `verizon`).","isRequired":true,"uniqueKey":"carrier_statuses.items.[INDEX].carrier","typeLabel":"string"},"status":{"type":"string","enum":["pending","running","completed","failed"],"isRequired":true,"uniqueKey":"carrier_statuses.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"screenshot_available":{"type":"boolean","description":"Whether a screenshot can be fetched for this carrier's latest run.","isRequired":true,"uniqueKey":"carrier_statuses.items.[INDEX].screenshot_available","typeLabel":"boolean"},"spam_detected":{"oneOf":[{"type":"boolean","description":"Whether the number was flagged as spam/scam-likely on this carrier.\n`null` until the latest run completes.\n","uniqueKey":"carrier_statuses.items.[INDEX].spam_detected.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the number was flagged as spam/scam-likely on this carrier.\n`null` until the latest run completes.\n","uniqueKey":"carrier_statuses.items.[INDEX].spam_detected.oneOf.1","typeLabel":"null"}],"uniqueKey":"carrier_statuses.items.[INDEX].spam_detected","typeLabel":"boolean | null"},"spam_label":{"oneOf":[{"type":"string","description":"The carrier-displayed label (e.g. `\"Scam Likely\"`), when flagged.","uniqueKey":"carrier_statuses.items.[INDEX].spam_label.oneOf.0","typeLabel":"string"},{"type":"null","description":"The carrier-displayed label (e.g. `\"Scam Likely\"`), when flagged.","uniqueKey":"carrier_statuses.items.[INDEX].spam_label.oneOf.1","typeLabel":"null"}],"uniqueKey":"carrier_statuses.items.[INDEX].spam_label","typeLabel":"string | null"},"test_run_id":{"oneOf":[{"type":"string","uniqueKey":"carrier_statuses.items.[INDEX].test_run_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"carrier_statuses.items.[INDEX].test_run_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"carrier_statuses.items.[INDEX].test_run_id","typeLabel":"string | null"},"captured_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"carrier_statuses.items.[INDEX].captured_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"carrier_statuses.items.[INDEX].captured_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"carrier_statuses.items.[INDEX].captured_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"carrier_statuses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"carrier_statuses","typeLabel":"object[]"},"carrier":{"oneOf":[{"type":"string","description":"The number's own carrier, when known. Used to flag same-carrier tests.","uniqueKey":"carrier.oneOf.0","typeLabel":"string"},{"type":"null","description":"The number's own carrier, when known. Used to flag same-carrier tests.","uniqueKey":"carrier.oneOf.1","typeLabel":"null"}],"uniqueKey":"carrier","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","phone_number":"+15551234567","verified":true,"same_carrier_warning":true,"status":"active","created_at":"2023-11-07T05:31:56Z","carrier_statuses":[{"carrier":"\u003cstring>","status":"pending","screenshot_available":true,"spam_detected":true,"spam_label":"\u003cstring>","test_run_id":"\u003cstring>","captured_at":"2023-11-07T05:31:56Z"}],"carrier":"\u003cstring>","updated_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"e62d4bfc-3b9e-47a7-99ef-0689589e1143":{"description":"Missing or invalid API key.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Bearer"}}},"content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"81e5add3-adda-4427-9b63-ca95867d40a4":{"description":"No active subscription on the organization.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"137853f1-6495-428b-b753-e55265361f0c":{"description":"Resource not found, or not visible to this API key's organization.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"37963c03-8cf1-4d4c-ae14-73d349c225f5":{"description":"A rate-limit bucket was exhausted (per-key, per-org, or the system-wide ceiling). See the `scope` field.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"The per-minute limit for the scope that was exceeded."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Tokens remaining in that bucket (0 on a 429)."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until at least one token is available again."}},"content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"type":"object","required":["error","scope","limit","retry_after_seconds"],"properties":{"error":{"type":"string","enum":["rate_limit_exceeded"],"isRequired":true,"uniqueKey":"detail.error","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["per_key","per_org","global"],"description":"Which limit was hit: the per-API-key cap, the per-organization cap, or the system-wide ceiling.","isRequired":true,"uniqueKey":"detail.scope","typeLabel":"enum\u003cstring>"},"limit":{"type":"integer","description":"The per-minute limit for the scope that was exceeded.","isRequired":true,"uniqueKey":"detail.limit","typeLabel":"integer"},"retry_after_seconds":{"type":"integer","description":"Seconds to wait before retrying (also returned as the Retry-After header).","isRequired":true,"uniqueKey":"detail.retry_after_seconds","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"detail","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":{"error":"rate_limit_exceeded","scope":"per_key","limit":123,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a15c37a2-8163-4b8c-96ef-64e57d0723da":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"od_live_xxxxxxxx","description":"OptimalDial API key, prefixed `od_live_`, sent as `Authorization: Bearer ...`.\nMint keys in the in-app developer panel; they are scoped to a single organization.\n","scopes":[]}}},"servers":{"a9a380bc-2e8e-4e03-961e-d527e5f51a4e":{"url":"https://api.optimaldial.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"od_live_xxxxxxxx","description":"OptimalDial API key, prefixed `od_live_`, sent as `Authorization: Bearer ...`.\nMint keys in the in-app developer panel; they are scoped to a single organization.\n","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OptimalDial API key, prefixed `od_live_`, sent as `Authorization: Bearer ...`.\nMint keys in the in-app developer panel; they are scoped to a single organization.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.optimaldial.com/openapi/v1/spec.yaml"},"subdomain":"neeloptimaldialcom","siteName":"OptimalDial","title":"Retrieve a monitored number - OptimalDial","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T05:44:04.216Z","originalFileLocation":"endpoints/spam/retrieve-a-monitored-number.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"OptimalDial\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_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/neeloptimaldialcom/uXVieaPmn4jALVLf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a monitored number - OptimalDial\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OptimalDial\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://neeloptimaldialcom.mintlify.app/_mintlify/api/og/v2?division=spam\u0026amp;title=Retrieve+a+monitored+number\u0026amp;theme=cf3bc0346dc51be3d8e8f822\u0026amp;signature=be80a8dc5782038dbe9b3e7793fb187b6da8be3896907a3a501818fa35457068\">\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 a monitored number - OptimalDial\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://neeloptimaldialcom.mintlify.app/_mintlify/api/og/v2?division=spam\u0026amp;title=Retrieve+a+monitored+number\u0026amp;theme=cf3bc0346dc51be3d8e8f822\u0026amp;signature=be80a8dc5782038dbe9b3e7793fb187b6da8be3896907a3a501818fa35457068\">\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/neeloptimaldialcom/uXVieaPmn4jALVLf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OptimalDial\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0a0436\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoints/spam/retrieve-a-monitored-number.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.optimaldial.com/#organization\",\"name\":\"OptimalDial\",\"url\":\"https://docs.optimaldial.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/neeloptimaldialcom/0TTegglm6A11jkFF/logo/light.svg?fit=max\u0026auto=format\u0026n=0TTegglm6A11jkFF\u0026q=85\u0026s=ae33049d862b1b21cb9361bbcf855ebb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.optimaldial.com#website\",\"name\":\"OptimalDial\",\"url\":\"https://docs.optimaldial.com\",\"publisher\":{\"@id\":\"https://docs.optimaldial.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number#webpage\",\"url\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number\",\"name\":\"Retrieve a monitored number\",\"dateModified\":\"2026-09-16T05:44:04.216Z\",\"isPartOf\":{\"@id\":\"https://docs.optimaldial.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.optimaldial.com/endpoints/uploads/list-uploads\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"spam\",\"item\":\"https://docs.optimaldial.com/endpoints/spam/list-monitored-numbers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve a monitored number\",\"item\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number#apireference\",\"headline\":\"Retrieve a monitored number\",\"name\":\"Retrieve a monitored number\",\"url\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number\",\"mainEntityOfPage\":{\"@id\":\"https://docs.optimaldial.com/endpoints/spam/retrieve-a-monitored-number#webpage\"},\"dateModified\":\"2026-09-16T05:44:04.216Z\",\"publisher\":{\"@id\":\"https://docs.optimaldial.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.optimaldial.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OptimalDial\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OptimalDial","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Introduction","href":"/index"},{"title":"Getting started","href":"/getting-started"},{"title":"Authentication","href":"/authentication"}]},{"group":"Endpoint guides","pages":[{"title":"Uploads","href":"/api-reference/uploads"},{"title":"Contacts","href":"/api-reference/contacts"},{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"Spam monitoring","href":"/api-reference/spam-monitoring"},{"title":"Credit balance","href":"/api-reference/credit-balance"}]},{"group":"Webhooks","pages":[{"title":"Receiving webhooks","href":"/guides/webhooks"},{"title":"Errors and rate limits","href":"/guides/errors-and-rate-limits"}]},{"group":"API Reference","pages":[{"group":"uploads","pages":[{"title":"List uploads","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/uploads","href":"/endpoints/uploads/list-uploads"},{"title":"Create an upload","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v1/uploads","href":"/endpoints/uploads/create-an-upload"},{"title":"Retrieve an upload","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/uploads/{upload_id}","href":"/endpoints/uploads/retrieve-an-upload"},{"title":"Get a signed download URL for the original submitted file","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/uploads/{upload_id}/download/original","href":"/endpoints/uploads/get-a-signed-download-url-for-the-original-submitted-file"},{"title":"Get a signed download URL for the processed file","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/uploads/{upload_id}/download/processed","href":"/endpoints/uploads/get-a-signed-download-url-for-the-processed-file"},{"title":"Get a signed download URL for the \"likely answer only\" filtered file","deprecated":true,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/uploads/{upload_id}/download/processed-filtered","href":"/endpoints/uploads/get-a-signed-download-url-for-the-\"likely-answer-only\"-filtered-file"}]},{"group":"webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/webhooks","href":"/endpoints/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v1/webhooks","href":"/endpoints/webhooks/create-a-webhook-endpoint"},{"title":"Retrieve a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/webhooks/{webhook_id}","href":"/endpoints/webhooks/retrieve-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml delete /api/v1/webhooks/{webhook_id}","href":"/endpoints/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml patch /api/v1/webhooks/{webhook_id}","href":"/endpoints/webhooks/update-a-webhook-endpoint"},{"title":"List recent deliveries for a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/webhooks/{webhook_id}/deliveries","href":"/endpoints/webhooks/list-recent-deliveries-for-a-webhook-endpoint"}]},{"group":"contacts","pages":[{"title":"List contacts (legacy — no identity)","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/contacts","href":"/endpoints/contacts/list-contacts-legacy-—-no-identity"},{"title":"Create a contact (legacy — no identity)","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v1/contacts","href":"/endpoints/contacts/create-a-contact-legacy-—-no-identity"},{"title":"Retrieve a contact (legacy — no identity)","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/contacts/{contact_id}","href":"/endpoints/contacts/retrieve-a-contact-legacy-—-no-identity"},{"title":"List contacts","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v2/contacts","href":"/endpoints/contacts/list-contacts"},{"title":"Create a contact","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v2/contacts","href":"/endpoints/contacts/create-a-contact"},{"title":"Retrieve a contact","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v2/contacts/{contact_id}","href":"/endpoints/contacts/retrieve-a-contact"}]},{"group":"credits","pages":[{"title":"Get credit balance","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/credits/balance","href":"/endpoints/credits/get-credit-balance"}]},{"group":"spam","pages":[{"title":"List monitored numbers","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/spam/numbers","href":"/endpoints/spam/list-monitored-numbers"},{"title":"Add a monitored number","description":"Registers a phone number for carrier spam monitoring and\n**automatically initiates verification**. OptimalDial places a\nverification call (or SMS) to the number; the recipient reads back the\ncode, which you then submit to the `/verify` endpoint. Verification is\nrequired for the monitoring service to function — it lets OptimalDial\nplace test calls from the number — it is **not** an ownership or\nsecurity gate.\n\n`verification_method` defaults to `call`. Choose `sms` only for\nSMS-capable numbers; landlines reject SMS and return `400`.\n","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v1/spam/numbers","href":"/endpoints/spam/add-a-monitored-number"},{"title":"Retrieve a monitored number","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/spam/numbers/{number_id}","href":"/endpoints/spam/retrieve-a-monitored-number"},{"title":"Stop monitoring a number","description":"Removes the number from monitoring. No further test runs are scheduled.","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml delete /api/v1/spam/numbers/{number_id}","href":"/endpoints/spam/stop-monitoring-a-number"},{"title":"Submit a verification code","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v1/spam/numbers/{number_id}/verify","href":"/endpoints/spam/submit-a-verification-code"},{"title":"Resend a verification code","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml post /api/v1/spam/numbers/{number_id}/verify/resend","href":"/endpoints/spam/resend-a-verification-code"},{"title":"List recent test runs","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/spam/numbers/{number_id}/history","href":"/endpoints/spam/list-recent-test-runs"},{"title":"Get the latest screenshot","deprecated":null,"version":null,"openapi":"https://api.optimaldial.com/openapi/v1/spec.yaml get /api/v1/spam/numbers/{number_id}/screenshot","href":"/endpoints/spam/get-the-latest-screenshot"}]}]},{"group":"Resources","pages":[{"title":"Changelog","href":"/changelog"},{"title":"OpenAPI specification","href":"/openapi"}]}]},"title":"Retrieve a monitored number - OptimalDial","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}