> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commenda.io/llms.txt
> Use this file to discover all available pages before exploring further.
# List exemptions by customer
> Get all exemptions for a specific customer with filtering options
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 exemptions
* `EXPIRED` - Expired exemptions
Filter by exemption status. Valid values:
* `ACTIVE` - Active exemptions
* `INACTIVE` - Inactive exemptions
Array of exemption objects.
The jurisdiction exemption details.
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.
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.
```json 200 theme={null}
{
"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
}
}
```
```json 400 theme={null}
{
"error": {
"code": "MISSING_REQUIRED_PARAMS",
"message": "Missing required parameter: customer_id"
}
}
```
```json 404 theme={null}
{
"error": {
"code": "CUSTOMER_NOT_FOUND",
"message": "Customer not found"
}
}
```
```bash cURL theme={null}
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 '
```
```javascript JavaScript theme={null}
const response = await fetch('https://transaction-tax.api.in.commenda.io/api/v1/exemptions?customer_id=cust_123&limit=20&exemption_jurisdiction=US_CA', {
method: 'GET',
headers: {
'Authorization': 'Bearer '
}
});
const data = await response.json();
```
```python Python theme={null}
import requests
response = requests.get(
'https://transaction-tax.api.in.commenda.io/api/v1/exemptions',
params={
'customer_id': 'cust_123',
'limit': 20,
'exemption_jurisdiction': 'US_CA'
},
headers={'Authorization': 'Bearer '}
)
data = response.json()
```