Returns the status and details of the phone-number background job identified by id.
GET
/
phone_numbers
/
jobs
/
{id}
JavaScript
import Telnyx from 'telnyx';const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted});const job = await client.phoneNumbers.jobs.retrieve('id');console.log(job.data);
import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
job = client.phone_numbers.jobs.retrieve(
"id",
)
print(job.data)
import Telnyx from 'telnyx';const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted});const job = await client.phoneNumbers.jobs.retrieve('id');console.log(job.data);
import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
job = client.phone_numbers.jobs.retrieve(
"id",
)
print(job.data)
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Telnyx","description":"Infrastructure for real-time agents. Voice, AI, Edge Compute","colors":{"primary":"#00B688","light":"#00B688","dark":"#00B688"},"logo":{"light":"https://mintcdn.com/telnyx/v2FpkbJg6PQ53qHU/assets/images/site/logo.svg?fit=max\u0026auto=format\u0026n=v2FpkbJg6PQ53qHU\u0026q=85\u0026s=5ee3f61d11ba90a197dd9a1e3499fab6","dark":"https://mintcdn.com/telnyx/v2FpkbJg6PQ53qHU/assets/images/site/logo-dark.svg?fit=max\u0026auto=format\u0026n=v2FpkbJg6PQ53qHU\u0026q=85\u0026s=d65aaa12ec708c79e5833cbdea958055"},"favicon":"https://mintcdn.com/telnyx/t-qaBUa_gCxdRz_m/favicon.ico?fit=max\u0026auto=format\u0026n=t-qaBUa_gCxdRz_m\u0026q=85\u0026s=8291283238ab8c0e2a7a985e69f38c2f","background":{"decoration":"gradient"},"navbar":{"links":[{"icon":"triangle-exclamation","href":"/docs/development/api-fundamentals/api-errors","label":"Error codes"},{"icon":"headset","href":"https://telnyx.com/contact-us","label":"Contact us"},{"icon":"user","href":"https://portal.telnyx.com/#/login/sign-in","label":"Login"}],"primary":{"type":"button","label":"Sign Up","href":"https://telnyx.com/sign-up"}},"footer":{"socials":{"github":"https://github.com/team-telnyx","linkedin":"https://www.linkedin.com/company/telnyx","slack":"https://joinslack.telnyx.com","x":"https://x.com/telnyx"},"links":[{"header":"Resources","items":[{"label":"Pricing","href":"https://developers.telnyx.com/internal/pages/pricing"},{"label":"Compare Telnyx","href":"https://developers.telnyx.com/internal/pages/compare"},{"label":"Support center","href":"https://support.telnyx.com/en"},{"label":"SETI","href":"https://seti.telnyx.com"},{"label":"Agent platform configs","href":"https://github.com/team-telnyx/ai"},{"label":"About Telnyx","href":"https://developers.telnyx.com/internal/pages/about"},{"label":"Service status","href":"https://status.telnyx.com"}]},{"header":"Updates","items":[{"label":"Release notes","href":"https://telnyx.com/release-notes"}]},{"header":"Community","items":[{"label":"Low Latency Club","href":"https://lowlatencyclub.ai/"}]},{"header":"Legal","items":[{"label":"Privacy policy","href":"https://telnyx.com/privacy-policy"},{"label":"Terms and conditions","href":"https://telnyx.com/terms-and-conditions"}]}]},"seo":{"metatags":{"og:description":"Infrastructure for real-time agents. Voice, AI, Edge Compute","description":"Infrastructure for real-time agents. Voice, AI, Edge Compute"},"organization":{"name":"Telnyx","url":"https://telnyx.com","logo":"https://telnyx.com/favicon.ico","sameAs":["https://x.com/telnyx","https://www.linkedin.com/company/telnyx/","https://github.com/team-telnyx"]}},"fonts":{"heading":{"family":"PP Formula","weight":800,"source":"assets/fonts/PPFormula-Extrabold.woff2","format":"woff2"},"body":{"family":"Inter","weight":400,"source":"assets/fonts/Inter-Regular.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"gtm":{"tagId":"GTM-NRRX236"}},"banner":{"content":"Check out our upcoming events and meetups! [View events →](https://lowlatencyclub.ai/)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/docs/overview"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"telnyx","hasAudioNarration":false,"actualSubdomain":"telnyx","customDomains":["developers.telnyx.com"],"gitSource":{"type":"github","owner":"team-telnyx","repo":"developer-docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aecc1177e2a3b454e46ab4a","collectionId":"e89de448-4ed6-4586-a5dc-1bb465c580ba","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecc1177e2a3b454e46ab4a"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aecdffdcf361b99cc057bd9","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"API Reference","count":601},{"language":"default","tag":"Calling","count":592},{"language":"default","tag":"Other APIs","count":406},{"language":"default","tag":"AI","count":395},{"language":"default","tag":"Messaging","count":353},{"language":"default","tag":"Numbers","count":287},{"language":"default","tag":"Agent Platform","count":282},{"language":"default","tag":"Assistants","count":202},{"language":"default","tag":"Voice API","count":178},{"language":"default","tag":"SMS \u0026 MMS","count":149}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"[class*=\"sidebar\"] [class*=\"tag\"],[class*=\"sidebar\"] [class*=\"badge\"],nav [class*=\"tag\"],nav [class*=\"badge\"]{font-size:0.8rem!important}#ot-sdk-btn-floating{left:auto!important;right:10px!important}body:has([aria-label=\"Preview Widget\"]) #ot-sdk-btn-floating{bottom:88px!important}#navbar .nav-tabs-item:has(>div>svg[style*=\"/book-open.svg\"]){display:none}.nav-tabs a.nav-tabs-item:not([aria-current=\"location\"]){display:none}#navbar div:has(>div>.nav-tabs>a.nav-tabs-item:first-child:last-child){display:none}@media (width >= 64rem){.txd-side{display:block}button[data-component-part=\"products-selector-trigger\"],button.tx-product-switcher{display:none!important}}#mobile-nav [data-component-part=\"products-selector-trigger\"],#mobile-nav #navigation-items>div:has(>div>button[aria-haspopup=\"menu\"]),#mobile-nav.tx-has-directory #navigation-items{display:none!important}#mobile-nav .tx-mobile-directory{padding:0;margin-bottom:1.5rem}#mobile-nav .tx-mobile-directory a,#mobile-nav .tx-mobile-directory .tx-dir-suite-head{min-height:2.75rem}#mobile-nav .tx-mobile-directory :is(a,.tx-dir-suite-head):focus-visible{outline:2px solid currentColor;outline-offset:-2px}.txd-shell{display:flex;gap:0;max-width:none;margin:0;padding:3rem 2rem 6rem 0}.txd-side{width:18rem;flex-shrink:0}.txd-main{flex:1;min-width:0;max-width:56rem;margin-left:11.75rem}@media (max-width: 80rem){.txd-main{margin-left:4rem}}@media (width \u003c 64rem){.txd-shell{display:block;padding:2rem 1.5rem 5rem}.txd-side{display:none}.txd-main{margin-left:0}}:is(#tx-directory,.tx-mobile-directory){margin:0 0 0.5rem;padding:0 0.5rem 0 1rem}:is(#tx-directory,.tx-mobile-directory) .tx-dir-label{font-size:0.72rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;opacity:0.55;margin:0 0 0.4rem}:is(#tx-directory,.tx-mobile-directory) .tx-dir-label-gap{margin-top:1.5rem}:is(#tx-directory,.tx-mobile-directory) .tx-dir-link,:is(#tx-directory,.tx-mobile-directory) summary{display:flex;align-items:center;cursor:pointer;font-size:0.875rem;line-height:1.25rem;padding:0.35rem 0.5rem;border-radius:0.375rem;color:rgb(55 65 81);text-decoration:none}html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-link,html.dark :is(#tx-directory,.tx-mobile-directory) summary{color:rgb(156 163 175)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-link:hover,:is(#tx-directory,.tx-mobile-directory) summary:hover{color:rgb(17 24 39);background:rgb(0 0 0 / 0.04)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-link[aria-current=\"page\"]{color:#00b688;background:transparent;box-shadow:none;font-weight:400;text-shadow:-0.2px 0 0 currentColor, 0.2px 0 0 currentColor}html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-link:hover,html.dark :is(#tx-directory,.tx-mobile-directory) summary:hover{color:rgb(229 231 235);background:rgb(255 255 255 / 0.06)}html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-link[aria-current=\"page\"]{color:#5eead4;background:transparent;box-shadow:none}:is(#tx-directory,.tx-mobile-directory) .tx-dir-soon,:is(#tx-directory,.tx-mobile-directory) .tx-dir-soon:hover,html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-soon,html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-soon:hover{cursor:default;opacity:0.45;background:transparent;color:inherit}:is(#tx-directory,.tx-mobile-directory) .tx-dir-soon sup{font-size:0.6rem;line-height:1;letter-spacing:0.05em;text-transform:uppercase;margin-left:0.4rem;vertical-align:super}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite{margin-bottom:0.15rem}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite-head{display:flex;align-items:center;cursor:pointer;user-select:none;font-size:0.875rem;line-height:1.25rem;font-weight:500;padding:0.35rem 0.5rem;border-radius:0.375rem;color:rgb(55 65 81)}html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-suite-head{color:rgb(156 163 175)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite-head:hover{color:rgb(17 24 39);background:rgb(0 0 0 / 0.04)}html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-suite-head:hover{color:rgb(229 231 235);background:rgb(255 255 255 / 0.06)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite-head::after{content:'';width:0.42rem;height:0.42rem;margin-left:auto;border-right:1.5px solid currentColor;border-bottom:1.5px solid currentColor;transform:rotate(-45deg);transition:transform 0.15s;flex-shrink:0;opacity:0.7}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite.open>.tx-dir-suite-head::after{transform:rotate(45deg)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite.open>.tx-dir-suite-head{color:rgb(17 24 39);background:rgb(0 0 0 / 0.04);font-weight:600}html.dark :is(#tx-directory,.tx-mobile-directory) .tx-dir-suite.open>.tx-dir-suite-head{color:rgb(229 231 235);background:rgb(255 255 255 / 0.06)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite>ul{display:none}:is(#tx-directory,.tx-mobile-directory) .tx-dir-suite.open>ul{display:block}:is(#tx-directory,.tx-mobile-directory) ul{margin:0.15rem 0 0.5rem;padding:0}:is(#tx-directory,.tx-mobile-directory) li{list-style:none}:is(#tx-directory,.tx-mobile-directory) li a{display:flex;align-items:center;font-size:0.875rem;line-height:1.25rem;padding:0.3rem 0.5rem 0.3rem 1.6rem;border-radius:0.375rem;color:rgb(107 114 128);text-decoration:none}:is(#tx-directory,.tx-mobile-directory) .tx-dir-section-item{font-weight:500}html.dark :is(#tx-directory,.tx-mobile-directory) li a{color:rgb(156 163 175)}:is(#tx-directory,.tx-mobile-directory) li a:hover{color:rgb(17 24 39);background:rgb(0 0 0 / 0.04)}html.dark :is(#tx-directory,.tx-mobile-directory) li a:hover{color:rgb(229 231 235);background:rgb(255 255 255 / 0.06)}:is(#tx-directory,.tx-mobile-directory) .tx-dir-icon{display:inline-block;width:1rem;height:1rem;flex-shrink:0;margin-right:0.5rem;background-color:currentColor;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-position:center;mask-position:center;-webkit-mask-size:contain;mask-size:contain}.txi-arrows-left-right-to-line{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/arrows-left-right-to-line.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/arrows-left-right-to-line.svg\")}.txi-bolt{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/bolt.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/bolt.svg\")}.txi-brain{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/brain.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/brain.svg\")}.txi-brain-circuit{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/brain-circuit.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/brain-circuit.svg\")}.txi-brands-whatsapp{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/brands/whatsapp.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/brands/whatsapp.svg\")}.txi-broadcast-tower{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/broadcast-tower.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/broadcast-tower.svg\")}.txi-browser{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/browser.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/browser.svg\")}.txi-circle-nodes{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/circle-nodes.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/circle-nodes.svg\")}.txi-clone{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/clone.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/clone.svg\")}.txi-cloud{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/cloud.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/cloud.svg\")}.txi-code{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/code.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/code.svg\")}.txi-comment-sms{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/comment-sms.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/comment-sms.svg\")}.txi-cubes{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/cubes.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/cubes.svg\")}.txi-database{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/database.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/database.svg\")}.txi-door-open{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/door-open.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/door-open.svg\")}.txi-envelope{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/envelope.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/envelope.svg\")}.txi-eye{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/eye.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/eye.svg\")}.txi-file-certificate{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/file-certificate.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/file-certificate.svg\")}.txi-fingerprint{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/fingerprint.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/fingerprint.svg\")}.txi-folder-tree{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/folder-tree.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/folder-tree.svg\")}.txi-globe{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/globe.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/globe.svg\")}.txi-hard-drive{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/hard-drive.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/hard-drive.svg\")}.txi-hashtag{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/hashtag.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/hashtag.svg\")}.txi-headset{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/headset.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/headset.svg\")}.txi-key{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/key.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/key.svg\")}.txi-layer-group{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/layer-group.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/layer-group.svg\")}.txi-magnifying-glass{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/magnifying-glass.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/magnifying-glass.svg\")}.txi-message{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/message.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/message.svg\")}.txi-message-dots{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/message-dots.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/message-dots.svg\")}.txi-microchip-ai{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/microchip-ai.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/microchip-ai.svg\")}.txi-microphone{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/microphone.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/microphone.svg\")}.txi-network-wired{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/network-wired.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/network-wired.svg\")}.txi-phone{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/phone.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/phone.svg\")}.txi-phone-volume{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/phone-volume.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/phone-volume.svg\")}.txi-plug{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/plug.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/plug.svg\")}.txi-right-left{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/right-left.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/right-left.svg\")}.txi-robot{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/robot.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/robot.svg\")}.txi-server{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/server.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/server.svg\")}.txi-share-nodes{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/share-nodes.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/share-nodes.svg\")}.txi-shield{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/shield.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/shield.svg\")}.txi-shield-check{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/shield-check.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/shield-check.svg\")}.txi-signal{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/signal.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/signal.svg\")}.txi-sim-card{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/sim-card.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/sim-card.svg\")}.txi-split{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/split.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/split.svg\")}.txi-table{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/table.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/table.svg\")}.txi-tower-control{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/tower-control.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/tower-control.svg\")}.txi-train-tunnel{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/train-tunnel.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/train-tunnel.svg\")}.txi-video{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/video.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/video.svg\")}.txi-wand-magic-sparkles{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/wand-magic-sparkles.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/wand-magic-sparkles.svg\")}.txi-waveform{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/waveform.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/waveform.svg\")}.txi-waveform-lines{-webkit-mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/waveform-lines.svg\");mask-image:url(\"https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/waveform-lines.svg\")}.txd-main .txd-h1{font-family:var(--font-family-headings-custom, \"PP Formula\"), -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;font-size:2.1rem;font-weight:500;letter-spacing:-0.01em;margin:1.2rem 0 0.4rem;color:rgb(22 28 26)}html.dark .txd-main .txd-h1{color:rgb(229 231 235)}.txd-main .txd-lead{font-size:1.3rem;line-height:1.55;font-weight:500;margin:0.9rem 0 1.3rem;color:rgb(31 41 55)}html.dark .txd-main .txd-lead{color:rgb(209 213 219)}.txd-main .txd-h2{font-family:var(--font-family-headings-custom, \"PP Formula\"), -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;font-size:1.45rem;font-weight:500;margin:2.4rem 0 0.4rem;color:rgb(22 28 26)}html.dark .txd-main .txd-h2{color:rgb(229 231 235)}.txd-main .txd-section-h{font-size:1.05rem;font-weight:600;margin:1.8rem 0 0.2rem;opacity:0.85}.txd-main .txd-p{margin:0.7rem 0 1rem;line-height:1.65;color:rgb(75 85 99)}html.dark .txd-main .txd-p{color:rgb(156 163 175)}.txd-main .txd-p a{text-decoration:underline}.txd-main .txd-h1{max-width:46rem;line-height:1.12}.txd-main .txd-hero-copy{max-width:45rem}.txd-main .txd-follow-up{margin-top:1rem}.txd-main .txd-follow-up a{color:#00b688;font-weight:600;text-decoration:none}.txd-main .txd-follow-up a:hover{text-decoration:underline}.txd-main a:focus-visible{outline:2px solid #00b688;outline-offset:3px}@media (max-width: 48rem){.txd-main .txd-h1{font-size:1.9rem}}@media (min-width: 64.01rem) and (max-width: 90rem){.txd-main{margin-right:4rem}}.rm-explorer{--rm-border: rgb(15 23 42 / 14%);--rm-muted: #5f6b68;--rm-soft: #f6f8f7}.dark .rm-explorer{--rm-border: rgb(255 255 255 / 14%);--rm-muted: #a2aaa8;--rm-soft: #151a19}#resource-map-toolbar{position:sticky;top:5rem;z-index:20;margin:1.25rem 0 1.75rem;padding:.75rem 0;background:var(--rm-surface, #fff);border-bottom:1px solid var(--rm-border)}.dark #resource-map-toolbar{background:#0b0e0d}.rm-controls{display:grid;grid-template-columns:minmax(15rem, 1fr) minmax(10rem, auto) auto;gap:.625rem;align-items:center}.rm-search{position:relative;min-width:0}.rm-search svg{position:absolute;top:50%;left:.75rem;width:1rem;height:1rem;color:var(--rm-muted);fill:none;stroke:currentColor;stroke-width:1.8;transform:translateY(-50%);pointer-events:none}.rm-search input,.rm-area-select,.rm-collapse,.rm-clear,.rm-empty button{min-height:2.5rem;color:inherit;background:transparent;border:1px solid var(--rm-border);border-radius:.5rem;font:inherit;font-size:.875rem}.rm-search input{width:100%;padding:.58rem 2.6rem .58rem 2.35rem}.rm-search input::placeholder{color:var(--rm-muted);opacity:1}.rm-shortcut{position:absolute;top:50%;right:.65rem;display:grid;width:1.5rem;height:1.5rem;place-items:center;color:var(--rm-muted);background:var(--rm-soft);border:1px solid var(--rm-border);border-radius:.35rem;font:inherit;font-size:.72rem;transform:translateY(-50%);pointer-events:none}.rm-area-wrap{position:relative;max-width:13rem}.rm-area-select{width:100%;max-width:13rem;padding:.55rem 2.25rem .55rem .75rem;appearance:none;cursor:pointer}.rm-area-caret{position:absolute;top:50%;right:.85rem;width:.45rem;height:.45rem;border-right:1.5px solid currentColor;border-bottom:1.5px solid currentColor;transform:translateY(-70%) rotate(45deg);pointer-events:none}.rm-collapse,.rm-clear,.rm-empty button{padding:.5rem .75rem;font-weight:650;cursor:pointer}.rm-search input:focus-visible,.rm-area-select:focus-visible,.rm-collapse:focus-visible,.rm-clear:focus-visible,.rm-empty button:focus-visible{outline:2px solid #00b688;outline-offset:2px;border-color:#00b688;box-shadow:none!important}.rm-collapse:hover,.rm-clear:hover,.rm-empty button:hover{color:#08785d;background:var(--rm-soft)}.dark .rm-collapse:hover,.dark .rm-clear:hover,.dark .rm-empty button:hover{color:#5eead4}.rm-meta{display:flex;min-height:1.65rem;align-items:center;justify-content:space-between;gap:.75rem;padding:.45rem .15rem 0}.rm-status{color:var(--rm-muted);font-size:.78rem;line-height:1.35}.rm-clear{min-height:1.8rem;padding:.2rem .55rem;border-color:transparent;font-size:.78rem}.rm-empty{display:grid;justify-items:start;gap:.35rem;margin:-.5rem 0 1.75rem;padding:1.1rem 1.2rem;color:var(--rm-muted);background:var(--rm-soft);border:1px solid var(--rm-border);border-radius:.75rem;font-size:.875rem}.rm-empty strong{color:inherit;font-size:.95rem}.rm-empty button{min-height:2.2rem;margin-top:.35rem}.rm-resource-list{display:block!important;margin:0 0 .75rem!important;border-color:var(--rm-border)!important;border-top:0!important;border-radius:0 0 .75rem .75rem!important}.rm-resource-list>details.accordion{margin:0!important;border:0!important;border-radius:0!important}.rm-resource-list>details.accordion+details.accordion{border-top:1px solid var(--rm-border)!important}.rm-resource-list>details.accordion>summary{min-height:3rem;padding:.7rem .9rem!important;border-radius:0!important}.rm-resource-list>details.accordion:first-child>summary{border-radius:0!important}.rm-resource-list>details.accordion:last-child:not([open])>summary{border-radius:0 0 .75rem .75rem!important}.rm-resource-list [data-component-part=\"accordion-title\"]{display:flex;min-width:0;align-items:baseline;justify-content:space-between;gap:1rem}.rm-resource-name{min-width:0;overflow-wrap:anywhere;font-weight:650}.rm-method-count{flex:0 0 auto;color:var(--rm-muted);font-size:.75rem;font-weight:500;white-space:nowrap}.rm-resource-list details[open]>summary{background:var(--rm-soft)}.rm-resource-list details[open] [data-component-part=\"accordion-content\"]{margin-right:1rem;margin-left:1rem}.rm-resource-list tbody tr.rm-row-match{background:rgb(0 182 136 / 8%)}.rm-resource-list td:first-child code{white-space:nowrap}.rm-resource-list tbody tr[hidden],.rm-explorer h2[hidden],.rm-resource-list[hidden],.rm-empty[hidden],.rm-collapse[hidden],.rm-clear[hidden]{display:none!important}.rm-explorer h2{position:relative;min-height:3rem;margin:.45rem 0 0!important;scroll-margin-top:10rem;border:1px solid var(--rm-border);border-radius:.75rem}.rm-explorer h2.rm-section-open{border-radius:.75rem .75rem 0 0}.rm-section-toggle{display:grid;width:100%;min-height:3rem;grid-template-columns:minmax(0, 1fr) auto auto;align-items:center;gap:.75rem;padding:.6rem .9rem;color:inherit;text-align:left;background:transparent;border:0;cursor:pointer}.rm-section-toggle:hover,.rm-section-toggle:focus-visible{background:var(--rm-soft)}.rm-section-toggle:focus-visible{outline:2px solid #00b688;outline-offset:2px;border-radius:.7rem}.rm-section-name{font-size:1rem;font-weight:700}.rm-section-count{display:grid;min-width:1.65rem;min-height:1.4rem;place-items:center;padding:3px 6px;color:#08785d;background:rgb(0 182 136 / 10%);border-radius:.35rem;font-size:12px;font-weight:700;line-height:16px;white-space:nowrap}.dark .rm-section-count{color:#5eead4;background:#12302b}.rm-section-caret{width:.5rem;height:.5rem;border-right:1.5px solid currentColor;border-bottom:1.5px solid currentColor;transform:rotate(45deg) translateY(-.15rem)}.rm-section-toggle[aria-expanded=\"true\"] .rm-section-caret{transform:rotate(225deg) translate(-.1rem, -.05rem)}@media (max-width: 767px){#resource-map-toolbar{position:static;top:auto;z-index:auto;margin-top:1rem;padding-top:.6rem}.rm-controls{grid-template-columns:minmax(0, 1fr) auto}.rm-search{grid-column:1 / -1}.rm-search input{padding-right:.75rem}.rm-shortcut{display:none}.rm-area-wrap,.rm-area-select{width:100%;max-width:none}.rm-resource-list [data-component-part=\"accordion-title\"]{gap:.65rem}.rm-method-count{font-size:.7rem}.rm-resource-list table,.rm-resource-list tbody{display:block;width:100%;min-width:0!important}.rm-resource-list thead{display:none}.rm-resource-list tbody tr{display:grid;width:100%;grid-template-columns:minmax(0, 1fr);gap:.45rem;padding:.75rem 0}.rm-resource-list tbody tr+tr{border-top:1px solid var(--rm-border)}.rm-resource-list tbody td{display:grid;width:100%;min-width:0!important;grid-template-columns:4.5rem minmax(0, 1fr);align-items:start;gap:.5rem;padding:0!important;border:0!important}.rm-resource-list tbody td::before{color:var(--rm-muted);font-size:.68rem;font-weight:700;letter-spacing:.04em;text-transform:uppercase}.rm-resource-list tbody td:first-child::before{content:\"Method\"}.rm-resource-list tbody td:last-child::before{content:\"Endpoint\"}.rm-resource-list tbody td code,.rm-resource-list tbody td a{min-width:0;white-space:normal!important;overflow-wrap:anywhere}}@media (prefers-reduced-motion: reduce){.rm-explorer *,.rm-explorer *::before,.rm-explorer *::after{scroll-behavior:auto!important;transition-duration:.01ms!important}}.sdk-launchpad{--sdk-border: #d8e1de;--sdk-panel: #ffffff;margin:1rem 0 1.5rem;padding:1rem;overflow:hidden;color:inherit;background:var(--sdk-panel);border:1px solid var(--sdk-border);border-radius:12px}.dark .sdk-launchpad{--sdk-border: #293431;--sdk-panel: #101513}.sdk-launchpad-kicker{margin:0 0 .25rem!important;color:#08785d;font-size:.68rem;font-weight:800;letter-spacing:.1em}.dark .sdk-launchpad-kicker{color:#5eead4}.sdk-launchpad>h2{margin-top:.25rem}.sdk-launchpad [role=\"tablist\"]{display:flex;flex-wrap:wrap;gap:.25rem}.sdk-launchpad [role=\"tab\"]{min-width:56px;min-height:44px}.sdk-launchpad [role=\"tab\"][aria-selected=\"true\"]{color:#08785d!important}.dark .sdk-launchpad [role=\"tab\"][aria-selected=\"true\"]{color:#5eead4!important}.sdk-launchpad [role=\"tab\"]:focus-visible,.sdk-launchpad a:focus-visible,.sdk-launchpad-code:focus-visible{outline:2px solid #08785d;outline-offset:2px}.dark .sdk-launchpad [role=\"tab\"]:focus-visible,.dark .sdk-launchpad a:focus-visible,.dark .sdk-launchpad-code:focus-visible{outline-color:#5eead4}.sdk-launchpad-code{max-width:100%;overflow-x:auto;border-radius:.5rem}.sdk-launchpad-code pre{max-width:none;overflow-x:visible!important}.sdk-launchpad-code button{min-width:44px;min-height:44px}#content-area:has(#sdk-launchpad) .chat-assistant-floating-input{display:none}@media (max-width: 640px){.sdk-launchpad{margin-top:.75rem;padding:.75rem}.sdk-launchpad-kicker{display:none}.sdk-launchpad [role=\"tablist\"]{display:grid;grid-template-columns:repeat(6, minmax(0, 1fr));gap:.2rem;overflow:visible}.sdk-launchpad [role=\"tab\"]{min-width:0;min-height:44px;padding-inline:.2rem;font-size:.75rem;line-height:1.15;white-space:nowrap}}.sdk-directory li{margin-block:.5rem}.mdx-content table td{min-width:0!important}.mdx-content table td :is(code,a){overflow-wrap:anywhere}.mdx-content table :is(th,td):first-child code{white-space:nowrap;word-break:normal;overflow-wrap:normal}@media (min-width: 768px){.tx-table-grid table{table-layout:fixed}.tx-table-grid table :is(th,td):first-child{width:40%}}@media (min-width: 768px){.tx-table-grid-3 table{table-layout:fixed}.tx-table-grid-3 table :is(th,td):first-child{width:22%}.tx-table-grid-3 table :is(th,td):last-child{width:18%}}.tx-retirement-banner{margin-bottom:1.5rem}.tx-retirement-banner>div{margin:0}@media (min-width: 1024px){.tx-retirement-banner{position:sticky;top:calc(6rem + var(--banner-height, 0px));z-index:20;padding-top:.5rem;background:rgb(var(--background-light, 255 255 255))}.dark .tx-retirement-banner{background:rgb(var(--background-dark, 9 12 14))}}#content>.callout:first-child{margin-top:0}#content strong{font-weight:600}"}],"page":{"pagePath":"api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job","slug":"/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job","pageMetadata":{"title":"Retrieve a phone numbers job","description":"Returns the status and details of the phone-number background job identified by `id`.","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/jobs/{id}","href":"/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job","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: [\"Returns the status and details of the phone-number background job identified by \", _jsx(_components.code, {\n children: \"id\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve a phone numbers job","description":"Returns the status and details of the phone-number background job identified by `id`.","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/jobs/{id}","href":"/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/telnyx/a2dd5aaa2ff5831a/reading-progress.js","/_mintlify/custom/telnyx/7b77ce9cedb163fd/webmcp-init.js","/_mintlify/custom/telnyx/7fbfee588ac7ad38/structured-data.js","/_mintlify/custom/telnyx/41d9633b1a2dd405/scripts/tests/generate-llms-txt.test.js","/_mintlify/custom/telnyx/8851ad5fd6e9b5c7/scripts/tests/direct-source-workflows.test.js","/_mintlify/custom/telnyx/7ad13bb6588be22f/scripts/tests/redirects.test.js","/_mintlify/custom/telnyx/f981035eb45fcbdb/scripts/tests/generate-error-catalog.test.js","/_mintlify/custom/telnyx/132bc205f55282a5/scripts/tests/sync-llms-automerge.test.js","/_mintlify/custom/telnyx/05e787f15f45952b/scripts/tests/webhook-catalog-lifecycle.test.js","/_mintlify/custom/telnyx/01b840b27496e6c8/scripts/tests/repository-structure.test.js","/_mintlify/custom/telnyx/5ebc7d6e18012563/scripts/tests/legacy-content-usage.test.js","/_mintlify/custom/telnyx/ac1f21e68bf4050a/scripts/docs/check-llms-links.js","/_mintlify/custom/telnyx/5f7d2f1ae375b9ad/scripts/docs/check-llms-native-routes.js","/_mintlify/custom/telnyx/b8d13287c2dcc5b9/scripts/docs/fetch-coverage.js","/_mintlify/custom/telnyx/e0a29f76f2645359/scripts/docs/generate-error-catalog.js","/_mintlify/custom/telnyx/9ffa8f6166445a46/scripts/docs/generate-llms-txt.js","/_mintlify/custom/telnyx/f1f111fe784c3ede/scripts/docs/update-tts-voices.js","/_mintlify/custom/telnyx/c48ad0189f7f1c57/scripts/docs/build-sdk-doc-pages.js","/_mintlify/custom/telnyx/f840117777d76f9e/scripts/tests/sdk-doc-pages.test.js","/_mintlify/custom/telnyx/414c53c50b0e1968/resource-map-filter.js","/_mintlify/custom/telnyx/80af622b3010a712/scripts/tests/sdk-language-switcher.test.js","/_mintlify/custom/telnyx/52fa0fbcb966f8b6/sdk-language-switcher.js","/_mintlify/custom/telnyx/660ec334a362cf1c/home-directory.js","/_mintlify/custom/telnyx/33d3f1dbdec08735/scripts/generate-home-directory.js","/_mintlify/custom/telnyx/137e3eb8e1d1d85a/scripts/tests/api-fundamentals.test.js","/_mintlify/custom/telnyx/24a8eed3a5010d4c/scripts/tests/agent-sdk-workflow.test.js","/_mintlify/custom/telnyx/abc2169efcd5115c/scripts/tests/homepage-overview.test.js","/_mintlify/custom/telnyx/8edf49ac62deef02/scripts/tests/batch-detail-records-navigation.test.js","/_mintlify/custom/telnyx/e005178572336f01/scripts/tests/api-discoverability.test.js","/_mintlify/custom/telnyx/78cb83896fbea5cf/scripts/tests/home-directory.test.js","/_mintlify/custom/telnyx/11ae45253e6b7be6/scripts/tests/agent-readiness.test.js","/_mintlify/custom/telnyx/82396d5a75077c2a/scripts/tests/sample-workflow-regressions.test.js","/_mintlify/custom/telnyx/5f6625c0420c9328/scripts/tests/openapi-mintlify-parsing.test.js","/_mintlify/custom/telnyx/c7dca602ca9641ec/scripts/tests/llms-markdown-assets.test.js","/_mintlify/custom/telnyx/02d6acd7c86b79f9/scripts/tests/agent-browser-quickstart.test.js"],"openApiReferenceData":{"operation":{"summary":"Retrieve a phone numbers job","operationId":"RetrievePhoneNumbersJob","tags":["Bulk Phone Number Operations"],"parameters":["289d718e-ab46-4f8d-be02-0223f5ff7c88"],"x-group-parameters":"true","responses":{"200":"d0690f05-f490-40ca-b9b6-0c500608757a","400":"a8743b02-7e6a-42fe-8111-96a76e3ed292","401":"89832c96-8daa-450b-946d-ac0c5989ed4a","404":"e84caf7f-051a-4b19-8994-f4ee5307a0fb","422":"0f92a7e8-ad99-4652-a4e4-a803d9d7faed","500":"faeca309-e6da-4405-83ac-659f3829b272"},"x-codeSamples":[{"lang":"JavaScript","source":"import Telnyx from 'telnyx';\n\nconst client = new Telnyx({\n apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted\n});\n\nconst job = await client.phoneNumbers.jobs.retrieve('id');\n\nconsole.log(job.data);"},{"lang":"Python","source":"import os\nfrom telnyx import Telnyx\n\nclient = Telnyx(\n api_key=os.environ.get(\"TELNYX_API_KEY\"), # This is the default and can be omitted\n)\njob = client.phone_numbers.jobs.retrieve(\n \"id\",\n)\nprint(job.data)\n"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tjob, err := client.PhoneNumbers.Jobs.Get(context.TODO(), \"id\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", job.Data)\n}\n"},{"lang":"Java","source":"package com.telnyx.sdk.example;\n\nimport com.telnyx.sdk.client.TelnyxClient;\nimport com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;\nimport com.telnyx.sdk.models.phonenumbers.jobs.JobRetrieveParams;\nimport com.telnyx.sdk.models.phonenumbers.jobs.JobRetrieveResponse;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n TelnyxClient client = TelnyxOkHttpClient.fromEnv();\n\n JobRetrieveResponse job = client.phoneNumbers().jobs().retrieve(\"id\");\n }\n}"},{"lang":"Ruby","source":"require \"telnyx\"\n\ntelnyx = Telnyx::Client.new(api_key: \"My API Key\")\n\njob = telnyx.phone_numbers.jobs.retrieve(\"id\")\n\nputs(job)"},{"lang":"PHP","source":"\u003c?php\n\nrequire_once dirname(__DIR__) . '/vendor/autoload.php';\n\nuse Telnyx\\Client;\nuse Telnyx\\Core\\Exceptions\\APIException;\n\n$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');\n\ntry {\n $job = $client->phoneNumbers->jobs->retrieve('id');\n\n var_dump($job);\n} catch (APIException $e) {\n echo $e->getMessage();\n}"},{"lang":"CLI","source":"telnyx phone-numbers:jobs retrieve \\\n --api-key 'My API Key' \\\n --id id"}],"description":"Returns the status and details of the phone-number background job identified by `id`.","method":"get","type":"path","servers":["8c117ac9-aeb7-4421-8421-f4d9591c06ba"],"security":["dd71d752-347f-4ca5-a940-a55be620c8e2"],"path":"/phone_numbers/jobs/{id}","baseUrlOptions":["https://api.telnyx.com/v2"],"title":"Retrieve a phone numbers job","codeSamples":[{"lang":"JavaScript","source":"import Telnyx from 'telnyx';\n\nconst client = new Telnyx({\n apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted\n});\n\nconst job = await client.phoneNumbers.jobs.retrieve('id');\n\nconsole.log(job.data);"},{"lang":"Python","source":"import os\nfrom telnyx import Telnyx\n\nclient = Telnyx(\n api_key=os.environ.get(\"TELNYX_API_KEY\"), # This is the default and can be omitted\n)\njob = client.phone_numbers.jobs.retrieve(\n \"id\",\n)\nprint(job.data)\n"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tjob, err := client.PhoneNumbers.Jobs.Get(context.TODO(), \"id\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", job.Data)\n}\n"},{"lang":"Java","source":"package com.telnyx.sdk.example;\n\nimport com.telnyx.sdk.client.TelnyxClient;\nimport com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;\nimport com.telnyx.sdk.models.phonenumbers.jobs.JobRetrieveParams;\nimport com.telnyx.sdk.models.phonenumbers.jobs.JobRetrieveResponse;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n TelnyxClient client = TelnyxOkHttpClient.fromEnv();\n\n JobRetrieveResponse job = client.phoneNumbers().jobs().retrieve(\"id\");\n }\n}"},{"lang":"Ruby","source":"require \"telnyx\"\n\ntelnyx = Telnyx::Client.new(api_key: \"My API Key\")\n\njob = telnyx.phone_numbers.jobs.retrieve(\"id\")\n\nputs(job)"},{"lang":"PHP","source":"\u003c?php\n\nrequire_once dirname(__DIR__) . '/vendor/autoload.php';\n\nuse Telnyx\\Client;\nuse Telnyx\\Core\\Exceptions\\APIException;\n\n$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');\n\ntry {\n $job = $client->phoneNumbers->jobs->retrieve('id');\n\n var_dump($job);\n} catch (APIException $e) {\n echo $e->getMessage();\n}"},{"lang":"CLI","source":"telnyx phone-numbers:jobs retrieve \\\n --api-key 'My API Key' \\\n --id id"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"289d718e-ab46-4f8d-be02-0223f5ff7c88":{"name":"id","in":"path","description":"Identifies the Phone Numbers Job.","required":true,"schema":{"type":"string","isRequired":true,"description":"Identifies the Phone Numbers Job.","uniqueKey":"","typeLabel":"string"}}},"responses":{"d0690f05-f490-40ca-b9b6-0c500608757a":{"description":"Phone numbers job details.","content":{"application/json":{"schema":{"type":"object","title":"Phone Numbers Job","properties":{"data":{"type":"object","properties":{"parameters":{"type":"object","properties":{"phone_numbers":{"type":"array","description":"Saved target phone numbers in E.164 format and/or identifiers. Jobs created using filters contain the resolved identifiers, not the original filter expression. Stored identifier types are preserved.","items":{"oneOf":[{"type":"string","uniqueKey":"data.parameters.phone_numbers.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"data.parameters.phone_numbers.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"data.parameters.phone_numbers.items.[INDEX]","typeLabel":"string | integer"},"uniqueKey":"data.parameters.phone_numbers","typeLabel":"(string | integer)[]"},"external_pin":{"oneOf":[{"type":"string","description":"Saved external_pin supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.external_pin.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved external_pin supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.external_pin.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.external_pin","typeLabel":"string | null"},"connection_id":{"oneOf":[{"type":"string","description":"Saved connection_id supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.connection_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved connection_id supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.connection_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.connection_id","typeLabel":"string | null"},"customer_reference":{"oneOf":[{"type":"string","description":"Saved customer_reference supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.customer_reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved customer_reference supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.customer_reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.customer_reference","typeLabel":"string | null"},"billing_group_id":{"oneOf":[{"type":"string","description":"Saved billing_group_id supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.billing_group_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved billing_group_id supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.billing_group_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.billing_group_id","typeLabel":"string | null"},"hd_voice_enabled":{"oneOf":[{"type":"boolean","description":"Saved hd_voice_enabled supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.hd_voice_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved hd_voice_enabled supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.hd_voice_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.hd_voice_enabled","typeLabel":"boolean | null"},"deletion_lock_enabled":{"oneOf":[{"type":"boolean","description":"Saved deletion_lock_enabled supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.deletion_lock_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved deletion_lock_enabled supplied for an update_phone_numbers job.","uniqueKey":"data.parameters.deletion_lock_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.deletion_lock_enabled","typeLabel":"boolean | null"},"tags":{"oneOf":[{"type":"array","description":"Saved tags for an update_phone_numbers job. Values reflect creation-time normalization.","items":{"type":"string","uniqueKey":"data.parameters.tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.parameters.tags.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Saved tags for an update_phone_numbers job. Values reflect creation-time normalization.","items":{"type":"string"},"uniqueKey":"data.parameters.tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.tags","typeLabel":"string[] | null"},"add_tags":{"oneOf":[{"type":"array","description":"Saved add_tags for an update_phone_numbers job. Values reflect creation-time normalization.","items":{"type":"string","uniqueKey":"data.parameters.add_tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.parameters.add_tags.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Saved add_tags for an update_phone_numbers job. Values reflect creation-time normalization.","items":{"type":"string"},"uniqueKey":"data.parameters.add_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.add_tags","typeLabel":"string[] | null"},"remove_tags":{"oneOf":[{"type":"array","description":"Saved remove_tags for an update_phone_numbers job. Values reflect creation-time normalization.","items":{"type":"string","uniqueKey":"data.parameters.remove_tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.parameters.remove_tags.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Saved remove_tags for an update_phone_numbers job. Values reflect creation-time normalization.","items":{"type":"string"},"uniqueKey":"data.parameters.remove_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.remove_tags","typeLabel":"string[] | null"},"voice":{"type":"object","properties":{"tech_prefix_enabled":{"oneOf":[{"type":"boolean","description":"Saved tech_prefix_enabled setting.","uniqueKey":"data.parameters.voice.tech_prefix_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved tech_prefix_enabled setting.","uniqueKey":"data.parameters.voice.tech_prefix_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.tech_prefix_enabled","typeLabel":"boolean | null"},"caller_id_name_enabled":{"oneOf":[{"type":"boolean","description":"Saved caller_id_name_enabled setting.","uniqueKey":"data.parameters.voice.caller_id_name_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved caller_id_name_enabled setting.","uniqueKey":"data.parameters.voice.caller_id_name_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.caller_id_name_enabled","typeLabel":"boolean | null"},"usage_payment_method":{"oneOf":[{"type":"string","description":"Saved usage_payment_method setting.","uniqueKey":"data.parameters.voice.usage_payment_method.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved usage_payment_method setting.","uniqueKey":"data.parameters.voice.usage_payment_method.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.usage_payment_method","typeLabel":"string | null"},"inbound_call_screening":{"oneOf":[{"type":"string","description":"Saved inbound_call_screening setting.","uniqueKey":"data.parameters.voice.inbound_call_screening.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved inbound_call_screening setting.","uniqueKey":"data.parameters.voice.inbound_call_screening.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.inbound_call_screening","typeLabel":"string | null"},"call_forwarding":{"type":"object","properties":{"forwards_to":{"oneOf":[{"type":"string","description":"Saved forwards_to setting.","uniqueKey":"data.parameters.voice.call_forwarding.forwards_to.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved forwards_to setting.","uniqueKey":"data.parameters.voice.call_forwarding.forwards_to.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_forwarding.forwards_to","typeLabel":"string | null"},"forwarding_type":{"oneOf":[{"type":"string","description":"Saved forwarding_type setting.","uniqueKey":"data.parameters.voice.call_forwarding.forwarding_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved forwarding_type setting.","uniqueKey":"data.parameters.voice.call_forwarding.forwarding_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_forwarding.forwarding_type","typeLabel":"string | null"},"call_forwarding_enabled":{"oneOf":[{"type":"boolean","description":"Saved call_forwarding_enabled setting.","uniqueKey":"data.parameters.voice.call_forwarding.call_forwarding_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved call_forwarding_enabled setting.","uniqueKey":"data.parameters.voice.call_forwarding.call_forwarding_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_forwarding.call_forwarding_enabled","typeLabel":"boolean | null"}},"uniqueKey":"data.parameters.voice.call_forwarding","typeLabel":"object"},"call_recording":{"type":"object","properties":{"inbound_call_recording_enabled":{"oneOf":[{"type":"boolean","description":"Saved inbound_call_recording_enabled setting.","uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved inbound_call_recording_enabled setting.","uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_enabled","typeLabel":"boolean | null"},"inbound_call_recording_channels":{"oneOf":[{"type":"string","description":"Saved inbound_call_recording_channels setting.","uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_channels.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved inbound_call_recording_channels setting.","uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_channels.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_channels","typeLabel":"string | null"},"inbound_call_recording_format":{"oneOf":[{"type":"string","description":"Saved inbound_call_recording_format setting.","uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_format.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved inbound_call_recording_format setting.","uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_recording.inbound_call_recording_format","typeLabel":"string | null"},"record_continue_on_hold":{"oneOf":[{"type":"boolean","description":"Saved record_continue_on_hold setting.","uniqueKey":"data.parameters.voice.call_recording.record_continue_on_hold.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved record_continue_on_hold setting.","uniqueKey":"data.parameters.voice.call_recording.record_continue_on_hold.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.call_recording.record_continue_on_hold","typeLabel":"boolean | null"}},"uniqueKey":"data.parameters.voice.call_recording","typeLabel":"object"},"media_features":{"type":"object","properties":{"rtp_auto_adjust_enabled":{"oneOf":[{"type":"boolean","description":"Saved rtp_auto_adjust_enabled setting.","uniqueKey":"data.parameters.voice.media_features.rtp_auto_adjust_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved rtp_auto_adjust_enabled setting.","uniqueKey":"data.parameters.voice.media_features.rtp_auto_adjust_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.media_features.rtp_auto_adjust_enabled","typeLabel":"boolean | null"},"accept_any_rtp_packets_enabled":{"oneOf":[{"type":"boolean","description":"Saved accept_any_rtp_packets_enabled setting.","uniqueKey":"data.parameters.voice.media_features.accept_any_rtp_packets_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved accept_any_rtp_packets_enabled setting.","uniqueKey":"data.parameters.voice.media_features.accept_any_rtp_packets_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.media_features.accept_any_rtp_packets_enabled","typeLabel":"boolean | null"},"t38_fax_gateway_enabled":{"oneOf":[{"type":"boolean","description":"Saved t38_fax_gateway_enabled setting.","uniqueKey":"data.parameters.voice.media_features.t38_fax_gateway_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved t38_fax_gateway_enabled setting.","uniqueKey":"data.parameters.voice.media_features.t38_fax_gateway_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.media_features.t38_fax_gateway_enabled","typeLabel":"boolean | null"}},"uniqueKey":"data.parameters.voice.media_features","typeLabel":"object"},"cnam_listing":{"type":"object","properties":{"cnam_listing_enabled":{"oneOf":[{"type":"boolean","description":"Saved cnam_listing_enabled setting.","uniqueKey":"data.parameters.voice.cnam_listing.cnam_listing_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved cnam_listing_enabled setting.","uniqueKey":"data.parameters.voice.cnam_listing.cnam_listing_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.cnam_listing.cnam_listing_enabled","typeLabel":"boolean | null"},"cnam_listing_details":{"oneOf":[{"type":"string","description":"Saved cnam_listing_details setting.","uniqueKey":"data.parameters.voice.cnam_listing.cnam_listing_details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved cnam_listing_details setting.","uniqueKey":"data.parameters.voice.cnam_listing.cnam_listing_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.voice.cnam_listing.cnam_listing_details","typeLabel":"string | null"}},"uniqueKey":"data.parameters.voice.cnam_listing","typeLabel":"object"}},"description":"Saved voice settings for an update_phone_numbers job, using the public field names and nesting. Only settings present at creation are returned.","uniqueKey":"data.parameters.voice","typeLabel":"object"},"emergency_enabled":{"oneOf":[{"type":"boolean","description":"Saved emergency-services setting for an update_emergency_settings job.","uniqueKey":"data.parameters.emergency_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Saved emergency-services setting for an update_emergency_settings job.","uniqueKey":"data.parameters.emergency_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.emergency_enabled","typeLabel":"boolean | null"},"emergency_address_id":{"oneOf":[{"type":"string","description":"Saved emergency address identifier for an update_emergency_settings job. An explicitly supplied null is preserved.","uniqueKey":"data.parameters.emergency_address_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Saved emergency address identifier for an update_emergency_settings job. An explicitly supplied null is preserved.","uniqueKey":"data.parameters.emergency_address_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.parameters.emergency_address_id","typeLabel":"string | null"}},"readOnly":true,"description":"Effective parameters saved when the job was created, not a snapshot of the original HTTP request or current phone-number settings. Update jobs include the saved update fields; emergency-settings jobs include the saved emergency fields; delete jobs include only targets. Absent fields are omitted, and saved false, null and empty values are preserved. Tags may be normalized to arrays; filter-created jobs contain resolved target identifiers rather than the original filters. Historical jobs with no saved arguments return an empty object.","examples":[{"phone_numbers":["1583466971586889004","+13127367254"],"customer_reference":"customer-reference","tags":["tag"],"voice":{"tech_prefix_enabled":false}},{"phone_numbers":["+19705555098"],"emergency_enabled":false,"emergency_address_id":null},{"phone_numbers":["+19705555098"]}],"uniqueKey":"data.parameters","typeLabel":"object"},"id":{"type":"string","format":"uuid","example":"42587e44-3a3e-46de-9255-0c9a7a1d1ec7","description":"Identifies the resource.","readOnly":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"record_type":{"type":"string","example":"phone_numbers_job","description":"Identifies the type of the resource.","readOnly":true,"uniqueKey":"data.record_type","typeLabel":"string"},"status":{"type":"string","enum":["pending","in_progress","completed","failed","expired"],"default":"pending","example":"pending","description":"Indicates the completion status of the background update.","readOnly":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["update_emergency_settings","delete_phone_numbers","update_phone_numbers"],"example":"update_emergency_settings","description":"Identifies the type of the background job.","readOnly":true,"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"etc":{"type":"string","format":"date-time","description":"ISO 8601 formatted date indicating when the estimated time of completion of the background job.","readOnly":true,"uniqueKey":"data.etc","typeLabel":"string\u003cdate-time>"},"created_at":{"type":"string","description":"ISO 8601 formatted date indicating when the resource was created.","readOnly":true,"uniqueKey":"data.created_at","typeLabel":"string"},"updated_at":{"type":"string","description":"ISO 8601 formatted date indicating when the resource was updated.","readOnly":true,"uniqueKey":"data.updated_at","typeLabel":"string"},"phone_numbers":{"type":"array","items":{"properties":{"phone_number":{"type":"string","description":"The phone number in e164 format.","example":"+19705555000","uniqueKey":"data.phone_numbers.items.[INDEX].phone_number","typeLabel":"string"},"id":{"type":"string","description":"The phone number's ID","uniqueKey":"data.phone_numbers.items.[INDEX].id","typeLabel":"string"}},"type":"object","description":"The unique phone numbers given as arguments in the job creation.","uniqueKey":"data.phone_numbers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.phone_numbers","typeLabel":"object[]"},"successful_operations":{"type":"array","items":{"properties":{"phone_number":{"type":"string","description":"The phone number in e164 format.","uniqueKey":"data.successful_operations.items.[INDEX].phone_number","typeLabel":"string"},"id":{"type":"string","description":"The phone number's ID","uniqueKey":"data.successful_operations.items.[INDEX].id","typeLabel":"string"}},"type":"object","description":"The phone numbers successfully updated.","uniqueKey":"data.successful_operations.items.[INDEX]","typeLabel":"object"},"readOnly":true,"uniqueKey":"data.successful_operations","typeLabel":"object[]"},"pending_operations":{"type":"array","items":{"properties":{"phone_number":{"type":"string","description":"The phone number in e164 format.","uniqueKey":"data.pending_operations.items.[INDEX].phone_number","typeLabel":"string"},"id":{"type":"string","description":"The phone number's ID","uniqueKey":"data.pending_operations.items.[INDEX].id","typeLabel":"string"}},"type":"object","description":"The phone numbers pending confirmation on update results. Entries in this list are transient, and will be moved to either successful_operations or failed_operations once the processing is done.","uniqueKey":"data.pending_operations.items.[INDEX]","typeLabel":"object"},"readOnly":true,"uniqueKey":"data.pending_operations","typeLabel":"object[]"},"failed_operations":{"type":"array","items":{"properties":{"phone_number":{"type":"string","description":"The phone number in e164 format.","uniqueKey":"data.failed_operations.items.[INDEX].phone_number","typeLabel":"string"},"id":{"type":"string","description":"The phone number's ID","uniqueKey":"data.failed_operations.items.[INDEX].id","typeLabel":"string"},"errors":{"type":"array","items":{"properties":{"code":{"type":"string","example":"10007","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","example":"Unexpected error","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"An unexpected error occured.","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"description":"JSON pointer (RFC6901) to the offending entity.","type":"string","example":"/base","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","type":"string","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].source","typeLabel":"object"},"meta":{"type":"object","properties":{"url":{"type":"string","description":"URL with additional information on the error.","example":"https://developers.telnyx.com/docs/overview/errors/10015","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].meta.url","typeLabel":"string"}},"uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX].meta","typeLabel":"object"}},"type":"object","uniqueKey":"data.failed_operations.items.[INDEX].errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.failed_operations.items.[INDEX].errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"data.failed_operations.items.[INDEX]","typeLabel":"object"},"readOnly":true,"uniqueKey":"data.failed_operations","typeLabel":"object[]"}},"example":{"id":"42587e44-3a3e-46de-9255-0c9a7a1d1ec7","record_type":"phone_numbers_job","status":"pending","type":"update_emergency_settings","etc":"2020-10-30T18:10:00.000Z","created_at":"2020-10-23T18:10:00.000Z","updated_at":"2020-10-23T18:10:01.000Z","phone_numbers":[{"id":"2637816387126861836"},{"phone_number":"+19715555098"},{"phone_number":"+19705555099"},{"id":"3388768018273"}],"successful_operations":[{"id":"2637816387126861836","phone_number":"+19705555098"},{"id":"33081887126861836","phone_number":"+19715555098"}],"pending_operations":[{"id":"2637816387126861837","phone_number":"+19705555099"}],"failed_operations":[{"id":"3388768018273","phone_number":"+19705551234","errors":[{"code":"10015","title":"Bad Request","detail":"The field is invalid.","source":{"pointer":"/emergency_address_id"}}]}]},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"Phone Numbers Job · object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"42587e44-3a3e-46de-9255-0c9a7a1d1ec7","record_type":"phone_numbers_job","status":"pending","type":"update_emergency_settings","etc":"2020-10-30T18:10:00.000Z","created_at":"2020-10-23T18:10:00.000Z","updated_at":"2020-10-23T18:10:01.000Z","phone_numbers":[{"id":"2637816387126861836"},{"phone_number":"+19715555098"},{"phone_number":"+19705555099"},{"id":"3388768018273"}],"successful_operations":[{"id":"2637816387126861836","phone_number":"+19705555098"},{"id":"33081887126861836","phone_number":"+19715555098"}],"pending_operations":[{"id":"2637816387126861837","phone_number":"+19705555099"}],"failed_operations":[{"id":"3388768018273","phone_number":"+19705551234","errors":[{"code":"10015","title":"Bad Request","detail":"The field is invalid.","source":{"pointer":"/emergency_address_id"}}]}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"a8743b02-7e6a-42fe-8111-96a76e3ed292":{"description":"Bad request, the request was unacceptable, often due to missing a required parameter.","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"properties":{"code":{"type":"string","example":"10007","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","example":"Unexpected error","uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"An unexpected error occured.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"description":"JSON pointer (RFC6901) to the offending entity.","type":"string","example":"/base","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","type":"string","uniqueKey":"errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"meta":{"type":"object","properties":{"url":{"type":"string","description":"URL with additional information on the error.","example":"https://developers.telnyx.com/docs/overview/errors/10015","uniqueKey":"errors.items.[INDEX].meta.url","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"10007","title":"Unexpected error","detail":"An unexpected error occured.","source":{"pointer":"/base","parameter":"\u003cstring>"},"meta":{"url":"https://developers.telnyx.com/docs/overview/errors/10015"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"89832c96-8daa-450b-946d-ac0c5989ed4a":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"properties":{"code":{"type":"string","example":"10007","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","example":"Unexpected error","uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"An unexpected error occured.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"description":"JSON pointer (RFC6901) to the offending entity.","type":"string","example":"/base","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","type":"string","uniqueKey":"errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"meta":{"type":"object","properties":{"url":{"type":"string","description":"URL with additional information on the error.","example":"https://developers.telnyx.com/docs/overview/errors/10015","uniqueKey":"errors.items.[INDEX].meta.url","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Authentication Failed":{"title":"Authentication Failed","value":{"errors":[{"code":"10009","title":"Authentication failed","detail":"Could not understand the provided credentials.","meta":{"url":"https://developers.telnyx.com/docs/overview/errors/10009"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"e84caf7f-051a-4b19-8994-f4ee5307a0fb":{"description":"Not Found","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"properties":{"code":{"type":"string","example":"10007","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","example":"Unexpected error","uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"An unexpected error occured.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"description":"JSON pointer (RFC6901) to the offending entity.","type":"string","example":"/base","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","type":"string","uniqueKey":"errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"meta":{"type":"object","properties":{"url":{"type":"string","description":"URL with additional information on the error.","example":"https://developers.telnyx.com/docs/overview/errors/10015","uniqueKey":"errors.items.[INDEX].meta.url","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Resource not found":{"title":"Resource not found","value":{"errors":[{"code":"10005","title":"Resource not found","detail":"The requested resource or URL could not be found.","source":{"pointer":"/base"},"meta":{"url":"https://developers.telnyx.com/docs/overview/errors/10005"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"0f92a7e8-ad99-4652-a4e4-a803d9d7faed":{"description":"Unprocessable entity. Check the 'detail' field in response for details.","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"properties":{"code":{"type":"string","example":"10007","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","example":"Unexpected error","uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"An unexpected error occured.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"description":"JSON pointer (RFC6901) to the offending entity.","type":"string","example":"/base","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","type":"string","uniqueKey":"errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"meta":{"type":"object","properties":{"url":{"type":"string","description":"URL with additional information on the error.","example":"https://developers.telnyx.com/docs/overview/errors/10015","uniqueKey":"errors.items.[INDEX].meta.url","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"10007","title":"Unexpected error","detail":"An unexpected error occured.","source":{"pointer":"/base","parameter":"\u003cstring>"},"meta":{"url":"https://developers.telnyx.com/docs/overview/errors/10015"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"faeca309-e6da-4405-83ac-659f3829b272":{"description":"Unexpected error","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"properties":{"code":{"type":"string","example":"10007","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","example":"Unexpected error","uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"An unexpected error occured.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"description":"JSON pointer (RFC6901) to the offending entity.","type":"string","example":"/base","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","type":"string","uniqueKey":"errors.items.[INDEX].source.parameter","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"meta":{"type":"object","properties":{"url":{"type":"string","description":"URL with additional information on the error.","example":"https://developers.telnyx.com/docs/overview/errors/10015","uniqueKey":"errors.items.[INDEX].meta.url","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"10007","title":"Unexpected error","detail":"An unexpected error occured.","source":{"pointer":"/base","parameter":"\u003cstring>"},"meta":{"url":"https://developers.telnyx.com/docs/overview/errors/10015"}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"dd71d752-347f-4ca5-a940-a55be620c8e2":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"8c117ac9-aeb7-4421-8421-f4d9591c06ba":{"url":"https://api.telnyx.com/v2","description":"Version 2.0.0 of the Telnyx API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi/source/external/numbers/numbers.json"},"subdomain":"telnyx","siteName":"Telnyx","title":"Retrieve a phone numbers job - Telnyx","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T13:23:47.354Z","originalFileLocation":"api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job.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=\"Returns the status and details of the phone-number background job identified by id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Telnyx\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_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/telnyx/MhCJ9JWG11MInbt6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a phone numbers job - Telnyx\">\u003cmeta data-mint-head property=\"og:description\" content=\"Infrastructure for real-time agents. Voice, AI, Edge Compute\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Telnyx\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://telnyx.mintlify.site/_mintlify/api/og/v2?division=Bulk+Phone+Number+Operations+API\u0026amp;title=Retrieve+a+phone+numbers+job\u0026amp;description=Returns+the+status+and+details+of+the+phone-number+background+job+identified+by+%60id%60.\u0026amp;theme=0dd46d2166d1a00e34819206\u0026amp;signature=6b5fd84d5518c7fb14f7e374348d2fed450ca53cf4dc7b35a18cbcefbe418671\">\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 phone numbers job - Telnyx\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Infrastructure for real-time agents. Voice, AI, Edge Compute\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://telnyx.mintlify.site/_mintlify/api/og/v2?division=Bulk+Phone+Number+Operations+API\u0026amp;title=Retrieve+a+phone+numbers+job\u0026amp;description=Returns+the+status+and+details+of+the+phone-number+background+job+identified+by+%60id%60.\u0026amp;theme=0dd46d2166d1a00e34819206\u0026amp;signature=6b5fd84d5518c7fb14f7e374348d2fed450ca53cf4dc7b35a18cbcefbe418671\">\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/telnyx/MhCJ9JWG11MInbt6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Telnyx\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00B688\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://telnyx.com/#organization\",\"name\":\"Telnyx\",\"url\":\"https://telnyx.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://telnyx.com/favicon.ico\"},\"sameAs\":[\"https://x.com/telnyx\",\"https://www.linkedin.com/company/telnyx/\",\"https://github.com/team-telnyx\"]},{\"@type\":\"WebSite\",\"@id\":\"https://developers.telnyx.com#website\",\"name\":\"Telnyx\",\"url\":\"https://developers.telnyx.com\",\"publisher\":{\"@id\":\"https://telnyx.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job#webpage\",\"url\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job\",\"name\":\"Retrieve a phone numbers job\",\"description\":\"Returns the status and details of the phone-number background job identified by id.\",\"dateModified\":\"2026-10-21T13:23:47.354Z\",\"isPartOf\":{\"@id\":\"https://developers.telnyx.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Management \u0026 Configurations\",\"item\":\"https://developers.telnyx.com/api-reference/phone-number-blocks-background-jobs/lists-the-phone-number-blocks-jobs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Management \u0026 Configurations API\",\"item\":\"https://developers.telnyx.com/api-reference/phone-number-blocks-background-jobs/lists-the-phone-number-blocks-jobs\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Bulk Phone Number Operations API\",\"item\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/lists-the-phone-numbers-jobs\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Retrieve a phone numbers job\",\"item\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job#apireference\",\"headline\":\"Retrieve a phone numbers job\",\"name\":\"Retrieve a phone numbers job\",\"description\":\"Returns the status and details of the phone-number background job identified by id.\",\"url\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job\",\"mainEntityOfPage\":{\"@id\":\"https://developers.telnyx.com/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job#webpage\"},\"dateModified\":\"2026-10-21T13:23:47.354Z\",\"publisher\":{\"@id\":\"https://telnyx.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.telnyx.com#website\"}}]}\u003c/script>","siteName":"Telnyx","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/docs/overview"}]},"products":[{"product":"Home","icon":"house","pages":[{"title":"Home","href":"/docs/overview"}]},{"product":"Other APIs","icon":"ellipsis","pages":[{"title":"Other APIs","href":"/docs/other-apis"}]},{"product":"Agent Platform","icon":"circle-nodes","pages":[{"title":"Agent Platform","href":"/docs/agent-platform"}]},{"product":"AI","icon":"microchip-ai","pages":[{"title":"AI","href":"/docs/inference/models"}]},{"product":"Voice","icon":"waveform","pages":[{"title":"Voice","href":"/docs/voice/overview"}]},{"product":"Compute","icon":"server","pages":[{"title":"Compute","href":"/docs/edge-compute/platform-overview"}]},{"product":"Storage","icon":"hard-drive","pages":[{"title":"Storage","href":"/docs/cloud-storage/overview"}]},{"product":"Virtual Private Cloud","icon":"cloud","pages":[{"title":"Virtual Private Cloud","href":"/docs/virtual-private-cloud"}]},{"product":"Calling","icon":"phone","pages":[{"title":"Calling","href":"/docs/voice/programmable-voice/voice-api-fundamentals"}]},{"product":"Messaging","icon":"message","pages":[{"title":"Messaging","href":"/docs/messaging/messages/send-message"}]},{"product":"Numbers","icon":"hashtag","tabs":[{"tab":"Global Phone Numbers","icon":"globe","groups":[{"group":"Coverage","pages":[{"title":"Fundamentals - Searching + Ordering Phone Numbers","sidebarTitle":"Getting started with Telnyx phone number APIs","href":"/docs/numbers/phone-numbers/getting-started"},{"group":"Coverage API","pages":[{"group":"Country Coverage API","pages":[{"title":"Get country coverage","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /country_coverage","href":"/api-reference/country-coverage/get-country-coverage"},{"title":"Get coverage for a specific country","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /country_coverage/countries/{country_code}","href":"/api-reference/country-coverage/get-coverage-for-a-specific-country"}]},{"group":"Inventory Level API","pages":[{"title":"Create an inventory coverage request","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /inventory_coverage","href":"/api-reference/inventory-level/create-an-inventory-coverage-request"}]}]}]},{"group":"Searching","pages":[{"title":"Number Search","sidebarTitle":"Number search","href":"/docs/numbers/phone-numbers/number-search/index"},{"group":"Searching API","pages":[{"group":"Phone Number Search API","pages":[{"title":"List available phone number blocks","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /available_phone_number_blocks","href":"/api-reference/phone-number-search/list-available-phone-number-blocks"},{"title":"List available phone numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /available_phone_numbers","href":"/api-reference/phone-number-search/list-available-phone-numbers"}]},{"group":"numbers features API","pages":[{"title":"Retrieve the features for a list of numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /numbers_features","href":"/api-reference/numbers-features/retrieve-the-features-for-a-list-of-numbers"}]}]}]},{"group":"Ordering","pages":[{"title":"Number Reservations","sidebarTitle":"Number reservations","href":"/docs/numbers/phone-numbers/number-reservations/index"},{"title":"Number Orders","sidebarTitle":"Number orders","href":"/docs/numbers/phone-numbers/number-orders/index"},{"title":"Advanced Orders","sidebarTitle":"Advanced Orders","href":"/docs/numbers/phone-numbers/advanced-orders/index"},{"title":"Bulk number orders","sidebarTitle":"Bulk orders","href":"/docs/numbers/phone-numbers/bulk-ordering/index"},{"group":"Ordering API","pages":[{"group":"Phone Number Reservations API","pages":[{"title":"List number reservations","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_reservations","href":"/api-reference/phone-number-reservations/list-number-reservations"},{"title":"Create a number reservation","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /number_reservations","href":"/api-reference/phone-number-reservations/create-a-number-reservation"},{"title":"Retrieve a number reservation","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_reservations/{number_reservation_id}","href":"/api-reference/phone-number-reservations/retrieve-a-number-reservation"},{"title":"Extend a number reservation","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /number_reservations/{number_reservation_id}/actions/extend","href":"/api-reference/phone-number-reservations/extend-a-number-reservation"}]},{"group":"Phone Number Orders API","pages":[{"title":"List number orders","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_orders","href":"/api-reference/phone-number-orders/list-number-orders"},{"title":"Create a number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /number_orders","href":"/api-reference/phone-number-orders/create-a-number-order"},{"title":"Retrieve a number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_orders/{number_order_id}","href":"/api-reference/phone-number-orders/retrieve-a-number-order"},{"title":"Update a number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /number_orders/{number_order_id}","href":"/api-reference/phone-number-orders/update-a-number-order"},{"title":"Retrieve a list of phone numbers associated to orders","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_order_phone_numbers","href":"/api-reference/phone-number-orders/retrieve-a-list-of-phone-numbers-associated-to-orders"},{"title":"Retrieve a single phone number within a number order.","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_order_phone_numbers/{number_order_phone_number_id}","href":"/api-reference/phone-number-orders/retrieve-a-single-phone-number-within-a-number-order"},{"title":"Update requirements for a single phone number within a number order.","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /number_order_phone_numbers/{number_order_phone_number_id}","href":"/api-reference/phone-number-orders/update-requirements-for-a-single-phone-number-within-a-number-order"},{"title":"List sub number orders","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /sub_number_orders","href":"/api-reference/phone-number-orders/list-sub-number-orders"},{"title":"Retrieve a sub number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /sub_number_orders/{sub_number_order_id}","href":"/api-reference/phone-number-orders/retrieve-a-sub-number-order"},{"title":"Update a sub number order's requirements","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /sub_number_orders/{sub_number_order_id}","href":"/api-reference/phone-number-orders/update-a-sub-number-orders-requirements"},{"title":"Cancel a sub number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /sub_number_orders/{sub_number_order_id}/cancel","href":"/api-reference/phone-number-orders/cancel-a-sub-number-order"},{"title":"Create a sub number orders report","deprecated":null,"version":null,"openapi":"/openapi/source/external/legacy-published/numbers-identity/ordering.json post /sub_number_orders/report","href":"/api-reference/phone-number-orders/create-a-sub-number-orders-report"},{"title":"Retrieve a sub number orders report","deprecated":null,"version":null,"openapi":"/openapi/source/external/legacy-published/numbers-identity/ordering.json get /sub_number_orders/report/{report_id}","href":"/api-reference/phone-number-orders/retrieve-a-sub-number-orders-report"},{"title":"Download a sub number orders report","deprecated":null,"version":null,"openapi":"/openapi/source/external/legacy-published/numbers-identity/ordering.json get /sub_number_orders/report/{report_id}/download","href":"/api-reference/phone-number-orders/download-a-sub-number-orders-report"},{"title":"Retrieve all comments","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /comments","href":"/api-reference/phone-number-orders/retrieve-all-comments"},{"title":"Create a comment","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /comments","href":"/api-reference/phone-number-orders/create-a-comment"},{"title":"Retrieve a comment","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /comments/{id}","href":"/api-reference/phone-number-orders/retrieve-a-comment"},{"title":"Mark a comment as read","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /comments/{id}/read","href":"/api-reference/phone-number-orders/mark-a-comment-as-read"}]},{"group":"Phone Number Block Orders API","pages":[{"title":"List number block orders","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_block_orders","href":"/api-reference/phone-number-block-orders/list-number-block-orders"},{"title":"Create a number block order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /number_block_orders","href":"/api-reference/phone-number-block-orders/create-a-number-block-order"},{"title":"Retrieve a number block order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /number_block_orders/{number_block_order_id}","href":"/api-reference/phone-number-block-orders/retrieve-a-number-block-order"}]},{"group":"Requirement Groups API","pages":[{"title":"Update requirement group for a phone number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /number_order_phone_numbers/{id}/requirement_group","href":"/api-reference/requirement-groups/update-requirement-group-for-a-phone-number-order"},{"title":"Update requirement group for a sub number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /sub_number_orders/{id}/requirement_group","href":"/api-reference/requirement-groups/update-requirement-group-for-a-sub-number-order"},{"title":"Get action requirement details for a sub number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /external_requirements/{regulatory_requirement_id}/sub_number_orders/{sub_number_order_id}","href":"/api-reference/requirement-groups/get-action-requirement-details-for-a-sub-number-order"},{"title":"Fulfill an action requirement for a sub number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /external_requirements/{regulatory_requirement_id}/sub_number_orders/{sub_number_order_id}","href":"/api-reference/requirement-groups/fulfill-an-action-requirement-for-a-sub-number-order"}]},{"group":"Advanced Number Orders API","pages":[{"title":"List Advanced Orders","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /advanced_orders","href":"/api-reference/advanced-number-orders/list-advanced-orders"},{"title":"Create Advanced Order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /advanced_orders","href":"/api-reference/advanced-number-orders/create-advanced-order"},{"title":"Update Advanced Order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /advanced_orders/{advanced-order-id}/requirement_group","href":"/api-reference/advanced-number-orders/update-advanced-order"},{"title":"Get Advanced Order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /advanced_orders/{order_id}","href":"/api-reference/advanced-number-orders/get-advanced-order"}]},{"group":"Inexplicit Number Orders API","pages":[{"title":"List inexplicit number orders","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /inexplicit_number_orders","href":"/api-reference/inexplicit-number-orders/list-inexplicit-number-orders"},{"title":"Create an inexplicit number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /inexplicit_number_orders","href":"/api-reference/inexplicit-number-orders/create-an-inexplicit-number-order"},{"title":"Retrieve an inexplicit number order","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /inexplicit_number_orders/{id}","href":"/api-reference/inexplicit-number-orders/retrieve-an-inexplicit-number-order"}]},{"group":"Callbacks API","pages":[{"title":"Number order status update","version":null,"deprecated":null,"openapi":"/openapi/source/external/numbers/numbers.json webhook numberOrderStatusUpdate","href":"/api-reference/callbacks/number-order-status-update"}]}]}]},{"group":"Management \u0026 Configurations","pages":[{"group":"Management \u0026 Configurations API","pages":[{"group":"Phone Number Blocks Background Jobs API","pages":[{"title":"Lists the phone number blocks jobs","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_number_blocks/jobs","href":"/api-reference/phone-number-blocks-background-jobs/lists-the-phone-number-blocks-jobs"},{"title":"Retrieves a phone number blocks job","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_number_blocks/jobs/{id}","href":"/api-reference/phone-number-blocks-background-jobs/retrieves-a-phone-number-blocks-job"},{"title":"Deletes all numbers associated with a phone number block","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_number_blocks/jobs/delete_phone_number_block","href":"/api-reference/phone-number-blocks-background-jobs/deletes-all-numbers-associated-with-a-phone-number-block"}]},{"group":"Phone Number Configurations API","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers","href":"/api-reference/phone-number-configurations/list-phone-numbers"},{"title":"Delete a phone number","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json delete /phone_numbers/{id}","href":"/api-reference/phone-number-configurations/delete-a-phone-number"},{"title":"Retrieve a phone number","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/{id}","href":"/api-reference/phone-number-configurations/retrieve-a-phone-number"},{"title":"Update a phone number","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /phone_numbers/{id}","href":"/api-reference/phone-number-configurations/update-a-phone-number"},{"title":"Change the bundle status for a phone number (set to being in a bundle or remove from a bundle)","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /phone_numbers/{id}/actions/bundle_status_change","href":"/api-reference/phone-number-configurations/change-the-bundle-status-for-a-phone-number-set-to-being-in-a-bundle-or-remove-from-a-bundle"},{"title":"Enable emergency for a phone number","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_numbers/{id}/actions/enable_emergency","href":"/api-reference/phone-number-configurations/enable-emergency-for-a-phone-number"},{"title":"Retrieve a phone number with voice settings","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/{id}/voice","href":"/api-reference/phone-number-configurations/retrieve-a-phone-number-with-voice-settings"},{"title":"Update a phone number with voice settings","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json patch /phone_numbers/{id}/voice","href":"/api-reference/phone-number-configurations/update-a-phone-number-with-voice-settings"},{"title":"Verify ownership of phone numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_numbers/actions/verify_ownership","href":"/api-reference/phone-number-configurations/verify-ownership-of-phone-numbers"},{"title":"Slim List phone numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/slim","href":"/api-reference/phone-number-configurations/slim-list-phone-numbers"},{"title":"List phone numbers with voice settings","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/voice","href":"/api-reference/phone-number-configurations/list-phone-numbers-with-voice-settings"}]},{"group":"CSV Downloads API","pages":[{"title":"List CSV downloads","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/csv_downloads","href":"/api-reference/csv-downloads/list-csv-downloads"},{"title":"Create a CSV download","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_numbers/csv_downloads","href":"/api-reference/csv-downloads/create-a-csv-download"},{"title":"Retrieve a CSV download","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/csv_downloads/{id}","href":"/api-reference/csv-downloads/retrieve-a-csv-download"}]},{"group":"Bulk Phone Number Operations API","pages":[{"title":"Lists the phone numbers jobs","description":"Returns background jobs that operate on phone numbers. Filter by job type, target phone numbers, job status, or creation-time customer reference, and sort by creation time. Multiple phone-number or status values use OR semantics within that filter; different filter categories use AND semantics. Results include pagination metadata.","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/jobs","href":"/api-reference/bulk-phone-number-operations/lists-the-phone-numbers-jobs"},{"title":"Retrieve a phone numbers job","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json get /phone_numbers/jobs/{id}","href":"/api-reference/bulk-phone-number-operations/retrieve-a-phone-numbers-job"},{"title":"Delete a batch of numbers","description":"Creates a new background job to delete a batch of numbers. At most one thousand numbers can be updated per API call.","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_numbers/jobs/delete_phone_numbers","href":"/api-reference/bulk-phone-number-operations/delete-a-batch-of-numbers"},{"title":"Update the emergency settings from a batch of numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_numbers/jobs/update_emergency_settings","href":"/api-reference/bulk-phone-number-operations/update-the-emergency-settings-from-a-batch-of-numbers"},{"title":"Update a batch of numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/numbers/numbers.json post /phone_numbers/jobs/update_phone_numbers","href":"/api-reference/bulk-phone-number-operations/update-a-batch-of-numbers"}]},{"group":"Regulatory Requirements API","pages":[{"title":"Retrieve regulatory requirements for a list of phone numbers","deprecated":null,"version":null,"openapi":"/openapi/source/external/legacy-published/numbers-identity/management-config.json get /phone_numbers/regulatory_requirements","href":"/api-reference/regulatory-requirements/retrieve-regulatory-requirements-for-a-list-of-phone-numbers"}]}]}]},{"group":"For AI Agents","pages":[{"title":"Global Phone Numbers llms.txt","sidebarTitle":"Global Phone Numbers llms txt","href":"/docs/development/llms/numbers-global-phone-numbers-llms-txt/index"},{"title":"Global Phone Numbers llms-full.txt","sidebarTitle":"Global Phone Numbers llms full txt","href":"/docs/development/llms/numbers-global-phone-numbers-llms-full-txt/index"}]}]},{"tab":"Porting","icon":"right-left","pages":[{"title":"Porting","href":"/docs/numbers/porting/getting-started"}]},{"tab":"Regulatory \u0026 Documents","icon":"file-certificate","pages":[{"title":"Regulatory \u0026 Documents","href":"/docs/numbers/phone-numbers/regulatory-requirements"}]},{"tab":"Identity","icon":"fingerprint","pages":[{"title":"Identity","href":"/docs/identity/number-lookup"}]},{"tab":"Number Reputation","icon":"shield-check","pages":[{"title":"Number Reputation","href":"/docs/number-reputation/overview"}]}]},{"product":"Wireless","icon":"broadcast-tower","pages":[{"title":"Wireless","href":"/docs/iot-sim/wireless-overview"}]}]},"basePath":"","title":"Retrieve a phone numbers job - Telnyx","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["10e4515597","c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["BannerMarkdown-DcUtcwZ_.js","dist-CJ9Oly2E.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-C5EfhVm0.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CxAy5y67.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","AssistantPageLink-Mk6P3qvh.js"]}