NUnumeral-com

Get Certificate

Changed on

Retrieve a single certificate by id, including a short-lived download_url. Live-only.

get/tax/certificates/{certificate_id}

Request

  • Base URL
    https://api.numeralhq.com
  • URL
    https://api.numeralhq.com/tax/certificates/{certificate_id}
  • Auth
    HTTP bearer

Path parameters

certificate_idstring required

Headers

X-API-Version'2026-03-01' required

Response

Certificate detail (includes pre-signed download_url)

idstring required
objectstring required

The type of object: tax.exemption_certificate

status'processing' | 'needs_info' | 'active' | 'expiring' | 'expired' | 'invalid' required

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.

effective_datestring date nullable required
expiration_datestring date nullable required
created_atstring date-time required
updated_atstring date-time required
livemodetrue required
download_urlstring uri nullable required

Pre-signed URL to download the original certificate document. Expires one hour after issuance — refetch the certificate to mint a new URL. null (response still 200) when no document is attached yet. Treat as confidential.

Example response

{
  "id": "cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e",
  "object": "tax.exemption_certificate",
  "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",
    "name": "Acme Co"
  },
  "linked_buyer": {
    "id": "12345",
    "legal_name": "Acme Co"
  },
  "jurisdictions": [
    {
      "jurisdiction_id": "US-CA"
    }
  ]
}

Changes

  • f4650eaed11fRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status