Retrieve the details of a specific certificate request by its cert_req_* id.
Remember to include the X-API-Version: 2026-11-01 header. Certificate-request
endpoints are live-only — using a sk_test_* key returns
TESTMODE_NOT_SUPPORTED. Requests outside your account return
CERTIFICATE_REQUEST_NOT_FOUND (404) — Numeral never leaks the existence of
another tenant’s resources.
Public lifecycle state of a certificate request. The internal status enum is narrower in the public vocabulary on purpose — processing collapses to pending, failed collapses to invalid.
The specific Customer record linked to this request. null when no live Customer has been associated yet (a master buyer may still be present — see linked_buyer).
The master buyer entity that owns this request. Populated whenever the request has a master-buyer reference, even when no Customer record has been linked yet. Prefer this over customer for rendering "who owns this request".
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Numeral API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/numeralhq/w35K7dUKWBDiixfd/logo/logo.svg?fit=max\u0026auto=format\u0026n=w35K7dUKWBDiixfd\u0026q=85\u0026s=2330fe2568887c273331c4846f7a4d1e","dark":"https://mintcdn.com/numeralhq/w35K7dUKWBDiixfd/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=w35K7dUKWBDiixfd\u0026q=85\u0026s=3c46c5bdc314577d1ce3660b957c0ad8"},"favicon":"https://mintcdn.com/numeralhq/NAgHCHKl6ucev5Pu/favicon.ico?fit=max\u0026auto=format\u0026n=NAgHCHKl6ucev5Pu\u0026q=85\u0026s=a6ecac944d1933a8432a8b2234eed9a4","api":{"openapi":["api-reference/v2026-03-01/openapi.json","api-reference/v2026-01-01/openapi.json","api-reference/v2025-05-12/openapi.json","api-reference/v2024-09-01/openapi.json","api-reference/v2026-11-01/openapi.json"]},"navbar":{"links":[{"href":"mailto:hi@mintlify.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.mintlify.com"}},"interaction":{"drilldown":false},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"numeralhq","hasAudioNarration":false,"actualSubdomain":"numeralhq","customDomains":["docs.numeral.com"],"gitSource":{"type":"github","owner":"numeralhq","repo":"tax-engine-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae27c81d56b3c07efab159a","collectionId":"623087f7-94a8-47ab-94bd-032bc5ea9868","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae27c81d56b3c07efab159a"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae27c81d56b3c07efab159a","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":56},{"language":"default","tag":"Integrations","count":53},{"language":"default","tag":"Platform Integrations","count":48},{"language":"default","tag":"API Reference","count":46},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Stripe","count":8},{"language":"default","tag":"Numeral for Stripe Checkout","count":6},{"language":"default","tag":"Integration Guides","count":5},{"language":"default","tag":"Shopify","count":5},{"language":"default","tag":"MCP","count":5}]},"assistantConfig":{},"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":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"src/style.css","content":".text-gray-100{color:#c1c2c5}[class*=max-w-8xl]{max-width:112rem!important}#content-container{max-width:none!important}td:first-child code{white-space:nowrap}"},{"filePath":"src/resource-pages.css","content":".sx-section{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:3rem;padding:2.5rem 0;border-top:1px solid rgb(127 127 127/.2)}.sx-section:first-of-type{border-top:none;padding-top:0}.sx-right{position:sticky;top:8rem;align-self:start;max-height:calc(100vh - 9rem);overflow-y:auto}.sx-wide{grid-template-columns:minmax(0,1fr);gap:0}.sx-wide .sx-right{position:static;max-height:none}.sx-wide td code{white-space:nowrap}.sx-left>h2:first-child{margin-top:0}@media (max-width:1024px){.sx-section{grid-template-columns:minmax(0,1fr)}.sx-right{position:static;max-height:none}}.sx-endpoints{border:1px solid rgb(127 127 127/.25);border-radius:.75rem;padding:.75rem 1rem .25rem}.sx-endpoints-title{font-size:.75rem;font-weight:600;text-transform:uppercase;letter-spacing:.05em;opacity:.7;margin-bottom:.5rem}div.sx-endpoints a{display:block;position:relative;font-family:inherit;font-size:inherit;padding:.6rem 1.5rem .6rem 0;border-top:1px solid rgb(127 127 127/.2);border-bottom:none!important;text-decoration:none}.sx-endpoints a::after{content:\"›\";position:absolute;right:.25rem;top:50%;transform:translateY(-50%);font-size:1.25rem;opacity:.5}.sx-endpoints a:hover::after{opacity:1}.sx-ep-name{display:block;font-weight:600;font-size:.9rem}.sx-ep-path{display:block;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.8rem;margin-top:.15rem}.sx-ep-url{opacity:.65}.sx-endpoints .sx-method{display:inline-block;min-width:3.75rem;margin-right:0;font-weight:700}.sx-endpoints .sx-get{color:#3b82f6}.sx-endpoints .sx-post{color:#16a34a}.sx-endpoints .sx-delete{color:#ef4444}.sx-nav-sub{list-style:none;margin:.15rem 0 .5rem;padding:0 0 0 1.75rem}.sx-nav-sub a{display:flex;align-items:baseline;gap:.5rem;padding:.3rem .5rem;border-radius:.5rem;font-size:.8125rem;line-height:1.3;opacity:.7}.sx-nav-sub a.sx-current,.sx-nav-sub a:hover{opacity:1;background:rgb(127 127 127/.1)}.sx-nav-sub a:focus{outline:0}.sx-nav-sub a:focus-visible{outline:2px solid rgb(127 127 127/.5)}.sx-nav-method.sx-nav-spacer{visibility:hidden}.sx-nav-method{flex:none;min-width:2.4rem;padding:.05rem .3rem;border-radius:.3rem;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.625rem;font-weight:700;text-align:center}.sx-nav-method.sx-get{color:#3b82f6;background:rgb(59 130 246/.15)}.sx-nav-method.sx-post{color:#16a34a;background:rgb(22 163 74/.15)}.sx-nav-method.sx-delete{color:#ef4444;background:rgb(239 68 68/.15)}.sx-page-end{height:4rem}.sx-children,.sx-toggle{border:1px solid rgb(127 127 127/.3)}.sx-toggle{margin-top:.75rem;border-radius:9999px;padding:.3rem .9rem;font-size:.85rem;font-weight:500;white-space:pre;cursor:pointer}.sx-toggle.sx-open{border-radius:.75rem .75rem 0 0;border-bottom:none}.sx-children{border-radius:0 .75rem .75rem .75rem;padding:0 1rem .5rem}.sx-children[hidden]{border:0;padding:0}"}],"page":{"pagePath":"api-reference/v2026-11-01/endpoint/get_certificate_request","slug":"/api-reference/v2026-11-01/endpoint/get_certificate_request","pageMetadata":{"title":"Get Certificate Request","openapi":"api-reference/v2026-11-01/openapi.json GET /tax/certificate-requests/{request_id}","description":"Retrieve a single certificate request by id. Live-only.","href":"/api-reference/v2026-11-01/endpoint/get_certificate_request"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a single certificate request by id. Live-only.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`get-certificate-request-2026-11-01`,children:`Get Certificate Request (2026-11-01)`}),`\n`,_jsxs(_components.p,{children:[`Retrieve the details of a specific certificate request by its `,_jsx(_components.code,{children:`cert_req_*`}),` id.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Remember to include the `,_jsx(_components.code,{children:`X-API-Version: 2026-11-01`}),` header. Certificate-request\nendpoints are live-only — using a `,_jsx(_components.code,{children:`sk_test_*`}),` key returns\n`,_jsx(_components.code,{children:`TESTMODE_NOT_SUPPORTED`}),`. Requests outside your account return\n`,_jsx(_components.code,{children:`CERTIFICATE_REQUEST_NOT_FOUND`}),` (404) — Numeral never leaks the existence of\nanother tenant’s resources.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Certificate Request","openapi":"api-reference/v2026-11-01/openapi.json GET /tax/certificate-requests/{request_id}","description":"Retrieve a single certificate request by id. Live-only.","href":"/api-reference/v2026-11-01/endpoint/get_certificate_request"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get Certificate Request (2026-11-01)","slug":"get-certificate-request-2026-11-01","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/numeralhq/f4a41b99b7afe396/src/version-refresh.js","/_mintlify/custom/numeralhq/4721c15820461e09/src/resource-pages.js"],"openApiReferenceData":{"operation":{"summary":"Get Certificate Request","description":"Retrieve a single certificate request by id. Live-only.","operationId":"getCertificateRequest_v20261101","parameters":["15d3ce3d-d016-41a5-9971-46d793e098d9","8859309c-cbb5-4534-b7c7-d8af954ab4ee"],"responses":{"200":"3eba93fa-c4cc-4a31-951c-b939fb430eb8","400":"81fc1576-2b08-4086-88c6-df0eee33ad5d"},"method":"get","type":"path","servers":["d3db3deb-e04d-4d36-bd09-6cab37404789"],"security":["b4782b25-0821-4684-a511-1dad9c1762cf"],"path":"/tax/certificate-requests/{request_id}","baseUrlOptions":["https://api.numeralhq.com/"],"title":"Get Certificate Request","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"15d3ce3d-d016-41a5-9971-46d793e098d9":{"name":"X-API-Version","in":"header","required":true,"schema":{"type":"string","enum":["2026-11-01"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"8859309c-cbb5-4534-b7c7-d8af954ab4ee":{"name":"request_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"3eba93fa-c4cc-4a31-951c-b939fb430eb8":{"description":"Certificate request","content":{"application/json":{"schema":{"type":"object","description":"A single certificate request.","properties":{"id":{"type":"string","description":"The ID of the certificate request","example":"cert_req_b2f1e4a3-9c0d-4e7a-8b1f-2d5a6e7b8c9d","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","description":"The type of object: `tax.certificate_request`","example":"tax.certificate_request","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"status":{"type":"string","enum":["pending","fulfilled","canceled","invalid"],"description":"Public lifecycle state of a certificate request. The internal status enum is narrower in the public vocabulary on purpose — `processing` collapses to `pending`, `failed` collapses to `invalid`.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"customer":{"oneOf":[{"type":"object","description":"The specific `Customer` record linked to this request. `null` when no live Customer has been associated yet (a master buyer may still be present — see `linked_buyer`).","required":["id","reference_customer_id","name"],"properties":{"id":{"type":"string","example":"cust_6126acaf-7379-411a-8ada-00005bac0715","isRequired":true,"uniqueKey":"customer.oneOf.0.id","typeLabel":"string"},"reference_customer_id":{"oneOf":[{"type":"string","example":"20506","isRequired":true,"uniqueKey":"customer.oneOf.0.reference_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","example":"20506","isRequired":true,"uniqueKey":"customer.oneOf.0.reference_customer_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.oneOf.0.reference_customer_id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Display name for the linked customer. Populated from `Customer.name`; falls back to the master buyer's `legal_name` if the customer record has no name of its own. `null` only when neither is set.","example":"Acme Co","isRequired":true,"uniqueKey":"customer.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Display name for the linked customer. Populated from `Customer.name`; falls back to the master buyer's `legal_name` if the customer record has no name of its own. `null` only when neither is set.","example":"Acme Co","isRequired":true,"uniqueKey":"customer.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.oneOf.0.name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"customer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"customer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer","typeLabel":"object | null"},"linked_buyer":{"oneOf":[{"type":"object","description":"The master buyer entity that owns this request. Populated whenever the request has a master-buyer reference, even when no `Customer` record has been linked yet. Prefer this over `customer` for rendering \"who owns this request\".","required":["id","legal_name"],"properties":{"id":{"type":"string","description":"Stable numeric id of the master buyer.","example":"12345","isRequired":true,"uniqueKey":"linked_buyer.oneOf.0.id","typeLabel":"string"},"legal_name":{"oneOf":[{"type":"string","example":"Acme Co","isRequired":true,"uniqueKey":"linked_buyer.oneOf.0.legal_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Acme Co","isRequired":true,"uniqueKey":"linked_buyer.oneOf.0.legal_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"linked_buyer.oneOf.0.legal_name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"linked_buyer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"linked_buyer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"linked_buyer","typeLabel":"object | null"},"certificate_id":{"oneOf":[{"type":"string","description":"Populated only when `status === \"fulfilled\"`. The `cert_*` id of the submitted certificate.","example":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","isRequired":true,"uniqueKey":"certificate_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Populated only when `status === \"fulfilled\"`. The `cert_*` id of the submitted certificate.","example":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","isRequired":true,"uniqueKey":"certificate_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificate_id","typeLabel":"string | null"},"certificate_type_id":{"oneOf":[{"type":"string","description":"Stable identifier of the requested certificate type, e.g. `US-CA-CDTFA-230`.","example":"US-CA-CDTFA-230","isRequired":true,"uniqueKey":"certificate_type_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Stable identifier of the requested certificate type, e.g. `US-CA-CDTFA-230`.","example":"US-CA-CDTFA-230","isRequired":true,"uniqueKey":"certificate_type_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificate_type_id","typeLabel":"string | null"},"jurisdictions":{"type":"array","items":{"type":"string","uniqueKey":"jurisdictions.items.[INDEX]","typeLabel":"string"},"description":"Jurisdiction identifiers covered by the request.","example":["US-CA"],"isRequired":true,"uniqueKey":"jurisdictions","typeLabel":"string[]"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the request will auto-expire if not fulfilled. `null` if the request does not auto-expire.","isRequired":true,"uniqueKey":"expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the request will auto-expire if not fulfilled. `null` if the request does not auto-expire.","isRequired":true,"uniqueKey":"expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"expires_at","typeLabel":"string\u003cdate-time> | null"},"livemode":{"type":"boolean","enum":[true],"description":"Always `true` — these endpoints are live-only.","isRequired":true,"uniqueKey":"livemode","typeLabel":"enum\u003cboolean>"}},"required":["id","object","status","customer","linked_buyer","certificate_id","certificate_type_id","jurisdictions","created_at","updated_at","expires_at","livemode"],"uniqueKey":"","typeLabel":"object"},"example":{"id":"cert_req_b2f1e4a3-9c0d-4e7a-8b1f-2d5a6e7b8c9d","object":"tax.certificate_request","status":"fulfilled","customer":{"id":"cust_6126acaf-7379-411a-8ada-00005bac0715","reference_customer_id":"20506"},"certificate_id":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","certificate_type_id":"US-CA-CDTFA-230","jurisdictions":["US-CA"],"created_at":"2026-03-01T12:00:00Z","updated_at":"2026-03-02T09:30:00Z","expires_at":null,"livemode":true},"examples":{"Example":{"title":"Example","value":{"id":"cert_req_b2f1e4a3-9c0d-4e7a-8b1f-2d5a6e7b8c9d","object":"tax.certificate_request","status":"fulfilled","customer":{"id":"cust_6126acaf-7379-411a-8ada-00005bac0715","reference_customer_id":"20506"},"certificate_id":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","certificate_type_id":"US-CA-CDTFA-230","jurisdictions":["US-CA"],"created_at":"2026-03-01T12:00:00Z","updated_at":"2026-03-02T09:30:00Z","expires_at":null,"livemode":true}}},"exampleType":"examples"}},"exampleType":"examples"},"81fc1576-2b08-4086-88c6-df0eee33ad5d":{"description":"Unexpected error","content":{"application/json":{"schema":{"type":"object","description":"Standard error response format for API version 2026-01-01","properties":{"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","description":"Machine-readable error type","example":"MISSING_FIELD","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Required field 'address_country' is missing","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":400,"type":"MISSING_FIELD","message":"Required field 'address_country' is missing"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b4782b25-0821-4684-a511-1dad9c1762cf":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"d3db3deb-e04d-4d36-bd09-6cab37404789":{"url":"https://api.numeralhq.com/"}},"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":"api-reference/v2026-11-01/openapi.json"},"subdomain":"numeralhq","siteName":"Numeral API","title":"Get Certificate Request - Numeral API","navMaps":{"firstHrefInVersion":{"2026-11-01":{"href":"/api-reference/v2026-11-01/endpoint/get_certificate_request","matchLevel":0},"2026-03-01":{"href":"/introduction","matchLevel":4},"2026-01-01":{"href":"/introduction","matchLevel":4},"2025-05-12":{"href":"/introduction","matchLevel":4},"2024-09-01":{"href":"/introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T21:02:43.110Z","originalFileLocation":"api-reference/v2026-11-01/endpoint/get_certificate_request.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=\"Retrieve a single certificate request by id. Live-only.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Numeral API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Certificate Request - Numeral API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a single certificate request by id. Live-only.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Numeral API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.numeral.com/api-reference/v2026-11-01/endpoint/get_certificate_request\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://numeralhq.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Get+Certificate+Request\u0026amp;description=Retrieve+a+single+certificate+request+by+id.+Live-only.\u0026amp;theme=db0aa42568482bdcbfb10a73\u0026amp;signature=e94d69b1321dc3ef17c3b83435309444e242194f8a97e84e62f8a38a1105f622\">\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=\"Get Certificate Request - Numeral API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a single certificate request by id. Live-only.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://numeralhq.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Get+Certificate+Request\u0026amp;description=Retrieve+a+single+certificate+request+by+id.+Live-only.\u0026amp;theme=db0aa42568482bdcbfb10a73\u0026amp;signature=e94d69b1321dc3ef17c3b83435309444e242194f8a97e84e62f8a38a1105f622\">\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/numeralhq/T60dQ7B6WxiReCVN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Numeral API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.numeral.com/api-reference/v2026-11-01/endpoint/get_certificate_request\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2026-11-01/endpoint/get_certificate_request.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Numeral API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Numeral API","nav":{"global":null,"versions":[{"version":"2026-11-01","tabs":[{"tab":"API Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","icon":"hand-wave","href":"/introduction"},{"title":"Quickstart","icon":"rabbit","href":"/essentials/quickstart/quickstart"},{"title":"Changelog","icon":"wind","href":"/api-reference/v2026-11-01/changelog"},{"title":"API Keys","icon":"key","href":"/essentials/api-keys"},{"title":"API Versioning","icon":"code-branch","href":"/api-reference/versioning"},{"title":"Currencies","icon":"money-bill","href":"/essentials/currencies"},{"title":"Product Categories","icon":"tag","href":"/essentials/product-categories"},{"title":"Tax IDs","icon":"id-card","href":"/essentials/tax-ids"},{"title":"FAQs","icon":"question","href":"/essentials/faqs"},{"title":"AI help","icon":"robot","href":"/ai-help/overview"}]},{"group":"API Reference","pages":[{"title":"Introduction v2026-11-01","href":"/api-reference/v2026-11-01/introduction"},{"title":"Error Codes","icon":"triangle-exclamation","href":"/api-reference/v2026-11-01/error-codes"},{"title":"Calculations","icon":"calculator","mode":"wide","href":"/v2026-11-01/objects/calculations"},{"title":"Transactions","icon":"cash-register","mode":"wide","href":"/v2026-11-01/objects/transactions"},{"title":"Platform","icon":"store","mode":"wide","href":"/v2026-11-01/objects/platform"},{"title":"Merchants","icon":"store","mode":"wide","href":"/v2026-11-01/objects/merchants"},{"title":"Products","icon":"boxes-stacked","mode":"wide","href":"/v2026-11-01/objects/products"},{"title":"Customers","icon":"person","mode":"wide","href":"/v2026-11-01/objects/customers"},{"title":"Exemption (Resale) Certificates","icon":"file-certificate","mode":"wide","href":"/v2026-11-01/objects/exemption-certificates"},{"title":"Exchange Rates","icon":"money-bill-transfer","mode":"wide","href":"/v2026-11-01/objects/exchange-rates"},{"title":"Health Check","openapi":"api-reference/v2026-11-01/openapi.json GET /tax/ping","href":"/api-reference/v2026-11-01/endpoint/ping"}]}]},{"tab":"Integrations","groups":[{"group":"Integration Guides","pages":[{"title":"Reference Objects","icon":"link","href":"/essentials/integration-guides/reference-objects-faq"},{"title":"Managing Product Categories","icon":"bucket","href":"/essentials/integration-guides/products-and-categories"},{"title":"Exemptions Behavior","icon":"circle-xmark","href":"/essentials/integration-guides/exemptions-behavior"},{"title":"Submit Certificates via API","icon":"file-arrow-up","href":"/essentials/integration-guides/submit-certificates-via-api"},{"title":"Best Practices for a Successful Launch","icon":"circle-check","href":"/essentials/integration-guides/best-practices"}]},{"group":"Platform Integrations","pages":[{"title":"Integrations Overview","href":"/integrations/overview"},{"title":"Marketplaces","href":"/integrations/marketplaces"},{"title":"HR Systems","href":"/integrations/hr-systems"},{"title":"Acumatica","href":"/integrations/acumatica"},{"title":"Adobe Commerce","href":"/integrations/adobe-commerce"},{"title":"BigCommerce","href":"/integrations/bigcommerce"},{"title":"Microsoft Business Central","href":"/integrations/business-central"},{"title":"Campfire","href":"/integrations/campfire"},{"title":"Chargebee","href":"/integrations/chargebee"},{"title":"CheckoutChamp","href":"/integrations/checkoutchamp"},{"title":"Fulfil","href":"/integrations/fulfil"},{"title":"HubSpot","href":"/integrations/hubspot"},{"title":"Infor M3","href":"/integrations/infor-m3"},{"title":"JustPaid","href":"/integrations/justpaid"},{"title":"Maxio","href":"/integrations/maxio"},{"title":"Measure","href":"/integrations/measure"},{"title":"NetSuite","href":"/integrations/netsuite"},{"title":"Odoo","href":"/integrations/odoo"},{"title":"Orb","href":"/integrations/orb"},{"title":"QuickBooks Online","href":"/integrations/quickbooks-online"},{"title":"Rillet","href":"/integrations/rillet"},{"title":"SaaSGrid","href":"/integrations/saasgrid"},{"title":"Sage Intacct","href":"/integrations/sage-intacct"},{"title":"Salesforce Commerce Cloud","href":"/integrations/salesforce-commerce-cloud"},{"title":"Salesforce Sales Cloud","href":"/integrations/salesforce-sales-cloud"},{"title":"SAP S/4HANA","href":"/integrations/sap-s4hana"},{"title":"Sequence","href":"/integrations/sequence"},{"group":"Shopify","pages":[{"title":"Shopify Partner Access","href":"/integrations/shopify/shopify-partner-access"},{"title":"Shopify Tax Services and Troubleshooting","href":"/integrations/shopify/shopify-tax-services"},{"title":"Shopify Apps","href":"/integrations/shopify/shopify-apps"},{"title":"Configuring Shopify Sales Channels","href":"/integrations/shopify/shopify-sales-channels"},{"title":"Shopify Settings for Schedule C Reporting in California","href":"/integrations/shopify/shopify-schedule-c-california"}]},{"title":"SKU.io","href":"/integrations/skuio"},{"title":"Solidus","href":"/integrations/solidus"},{"group":"Stripe","pages":[{"group":"Numeral for Stripe Checkout","pages":[{"title":"Numeral for Stripe Checkout","href":"/integrations/stripe/stripe-checkout"},{"title":"Customer location and address validation","href":"/integrations/stripe/stripe-checkout-location"},{"title":"Embed address collection","href":"/integrations/stripe/stripe-checkout-embedded"},{"title":"Branding and appearance","href":"/integrations/stripe/stripe-checkout-branding"},{"title":"Discounts and promotion codes","href":"/integrations/stripe/stripe-checkout-discounts"},{"title":"Metadata and saved cards","href":"/integrations/stripe/stripe-checkout-metadata"}]},{"title":"Using Numeral's Tax Engine on Stripe Invoices","href":"/integrations/stripe/stripe-invoices"},{"title":"How Stripe Tax Works with Numeral","href":"/integrations/stripe/stripe-tax"}]},{"title":"Subscript","href":"/integrations/subscript"},{"title":"Tabs","href":"/integrations/tabs"},{"title":"WooCommerce","href":"/integrations/woocommerce"},{"title":"Xero","href":"/integrations/xero"},{"title":"Zoho Billing","href":"/integrations/zoho-billing"},{"title":"Zoho Books","href":"/integrations/zoho-books"}]}]},{"tab":"MCP","groups":[{"group":"Get Started","pages":[{"title":"MCP Overview","icon":"plug","href":"/mcp/overview"},{"title":"MCP Quickstart","icon":"rocket","href":"/mcp/quickstart"}]},{"group":"Reference","pages":[{"title":"MCP Tool Reference","icon":"wrench","href":"/mcp/tools"},{"title":"MCP Authentication \u0026 Limits","icon":"shield","href":"/mcp/authentication"}]},{"group":"Build with MCP","pages":[{"title":"MCP Demo Application","icon":"github","href":"/mcp/demo-app"}]}]}]},{"version":"2026-03-01","pages":[{"title":"2026-03-01","href":"/introduction"}]},{"version":"2026-01-01","pages":[{"title":"2026-01-01","href":"/introduction"}]},{"version":"2025-05-12","pages":[{"title":"2025-05-12","href":"/introduction"}]},{"version":"2024-09-01","pages":[{"title":"2024-09-01","href":"/introduction"}]}]},"title":"Get Certificate Request - Numeral API","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}