Reporting API v2 - Invoice Taxes

Introduction

This article describes how to use the Reporting API v2 endpoint for retrieving tax records associated with invoices. The endpoint provides access to granular tax breakdown data including jurisdiction details, authority information, tax rates, and raw tax provider data from integrated tax engines such as Avalara.

To view detailed documentation on the available endpoint, please visit the Postman collection here: Postman Collection v2

Requester Invoice-Taxes API

API Path:

GET ~/api/v2/reporting/requesters/{requesterId}/invoice-taxes

Query Parameters:

Response:

[
  {
    "invoiceDataTaxId": "guid",
    "invoiceConsolidationId": "guid",
    "consumerId": "guid",
    "invoiceId": "guid",
    "invoiceDataId": "guid",
    "adminZoneLevel": "string",
    "conditionType": "string",
    "taxAccount": "string",
    "taxCode": "string",
    "itemCode": "string",
    "taxAmount": decimal,
    "taxRate": decimal,
    "taxableBasis": decimal,
    "createdOnUtc": "datetime",
    "lastUpdatedOnUtc": "datetime",
    "jurisdictionCode": "string",
    "exemptAmount": decimal,
    "authorityType": "string",
    "authorityName": "string",
    "taxType": "string",
    "vatReg": "string",
    "taxProvider": "string",
    "rawData": { }
  }
]

Fields description

• invoiceDataTaxId — unique identifier of the tax record
• invoiceConsolidationId — identifier of the related invoice consolidation
• consumerId — identifier of the customer associated with the invoice
• invoiceId — identifier of the related invoice
• invoiceDataId — identifier of the related invoice line item
• taxAmount — the calculated tax amount
• taxRate — the applicable tax rate
• taxableBasis — the amount subject to tax
• exemptAmount — the amount exempt from tax
• jurisdictionCode — the tax jurisdiction name or code
• authorityType — the type of tax authority (e.g., Use, Sales)
• authorityName — the name of the tax authority
• taxProvider — the tax engine used to calculate the tax (e.g., Avalara)
• rawData — raw response data from the tax provider

Summary

This article describes how to retrieve invoice tax records via the Reporting API v2. The endpoint provides detailed tax breakdown data per invoice, enabling partners to support compliance reporting, financial analysis, and tax validation activities.

Related content

• Reporting API v2 - overview
• Reporting API v2 Postman Collection
• Reporting API v1/v2 - requesting access