> ## Documentation Index
> Fetch the complete documentation index at: https://docs.numeral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 its `cert_req_*` id.

<Note>
  Remember to include the `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.
</Note>


## OpenAPI

````yaml GET /tax/certificate-requests/{request_id}
openapi: 3.0.1
info:
  title: Numeral API
  description: >-
    API for sales tax calculations - Version 2026-03-01. This version adds
    IP-based tax resolution for calculations and platform calculations, in
    addition to Merchant management and Platform Calculations.
  license:
    name: MIT
  version: '2026-03-01'
servers:
  - url: https://api.numeralhq.com/
security:
  - bearerAuth: []
paths:
  /tax/certificate-requests/{request_id}:
    get:
      summary: Get Certificate Request
      description: Retrieve a single certificate request by id. Live-only.
      operationId: getCertificateRequest_v20260301
      parameters:
        - name: X-API-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-03-01'
        - name: request_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Certificate request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateRequestResponse'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CertificateRequestResponse:
      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
        object:
          type: string
          description: 'The type of object: `tax.certificate_request`'
          example: tax.certificate_request
        status:
          $ref: '#/components/schemas/CertificateRequestStatus'
        customer:
          allOf:
            - $ref: '#/components/schemas/CustomerLink'
          nullable: true
          description: >-
            The customer this request is for. `null` if the underlying buyer
            record has been removed.
        certificate_id:
          type: string
          nullable: true
          description: >-
            Populated only when `status === "fulfilled"`. The `cert_*` id of the
            submitted certificate.
          example: cert_a8f3d2c1-1b9a-4c5e-8d7e-6f4a3b2c1d0e
        certificate_type_id:
          type: string
          nullable: true
          description: >-
            Stable identifier of the requested certificate type, e.g.
            `US-CA-CDTFA-230`.
          example: US-CA-CDTFA-230
        jurisdictions:
          type: array
          items:
            type: string
          description: Jurisdiction identifiers covered by the request.
          example:
            - US-CA
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            When the request will auto-expire if not fulfilled. `null` if the
            request does not auto-expire.
        livemode:
          type: boolean
          enum:
            - true
          description: Always `true` — these endpoints are live-only.
      required:
        - id
        - object
        - status
        - customer
        - certificate_id
        - certificate_type_id
        - jurisdictions
        - created_at
        - updated_at
        - expires_at
        - livemode
    Error:
      type: object
      description: Standard error response format for API version 2026-01-01
      properties:
        code:
          type: integer
          description: HTTP status code
          example: 400
        type:
          type: string
          description: Machine-readable error type
          example: MISSING_FIELD
        message:
          type: string
          description: Human-readable error message
          example: Required field 'address_country' is missing
      required:
        - code
        - type
        - message
    CertificateRequestStatus:
      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`.
    CustomerLink:
      type: object
      description: >-
        The customer this object is linked to. `id` is the Numeral `cust_*` id;
        `reference_customer_id` is the value you supplied when the customer was
        created (may be null).
      properties:
        id:
          type: string
          example: cust_6126acaf-7379-411a-8ada-00005bac0715
        reference_customer_id:
          type: string
          nullable: true
          example: '20506'
      required:
        - id
        - reference_customer_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````