{
"code": 400,
"type": "MISSING_FIELD",
"message": "Required field 'address_country' is missing"
}
Retrieve a paginated list of exemption certificates for your account. Filter
by customer, jurisdiction, status, certificate type, and creation / update
windows.
Remember to include the X-API-Version: 2026-03-01 header. Certificate
endpoints are live-only — using a sk_test_* key returns
TESTMODE_NOT_SUPPORTED.
Filtering by status
status accepts the public certificate vocabulary:
Value
Description
processing
Numeral’s review pipeline is still working on the certificate.
needs_info
Additional information is required before the certificate can be approved.
active
The certificate is valid and in effect.
expiring
The certificate will expire soon.
expired
The certificate has lapsed but may still be renewable.
invalid
The certificate was rejected or revoked.
expiring and expired are kept distinct from invalid so you can
differentiate a lapsed but renewable certificate from a rejected one.
Filtering by customer
Pass customer_id together with id_type to narrow by buyer:
id_type=id (default) — match against the Numeral-issued cust_* id.
id_type=reference_customer_id — match against your reference id.
Filtering by jurisdiction
Pass jurisdiction (a jurisdiction identifier like US-CA) to return only
certificates that cover that jurisdiction. Multi-state certificates are
returned if any of their covered jurisdictions match.
Pagination
Responses use cursor pagination. The next_cursor field is the last id of
the current page — pass it back as cursor to fetch the next page.
next_cursor is omitted (not null) on the final page.
Excluded from results
The list endpoint hides archived, deleted, and revision (child) certificates.
The id returned for any certificate is always the canonical, top-level
certificate id — safe to store as a stable reference.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
X-API-Version
enum<string>
required
Available options:
2026-03-01
Query Parameters
status
enum<string>
Public lifecycle state of an exemption certificate. expiring and expired are distinct from invalid so a renewable lapse is distinguishable from a revoked or rejected certificate.
Available options:
processing,
needs_info,
active,
expiring,
expired,
invalid
customer_id
string
id_type
enum<string>
default:id
How to interpret customer_id. Use id (the default) for the Numeral cust_* id, or reference_customer_id for your own id. Validated whenever present — passing an unknown value returns INVALID_REQUEST (400) even if customer_id is not also supplied.
Available options:
id,
reference_customer_id
jurisdiction
string
Jurisdiction identifier, e.g. US-CA.
certificate_type_id
string
Filter by certificate type. Accepts either the stable identifier (e.g. US-CA-CDTFA-230) or the numeric type id (e.g. 12).
created_after
string<date-time>
created_before
string<date-time>
updated_after
string<date-time>
updated_before
string<date-time>
limit
integer
default:10
Required range: 1 <= x <= 100
cursor
string
Response
Certificate list
A paginated list of exemption certificates.
object
enum<string>
required
Available options:
list
certificates
object[]
required
Show child attributes
has_more
boolean
required
Whether there are more certificates to fetch.
next_cursor
string
Pass as cursor on the next request. Omitted (not null) on the final page.
{"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":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4a2fc3e956335301ce2ab","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":56},{"language":"default","tag":"Integrations","count":55},{"language":"default","tag":"Platform Integrations","count":49},{"language":"default","tag":"API Reference","count":46},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Stripe","count":8},{"language":"default","tag":"Integration Guides","count":6},{"language":"default","tag":"Numeral for Stripe Checkout","count":6},{"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":"custom-rbac-roles","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":"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":"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":"editor-metadata","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":"llms-txt-v2","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 / 0.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 / 0.25);border-radius:0.75rem;padding:0.75rem 1rem 0.25rem}.sx-endpoints-title{font-size:0.75rem;font-weight:600;text-transform:uppercase;letter-spacing:0.05em;opacity:0.7;margin-bottom:0.5rem}div.sx-endpoints a{display:block;position:relative;font-family:inherit;font-size:inherit;padding:0.6rem 1.5rem 0.6rem 0;border-top:1px solid rgb(127 127 127 / 0.2);border-bottom:none!important;text-decoration:none}.sx-endpoints a::after{content:\"›\";position:absolute;right:0.25rem;top:50%;transform:translateY(-50%);font-size:1.25rem;opacity:0.5}.sx-endpoints a:hover::after{opacity:1}.sx-ep-name{display:block;font-weight:600;font-size:0.9rem}.sx-ep-path{display:block;font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:0.8rem;margin-top:0.15rem}.sx-ep-url{opacity:0.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:0.15rem 0 0.5rem;padding:0 0 0 1.75rem}.sx-nav-sub a{display:flex;align-items:baseline;gap:0.5rem;padding:0.3rem 0.5rem;border-radius:0.5rem;font-size:0.8125rem;line-height:1.3;opacity:0.7}.sx-nav-sub a:hover,.sx-nav-sub a.sx-current{opacity:1;background:rgb(127 127 127 / 0.1)}.sx-nav-sub a:focus{outline:none}.sx-nav-sub a:focus-visible{outline:2px solid rgb(127 127 127 / 0.5)}.sx-nav-method.sx-nav-spacer{visibility:hidden}.sx-nav-method{flex:none;min-width:2.4rem;padding:0.05rem 0.3rem;border-radius:0.3rem;font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:0.625rem;font-weight:700;text-align:center}.sx-nav-method.sx-get{color:#3b82f6;background:rgb(59 130 246 / 0.15)}.sx-nav-method.sx-post{color:#16a34a;background:rgb(22 163 74 / 0.15)}.sx-nav-method.sx-delete{color:#ef4444;background:rgb(239 68 68 / 0.15)}.sx-page-end{height:4rem}.sx-toggle{margin-top:0.75rem;border:1px solid rgb(127 127 127 / 0.3);border-radius:9999px;padding:0.3rem 0.9rem;font-size:0.85rem;font-weight:500;white-space:pre;cursor:pointer}.sx-toggle.sx-open{border-radius:0.75rem 0.75rem 0 0;border-bottom:none}.sx-children{border:1px solid rgb(127 127 127 / 0.3);border-radius:0 0.75rem 0.75rem 0.75rem;padding:0 1rem 0.5rem}.sx-children[hidden]{border:0;padding:0}"}],"page":{"pagePath":"api-reference/v2026-03-01/endpoint/list_certificates","slug":"/api-reference/v2026-03-01/endpoint/list_certificates","pageMetadata":{"title":"List Certificates","openapi":"GET /tax/certificates","description":"Retrieve a paginated list of exemption certificates","href":"/api-reference/v2026-03-01/endpoint/list_certificates"},"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 paginated list of exemption certificates\"\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`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Retrieve a paginated list of exemption certificates for your account. Filter\nby customer, jurisdiction, status, certificate type, and creation / update\nwindows.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Remember to include the `,_jsx(_components.code,{children:`X-API-Version: 2026-03-01`}),` header. Certificate\nendpoints are live-only — using a `,_jsx(_components.code,{children:`sk_test_*`}),` key returns\n`,_jsx(_components.code,{children:`TESTMODE_NOT_SUPPORTED`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`filtering-by-status`,children:`Filtering by status`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`status`}),` accepts the public certificate vocabulary:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`processing`})}),_jsx(_components.td,{children:`Numeral’s review pipeline is still working on the certificate.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`needs_info`})}),_jsx(_components.td,{children:`Additional information is required before the certificate can be approved.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`active`})}),_jsx(_components.td,{children:`The certificate is valid and in effect.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expiring`})}),_jsx(_components.td,{children:`The certificate will expire soon.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expired`})}),_jsx(_components.td,{children:`The certificate has lapsed but may still be renewable.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid`})}),_jsx(_components.td,{children:`The certificate was rejected or revoked.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`expiring`}),` and `,_jsx(_components.code,{children:`expired`}),` are kept distinct from `,_jsx(_components.code,{children:`invalid`}),` so you can\ndifferentiate a lapsed but renewable certificate from a rejected one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`filtering-by-customer`,children:`Filtering by customer`}),`\n`,_jsxs(_components.p,{children:[`Pass `,_jsx(_components.code,{children:`customer_id`}),` together with `,_jsx(_components.code,{children:`id_type`}),` to narrow by buyer:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`id_type=id`}),` (default) — match against the Numeral-issued `,_jsx(_components.code,{children:`cust_*`}),` id.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`id_type=reference_customer_id`}),` — match against your reference id.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`filtering-by-jurisdiction`,children:`Filtering by jurisdiction`}),`\n`,_jsxs(_components.p,{children:[`Pass `,_jsx(_components.code,{children:`jurisdiction`}),` (a jurisdiction identifier like `,_jsx(_components.code,{children:`US-CA`}),`) to return only\ncertificates that cover that jurisdiction. Multi-state certificates are\nreturned if any of their covered jurisdictions match.`]}),`\n`,_jsx(Heading,{level:`2`,id:`pagination`,children:`Pagination`}),`\n`,_jsxs(_components.p,{children:[`Responses use cursor pagination. The `,_jsx(_components.code,{children:`next_cursor`}),` field is the last id of\nthe current page — pass it back as `,_jsx(_components.code,{children:`cursor`}),` to fetch the next page.\n`,_jsx(_components.code,{children:`next_cursor`}),` is omitted (not `,_jsx(_components.code,{children:`null`}),`) on the final page.`]}),`\n`,_jsx(Heading,{level:`2`,id:`excluded-from-results`,children:`Excluded from results`}),`\n`,_jsxs(_components.p,{children:[`The list endpoint hides archived, deleted, and revision (child) certificates.\nThe `,_jsx(_components.code,{children:`id`}),` returned for any certificate is always the canonical, top-level\ncertificate id — safe to store as a stable reference.`]})]})}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":"List Certificates","openapi":"GET /tax/certificates","description":"Retrieve a paginated list of exemption certificates","href":"/api-reference/v2026-03-01/endpoint/list_certificates"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Filtering by status","slug":"filtering-by-status","depth":2,"children":[]},{"title":"Filtering by customer","slug":"filtering-by-customer","depth":2,"children":[]},{"title":"Filtering by jurisdiction","slug":"filtering-by-jurisdiction","depth":2,"children":[]},{"title":"Pagination","slug":"pagination","depth":2,"children":[]},{"title":"Excluded from results","slug":"excluded-from-results","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/numeralhq/f4a41b99b7afe396/src/version-refresh.js","/_mintlify/custom/numeralhq/4721c15820461e09/src/resource-pages.js"],"openApiReferenceData":{"operation":{"summary":"List Certificates","description":"Retrieve a paginated list of exemption certificates","operationId":"listCertificates_v20260301","parameters":["65fc26d5-eae4-4746-a6f4-8823f24613d0","a97e2db1-2c71-4fb1-9d9c-0a1598ebafd9","6b0dde66-95a7-46e3-a470-9afda76003a4","fd52c70c-003c-4fb7-a33d-bc1ae32fa320","bb8f3308-1cc9-461a-8360-b9db8c154683","7a897a99-db57-4e0a-ae57-35bd55bdd434","d154c5cd-5774-4bdc-a5b9-074f7f5211e2","57ec7416-2108-44a7-859c-49f56c1233d1","5e91573b-74e8-4903-9946-f65b7099357d","4ceac5aa-f229-4f23-a036-f7de20276ebb","ee65cbac-c4ff-4a35-821c-4c732aa82533","615b2ffd-8675-4291-825e-696ca1ccd58f"],"responses":{"200":"beeab1c0-3ee8-4def-b95e-21e15b35793c","400":"3195d3f5-22ce-4e87-9d68-523ff52b7e16"},"method":"get","type":"path","servers":["96e45023-15c6-48fc-8c1e-027d0f2bd720"],"security":["7e904e91-2538-4dcb-9c77-d523de243435"],"path":"/tax/certificates","baseUrlOptions":["https://api.numeralhq.com/"],"title":"List Certificates","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"65fc26d5-eae4-4746-a6f4-8823f24613d0":{"name":"X-API-Version","in":"header","required":true,"schema":{"type":"string","enum":["2026-03-01"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"a97e2db1-2c71-4fb1-9d9c-0a1598ebafd9":{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["processing","needs_info","active","expiring","expired","invalid"],"description":"Public lifecycle state of an exemption certificate. `expiring` and `expired` are distinct from `invalid` so a renewable lapse is distinguishable from a revoked or rejected certificate.","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"6b0dde66-95a7-46e3-a470-9afda76003a4":{"name":"customer_id","in":"query","required":false,"schema":{"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"fd52c70c-003c-4fb7-a33d-bc1ae32fa320":{"name":"id_type","in":"query","required":false,"schema":{"type":"string","enum":["id","reference_customer_id"],"default":"id","isRequired":false,"description":"How to interpret `customer_id`. Use `id` (the default) for the Numeral `cust_*` id, or `reference_customer_id` for your own id. Validated whenever present — passing an unknown value returns `INVALID_REQUEST` (400) even if `customer_id` is not also supplied.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"How to interpret `customer_id`. Use `id` (the default) for the Numeral `cust_*` id, or `reference_customer_id` for your own id. Validated whenever present — passing an unknown value returns `INVALID_REQUEST` (400) even if `customer_id` is not also supplied."},"bb8f3308-1cc9-461a-8360-b9db8c154683":{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Jurisdiction identifier, e.g. `US-CA`.","uniqueKey":"","typeLabel":"string"},"description":"Jurisdiction identifier, e.g. `US-CA`."},"7a897a99-db57-4e0a-ae57-35bd55bdd434":{"name":"certificate_type_id","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Filter by certificate type. Accepts either the stable identifier (e.g. `US-CA-CDTFA-230`) or the numeric type id (e.g. `12`).","uniqueKey":"","typeLabel":"string"},"description":"Filter by certificate type. Accepts either the stable identifier (e.g. `US-CA-CDTFA-230`) or the numeric type id (e.g. `12`)."},"d154c5cd-5774-4bdc-a5b9-074f7f5211e2":{"name":"created_after","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"57ec7416-2108-44a7-859c-49f56c1233d1":{"name":"created_before","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"5e91573b-74e8-4903-9946-f65b7099357d":{"name":"updated_after","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"4ceac5aa-f229-4f23-a036-f7de20276ebb":{"name":"updated_before","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"ee65cbac-c4ff-4a35-821c-4c732aa82533":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":10,"isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"615b2ffd-8675-4291-825e-696ca1ccd58f":{"name":"cursor","in":"query","required":false,"schema":{"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}}},"responses":{"beeab1c0-3ee8-4def-b95e-21e15b35793c":{"description":"Certificate list","content":{"application/json":{"schema":{"type":"object","description":"A paginated list of exemption certificates.","properties":{"object":{"type":"string","enum":["list"],"isRequired":true,"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"certificates":{"type":"array","items":{"type":"object","description":"A single exemption certificate.","properties":{"id":{"type":"string","example":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","isRequired":true,"uniqueKey":"certificates.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","description":"The type of object: `tax.exemption_certificate`","example":"tax.exemption_certificate","isRequired":true,"uniqueKey":"certificates.items.[INDEX].object","typeLabel":"string"},"status":{"type":"string","enum":["processing","needs_info","active","expiring","expired","invalid"],"description":"Public lifecycle state of an exemption certificate. `expiring` and `expired` are distinct from `invalid` so a renewable lapse is distinguishable from a revoked or rejected certificate.","isRequired":true,"uniqueKey":"certificates.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"certificate_type":{"oneOf":[{"type":"object","description":"The type of an exemption certificate.","required":["id","name","certificate_identifier"],"properties":{"id":{"type":"string","description":"Stable numeric identifier of the certificate type.","example":"12","isRequired":true,"uniqueKey":"certificates.items.[INDEX].certificate_type.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","example":"California Resale Certificate (CDTFA-230)","isRequired":true,"uniqueKey":"certificates.items.[INDEX].certificate_type.oneOf.0.name","typeLabel":"string"},"certificate_identifier":{"type":"string","description":"Stable, human-readable identifier — use this in filters and references.","example":"US-CA-CDTFA-230","isRequired":true,"uniqueKey":"certificates.items.[INDEX].certificate_type.oneOf.0.certificate_identifier","typeLabel":"string"}},"isRequired":true,"uniqueKey":"certificates.items.[INDEX].certificate_type.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"certificates.items.[INDEX].certificate_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].certificate_type","typeLabel":"object | null"},"customer":{"oneOf":[{"type":"object","description":"The specific `Customer` record linked to this certificate. `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":"certificates.items.[INDEX].customer.oneOf.0.id","typeLabel":"string"},"reference_customer_id":{"oneOf":[{"type":"string","example":"20506","isRequired":true,"uniqueKey":"certificates.items.[INDEX].customer.oneOf.0.reference_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","example":"20506","isRequired":true,"uniqueKey":"certificates.items.[INDEX].customer.oneOf.0.reference_customer_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].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":"certificates.items.[INDEX].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":"certificates.items.[INDEX].customer.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].customer.oneOf.0.name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"certificates.items.[INDEX].customer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"certificates.items.[INDEX].customer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].customer","typeLabel":"object | null"},"linked_buyer":{"oneOf":[{"type":"object","description":"The master buyer entity that owns this certificate. Populated whenever the certificate has a master-buyer reference, even when no `Customer` record has been linked yet. Prefer this over `customer` for rendering \"who owns this certificate\".","required":["id","legal_name"],"properties":{"id":{"type":"string","description":"Stable numeric id of the master buyer.","example":"12345","isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer.oneOf.0.id","typeLabel":"string"},"legal_name":{"oneOf":[{"type":"string","example":"Acme Co","isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer.oneOf.0.legal_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Acme Co","isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer.oneOf.0.legal_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer.oneOf.0.legal_name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].linked_buyer","typeLabel":"object | null"},"jurisdictions":{"type":"array","items":{"type":"object","description":"Per-jurisdiction validity for a certificate.","properties":{"jurisdiction_id":{"type":"string","example":"US-CA","isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].jurisdiction_id","typeLabel":"string"},"status":{"type":"string","enum":["processing","needs_info","active","expiring","expired","invalid"],"description":"Public lifecycle state of an exemption certificate. `expiring` and `expired` are distinct from `invalid` so a renewable lapse is distinguishable from a revoked or rejected certificate.","isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"effective_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].effective_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].effective_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].effective_date","typeLabel":"string\u003cdate> | null"},"expiration_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].expiration_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].expiration_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX].expiration_date","typeLabel":"string\u003cdate> | null"}},"required":["jurisdiction_id","status","effective_date","expiration_date"],"uniqueKey":"certificates.items.[INDEX].jurisdictions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"certificates.items.[INDEX].jurisdictions","typeLabel":"object[]"},"effective_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].effective_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].effective_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].effective_date","typeLabel":"string\u003cdate> | null"},"expiration_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].expiration_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"certificates.items.[INDEX].expiration_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].expiration_date","typeLabel":"string\u003cdate> | null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"certificates.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"certificates.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"},"livemode":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"certificates.items.[INDEX].livemode","typeLabel":"enum\u003cboolean>"}},"required":["id","object","status","certificate_type","customer","linked_buyer","jurisdictions","effective_date","expiration_date","created_at","updated_at","livemode"],"uniqueKey":"certificates.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"certificates","typeLabel":"object[]"},"has_more":{"type":"boolean","description":"Whether there are more certificates to fetch.","isRequired":true,"uniqueKey":"has_more","typeLabel":"boolean"},"next_cursor":{"type":"string","description":"Pass as `cursor` on the next request. Omitted (not `null`) on the final page.","uniqueKey":"next_cursor","typeLabel":"string"}},"required":["object","certificates","has_more"],"uniqueKey":"","typeLabel":"object"},"example":{"object":"list","certificates":[{"id":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","object":"tax.exemption_certificate","status":"active","certificate_type":{"id":"12","name":"California Resale Certificate (CDTFA-230)","certificate_identifier":"US-CA-CDTFA-230"},"customer":{"id":"cust_6126acaf-7379-411a-8ada-00005bac0715","reference_customer_id":"20506"},"jurisdictions":[{"jurisdiction_id":"US-CA","status":"active","effective_date":"2026-01-01","expiration_date":"2027-01-01"}],"effective_date":"2026-01-01","expiration_date":"2027-01-01","created_at":"2026-03-01T12:00:00Z","updated_at":"2026-03-01T12:00:00Z","livemode":true}],"has_more":false},"examples":{"Example":{"title":"Example","value":{"object":"list","certificates":[{"id":"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e","object":"tax.exemption_certificate","status":"active","certificate_type":{"id":"12","name":"California Resale Certificate (CDTFA-230)","certificate_identifier":"US-CA-CDTFA-230"},"customer":{"id":"cust_6126acaf-7379-411a-8ada-00005bac0715","reference_customer_id":"20506"},"jurisdictions":[{"jurisdiction_id":"US-CA","status":"active","effective_date":"2026-01-01","expiration_date":"2027-01-01"}],"effective_date":"2026-01-01","expiration_date":"2027-01-01","created_at":"2026-03-01T12:00:00Z","updated_at":"2026-03-01T12:00:00Z","livemode":true}],"has_more":false}}},"exampleType":"examples"}},"exampleType":"examples"},"3195d3f5-22ce-4e87-9d68-523ff52b7e16":{"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":{"7e904e91-2538-4dcb-9c77-d523de243435":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"96e45023-15c6-48fc-8c1e-027d0f2bd720":{"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-03-01/openapi.json"},"subdomain":"numeralhq","siteName":"Numeral API","title":"List Certificates - Numeral API","navMaps":{"firstHrefInVersion":{"2026-11-01":{"href":"/api-reference/v2026-03-01/endpoint/list_certificates","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-06-30T20:48:21.599Z","originalFileLocation":"api-reference/v2026-03-01/endpoint/list_certificates.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 paginated list of exemption certificates\">\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=\"List Certificates - Numeral API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a paginated list of exemption certificates\">\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-03-01/endpoint/list_certificates\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://numeralhq.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=List+Certificates\u0026amp;description=Retrieve+a+paginated+list+of+exemption+certificates\u0026amp;theme=ad20b2f16d2f771a40912e24\u0026amp;signature=50dd044c3fe7c3d2a1206a8ae22226c6909005803b7a4f8878ec369fd49a05b7\">\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=\"List Certificates - Numeral API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a paginated list of exemption certificates\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://numeralhq.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=List+Certificates\u0026amp;description=Retrieve+a+paginated+list+of+exemption+certificates\u0026amp;theme=ad20b2f16d2f771a40912e24\u0026amp;signature=50dd044c3fe7c3d2a1206a8ae22226c6909005803b7a4f8878ec369fd49a05b7\">\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-03-01/endpoint/list_certificates\">\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-03-01/endpoint/list_certificates.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Numeral API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Numeral API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v2026-03-01/endpoint/list_certificates.md","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":"Classifying Products with AI","icon":"wand-magic-sparkles","href":"/essentials/integration-guides/product-classification"},{"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":"Saleor","href":"/integrations/saleor"},{"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"}]}]},"basePath":"","title":"List Certificates - Numeral API","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}