# API workflows

Source: https://developer.avalara.com/tax-transparency/uir0072038392245/

# API workflows

Learn about AvaTax API endpoints that support transaction-level tax transparency and explanation workflows.

This section describes the AvaTax API endpoints used to support transaction-level tax transparency and explanation workflows.

## Transaction analysis APIs

These endpoints retrieve transaction calculation data used to generate tax explanations.

Endpoint

Purpose

`GET /api/v2/transactions/{id}?$include=Details,Summary`

Retrieve a transaction by ID with full jurisdiction breakdown and summary details.

`GET /api/v2/companies/{companyCode}/transactions/{transactionCode}?documentType={type}&$include=Details,Summary`

Retrieve a transaction by company code and transaction code with jurisdiction breakdown and summary details.

**Key response fields**

The `TransactionLineDetailModel` includes fields used for explanation, such as:

-   `jurisdictionType`

-   `jurisName`

-   `rate`

-   `tax`

-   `sourcing`

-   `nonTaxableType`

## Customer and exemption APIs

These endpoints retrieve customer and certificate information used to explain exemption behavior.

Endpoint

Purpose

`GET /api/v2/companies/{companyId}/customers/{customerCode}`

Retrieve customer details, including tax status.

`GET /api/v2/companies/{companyId}/customers/{customerCode}/certificates/{country}/{region}`

Retrieve valid certificates for a specific jurisdiction. Efficient for transaction-level context.

`GET /api/v2/companies/{companyId}/customers/{customerCode}/certificates`

Retrieve all certificates linked to a customer. Used when a full certificate list is required.

## Tax rates and nexus APIs

These endpoints provide the configuration context used in transaction explanations.

Endpoint

Purpose

`GET /api/v2/companies/{companyId}/nexus`

Retrieve active nexus declarations for contextual explanation.

`GET /api/v2/companies/{companyId}/taxcodes/{id}`

Retrieve tax code details used to clarify applied tax rules.