Get Certificate Request
Retrieve a single certificate request by id. Live-only.
Get Certificate Request (2026-03-01)
Retrieve the details of a specific certificate request by itscert_req_* id.
X-API-Version: 2026-03-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.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
2026-03-01 Path Parameters
Response
Certificate request
A single certificate request.
The ID of the certificate request
"cert_req_b2f1e4a3-9c0d-4e7a-8b1f-2d5a6e7b8c9d"
The type of object: tax.certificate_request
"tax.certificate_request"
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.
pending, fulfilled, canceled, 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".
Populated only when status === "fulfilled". The cert_* id of the submitted certificate.
"cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e"
Stable identifier of the requested certificate type, e.g. US-CA-CDTFA-230.
"US-CA-CDTFA-230"
Jurisdiction identifiers covered by the request.
When the request will auto-expire if not fulfilled. null if the request does not auto-expire.
Always true — these endpoints are live-only.
true