See what the Avalara ECM integration can do →

This article lists the Avalara AvaTax API endpoints the integration calls, grouped by entity. Use it for firewall allow-listing, troubleshooting, and checking whether a published Avalara AvaTax API change affects the integration.

API Endpoints Intro

The integration calls the Avalara AvaTax REST API (version 2). The base URL depends on the environment configured in the API Url subscription setting:

Environment	Base URL
Production	https://rest.avatax.com
Sandbox	https://sandbox-rest.avatax.com

In the endpoint patterns below, [Base URL] stands for the address above for your environment, {CompanyId} is your Avalara AvaTax company identifier (the API Client Id), and {customerCode}, {companyId}, and {certificateId} are the relevant record identifiers.

Company Endpoints
Certificate Endpoints
Customer Endpoints
Definitions Endpoints
Utilities Endpoints

Company Endpoints

Create a Company (POST)

[Base URL]/v2/companies

Get a Company by Id (GET)

[Base URL]/v2/companies/{companyId}

Update a Company (PUT)

[Base URL]/v2/companies/{companyId}

Find a Company by Code (GET)

[Base URL]/v2/companies?$filter=companyCode eq '{companyCode}'

Certificate Endpoints

Set Up Certificates (POST)

[Base URL]/v2/companies/{companyId}/certificates/setup

Check Certificate Setup Status (GET)

[Base URL]/v2/companies/{companyId}/certificates/setup

Get Company Certificates (GET)

[Base URL]/v2/companies/{companyId}/certificates

Create a Certificate (POST)

[Base URL]/v2/companies/{companyId}/certificates

Update a Certificate (PUT)

[Base URL]/v2/companies/{companyId}/certificates/{certificateId}

Customer Endpoints

Create a Customer (POST)

[Base URL]/v2/companies/{CompanyId}/customers

Get a Customer by Code (GET)

[Base URL]/v2/companies/{CompanyId}/customers/{customerCode}

Find Customers (GET)

[Base URL]/v2/companies/{CompanyId}/customers?$filter=customerCode eq '{customerCode}'&$include=CustomFields

Update a Customer (PUT)

[Base URL]/v2/companies/{CompanyId}/customers/{customerCode}

Get a Customer's Certificates (GET)

[Base URL]/v2/companies/{CompanyId}/customers/{customerCode}/certificates

Get All Certificates with Customers (GET)

[Base URL]/v2/companies/{CompanyId}/certificates?$include=customers

Send a CertExpress Invitation (POST)

[Base URL]/v2/companies/{CompanyId}/customers/{customerCode}/certexpressinvites

Definitions Endpoints

Get Certificate Exposure Zones (GET)

[Base URL]/v2/definitions/certificateexposurezones

Get Certificate Exemption Reasons (GET)

[Base URL]/v2/definitions/certificateexemptreasons

Utilities Endpoints

Ping (GET)

[Base URL]/api/v2/utilities/ping

Authentication

The Avalara AvaTax API uses basic authentication: each request carries the API User and API Password configured on the subscription. See Avalara's authentication documentation for details.

External References

Avalara AvaTax REST API reference

Avalara AvaTax API Endpoints