Retrieves a paginated list of all exemptions for a specific customer. Supports filtering by certificate type, jurisdiction, expiration status, and exemption status.
The unique identifier of the customer.
Cursor for pagination. Use the cursor returned in the previous response to fetch the next page.
Number of items to return per page. Must be between 1 and 100.
Comma-separated list of certificate types to filter by (e.g., “SINGLE_STATE,MULTI_STATE”).
Comma-separated list of jurisdictions to filter by in the format {country}_{state} (e.g., “US_CA,US_NY”).
Filter by expiration status. Valid values:
ACTIVE - Non-expired exemptionsEXPIRED - Expired exemptions Filter by exemption status. Valid values:
ACTIVE - Active exemptionsINACTIVE - Inactive exemptions Array of exemption objects. The jurisdiction exemption details. Show Jurisdiction exemption
ISO 3166-1 alpha-2 country code.
ISO 3166-2 subdivision code.
The reason for the exemption.
The type of identification.
The identification number.
Whether the exemption is active.
Whether the exemption has expired.
The end date of the exemption.
Unix timestamp of when the exemption was created.
The associated exemption certificate details. Unique identifier for the exemption certificate.
The customer ID associated with the certificate.
The type of exemption certificate.
The verification status of the certificate.
exemption_certificate_number
The exemption certificate number.
The effective date of the certificate.
Unix timestamp of when the certificate was created.
The ID of the associated file.
The name of the associated file.
Total number of exemptions for the customer.
Cursor to use for fetching the next page. Only present if there are more results.
{ "message" : "Successfully fetched exemptions." , "data" : { "exemptions" : [ { "exemption" : { "country" : "US" , "state" : "CA" , "reason" : "PURPOSE_RESALE" , "identification_type" : "STATE_TAX_ID" , "identification_number" : "12-3456789" , "is_active" : true , "is_expired" : false , "end_date" : "2025-12-31" , "created_at" : 1704067200 , "certificate" : { "id" : "cert_123abc" , "customer_id" : "cust_456def" , "type" : "SINGLE_STATE" , "verification_status" : "VERIFICATION_SUCCESS" , "exemption_certificate_number" : "EX-12345" , "effective_date" : "2024-01-01" , "created_at" : 1704067200 , "file_id" : "file_789ghi" , "file_name" : "exemption_cert.pdf" } } } ], "total_exemptions" : 1 } }
curl --request GET \ --url 'https://transaction-tax.api.in.commenda.io/api/v1/exemptions?customer_id=cust_123&limit=20&exemption_jurisdiction=US_CA' \ --header 'Authorization: Bearer <token>'
