APConfigSetting

Accounts

Addresses

AvaFileForms

Batches

CertExpressInvites

Certificates

CommunicationCertificates

Compliance

Contacts

CostCenter

Customers

DataSources

Definitions

DistanceThresholds

DomainControlVerification

ECommerceToken

EcmEventNotifications

FirmClientLinkages

FundingRequests

GLAccount

JurisdictionOverrides

Locations

MultiDocument

Nexus

Notices

Notifications

Provisioning

Registrar

Reports

Settings

Subscriptions

TaxCodes

TaxContent

TaxRules

Upcs

UserDefinedFields

Users

Utilities

Models

Top 10 EndPoints

AvaTax API

REST interface to Avalara's enterprise tax service, AvaTax.

Check top 10 endpoints

Customers

ListValidCertificatesForCustomer

List valid certificates for a location

List valid certificates linked to a customer in a particular country and region.

This API is intended to help identify whether a customer has already provided a certificate that applies to a particular country and region. This API is intended to help you remind a customer when they have or have not provided copies of their exemption certificates to you during the sales order process.

If a customer does not have a certificate on file and they wish to provide one, you should send the customer a CertExpress invitation link so that the customer can upload proof of their exemption certificate. Please see the CreateCertExpressInvitation API to create an invitation link for this customer.

Before you can use any exemption certificates endpoints, you must set up your company for exemption certificate data storage. Companies that do not have this storage system set up will see CertCaptureNotConfiguredError when they call exemption certificate related APIs. To check if this is set up for a company, call GetCertificateSetup. To request setup of exemption certificate storage for this company, call RequestCertificateSetup.

Security Policies

This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPTester, SSTAdmin, TechnicalSupportAdmin, TechnicalSupportUser.
This API depends on the following active services:Required (all): AvaTaxPro, ECMEssentials, ECMPro, ECMPremium, VEMPro, VEMPremium, ECMProComms, ECMPremiumComms.

ListValidCertificatesForCustomer

ListValidCertificatesForCustomer

GEThttps://sandbox-rest.avatax.com/api/v2/companies/{companyId}/customers/{customerCode}/certificates/{country}/{region}

SAMPLE

PARAMETERS

Request

Curl

cURL

1curl -g 'https://sandbox-rest.avatax.com/api/v2/companies/{companyId}/customers/{customerCode}/certificates/{country}/{region}' \
2-H 'X-Avalara-Client: {X-Avalara-Client}' \
3-H 'Authorization: Basic <Base64-encoded credentials>' \
4-H 'Content-Type: application/json'

Response

HEADER

Content-type: application/json

BODY

1{
2 	"status": "Exempt",
3 	"certificate": {
4 	 	"id": 0,
5 	 	"signedDate": "2016-02-01",
6 	 	"expirationDate": "2020-12-31",
7 	 	"filename": "581dbdd2-6e90-48dd-8ea0-5bd457279ffb",
8 	 	"documentExists": false,
9 	 	"valid": true,
10 	 	"verified": false,
11 	 	"exemptPercentage": 0,
12 	 	"isSingleCertificate": false,
13 	 	"exemptionNumber": "Exempt-1234",
14 	 	"exemptionReason": {
15 	 	 	"name": "RESALE"
16 	 	},
17 	 	"ecmStatus": "None",
18 	 	"createdDate": "2025-05-02T07:03:35.7930766Z",
19 	 	"modifiedDate": "2025-05-02",
20 	 	"taxNumberType": "FEIN",
21 	 	"businessNumberType": "Business Services",
22 	 	"pageCount": 0,
23 	 	"customers": [
24 	 	 	{
25 	 	 	 	"companyId": 0,
26 	 	 	 	"customerCode": "9347ff08-7d70-4159-a27b-c7ef0570b525",
27 	 	 	 	"alternateId": "987654321",
28 	 	 	 	"name": "Dr. Bob Example",
29 	 	 	 	"attnName": "Attn: Receiving",
30 	 	 	 	"line1": "645 Main Street",
31 	 	 	 	"city": "Irvine",
32 	 	 	 	"postalCode": "92614",
33 	 	 	 	"phoneNumber": "(949) 555-1212",
34 	 	 	 	"faxNumber": "949.555.1213",
35 	 	 	 	"emailAddress": "dr.bob.example@example.org",
36 	 	 	 	"contactName": "Alice Smith",
37 	 	 	 	"lastTransaction": "2008-10-08T00:00:00Z",
38 	 	 	 	"country": "US",
39 	 	 	 	"region": "CA",
40 	 	 	 	"exposureZones": [
41 	 	 	 	 	{
42 	 	 	 	 	 	"name": "Washington"
43 	 	 	 	 	}
44 	 	 	 	]
45 	 	 	},
46 	 	 	{
47 	 	 	 	"companyId": 0,
48 	 	 	 	"customerCode": "0e28a583-8db0-4684-aa93-113dc8048a0b",
49 	 	 	 	"alternateId": "987654321",
50 	 	 	 	"name": "Dr. Bob Example",
51 	 	 	 	"attnName": "Attn: Receiving",
52 	 	 	 	"line1": "645 Main Street",
53 	 	 	 	"city": "Irvine",
54 	 	 	 	"postalCode": "92614",
55 	 	 	 	"phoneNumber": "(949) 555-1212",
56 	 	 	 	"faxNumber": "949.555.1213",
57 	 	 	 	"emailAddress": "dr.bob.example@example.org",
58 	 	 	 	"contactName": "Alice Smith",
59 	 	 	 	"lastTransaction": "2008-10-08T00:00:00Z",
60 	 	 	 	"country": "US",
61 	 	 	 	"region": "CA",
62 	 	 	 	"exposureZones": [
63 	 	 	 	 	{
64 	 	 	 	 	 	"name": "Washington"
65 	 	 	 	 	}
66 	 	 	 	]
67 	 	 	}
68 	 	],
69 	 	"exposureZone": {
70 	 	 	"name": "Washington"
71 	 	}
72 	}
73}

SAMPLE

PARAMETERS