Sales Tax API
Core Concepts
Corporations
Calculate
Transactions
- Tax Transactions
- POSTCreate a transaction
- GETGet transaction
- GETList transactions
- DELDelete transaction
- Refund Transactions
- Bulk Transaction Import
Nexus
Registrations
Products
Customers
Exemption Certificates
Get customer
Get detailed information about a specific customer, including exemption certificates.
curl --request GET \
--url https://base_url/api/v1/customers/{id} \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "b6d009b0-d174-463f-b030-94643c28e209",
"corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
"name": "John Doe",
"email": "jsmith@example.com",
"shipping_address": {
"address_line_1": "1776 Main St",
"address_line_2": "Apt. #123",
"address_line_3": "<string>",
"postal_code": "90401",
"city": "Santa Monica",
"state": "CA",
"country": "US"
},
"external_id": "<string>",
"exemption_metadata": {
"total_certificates": 123,
"certificate_types": [
"<string>"
],
"total_exempted_states": 123,
"expired_exemptions_count": 123,
"inactive_exemptions_count": 123,
"exempted_states": [
"<string>"
],
"active_exemptions_count": 123,
"non_expired_exemptions_count": 123
}
},
"message": "Successfully fetched customer."
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique identifier of the customer to fetch.
Response
The unique identifier for this customer.
"b6d009b0-d174-463f-b030-94643c28e209"
The unique identifier for the corporation associated with this customer.
"2535af08-a139-4d0c-9827-1651e46dfbcf"
A display name for this customer.
"John Doe"
Email address of the customer.
Either 5-digit ZIP code or 9-digit ZIP+4 code is accepted.
"90401"
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.
"CA"
ISO 3166 2-letter country code. Ex: US, IN, GB.
"US"
"1776 Main St"
"Apt. #123"
"Santa Monica"
External identifier for the customer.
Total number of exemption certificates for this customer
List of unique certificate types held by this customer
Total number of states where the customer has exemptions
Number of expired exemption certificates
Number of inactive exemption certificates
List of states where the customer has exemptions
Number of active exemption certificates
Number of non-expired exemption certificates
"Successfully fetched customer."
curl --request GET \
--url https://base_url/api/v1/customers/{id} \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "b6d009b0-d174-463f-b030-94643c28e209",
"corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
"name": "John Doe",
"email": "jsmith@example.com",
"shipping_address": {
"address_line_1": "1776 Main St",
"address_line_2": "Apt. #123",
"address_line_3": "<string>",
"postal_code": "90401",
"city": "Santa Monica",
"state": "CA",
"country": "US"
},
"external_id": "<string>",
"exemption_metadata": {
"total_certificates": 123,
"certificate_types": [
"<string>"
],
"total_exempted_states": 123,
"expired_exemptions_count": 123,
"inactive_exemptions_count": 123,
"exempted_states": [
"<string>"
],
"active_exemptions_count": 123,
"non_expired_exemptions_count": 123
}
},
"message": "Successfully fetched customer."
}