ExemptionCreateRequest

  • country
    Type: string · Country
    required

    ISO 3166-1 alpha-3 country code where the exemption applies (e.g., USA, GBR)

  • customer_id
    Type: string · Customer IdFormat: uuid
    required

    Reference to the customer this exemption belongs to

  • exemption_type
    Type: string · ExemptionTypeenum
    required

    Scope of the exemption. full: 100% tax exempt, partial: reduced tax rate applies instead of the standard rate

    values
    • full
    • partial
  • end_date
    Type: string · End DateFormat: date-time nullable

    When the exemption expires (ISO8601 format, null = no expiration)

  • exemption_status
    Type: string · ExemptionStatusenum

    Lifecycle status. active: applied to new transactions in matching jurisdictions, cancelled: revoked and no longer applied. Defaults to active

    values
    • active
    • cancelled
  • file_id
    Type: string · File IdFormat: uuid nullable

    File UUID of the uploaded exemption certificate. When provided, the file is attached to this exemption and surfaced as certificate_id on the response.

  • jurisdictions
    Type: array string[] · Jurisdictions

    ISO 3166-2 subdivision codes where the exemption applies (e.g., US-CA, US-NY). Empty list means the exemption applies to all jurisdictions.

  • start_date
    Type: string · Start DateFormat: date-time nullable

    When the exemption takes effect (ISO8601 format)