> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pleo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Overview of the legacy Tax Code API deprecation. Use it to choose between the new Tax Code API, for reading and managing Tax Codes, and the Export API (v3), for Tax Codes on exported expenses. It links to both guides.

The legacy Tax Code API has been deprecated. Choose a migration path based on your use case.

> **Use this page to answer:**

### Which API replaces the legacy Tax Code API?

It depends on the use case.

* To read and manage the Tax Codes of a company, use the new Tax Code API.
* To get the Tax Code of an exported expense, use the Export API (v3). It returns the Tax Code on each Accounting Entry line in `accountingEntryLines[].tax`.

To choose, see the [Legacy Tax Code API Overview](https://developers.pleo.io/deprecation/legacy-tax-code-api/overview.md).

> This page is the starting point for the legacy Tax Code API deprecation. It does not hold the migration steps. Go to the guide that matches the use case:
>
> * [Migrate to the New Tax Code API](https://developers.pleo.io/deprecation/legacy-tax-code-api/migrate-to-tax-code-api.md): managing tax codes.
> * [Migrate to the Export API (v3)](https://developers.pleo.io/deprecation/legacy-tax-code-api/migrate-to-export-api.md): reading tax data on Export Items.

> **Sources for the Tax Code API:**
>
> * OpenAPI reference: the endpoint pages under the [Tax Code API Overview](https://developers.pleo.io/reference/tax-codes-overview.md). Use them for paths, parameters and required fields.
> * How-tos: [How to Fetch and Match Tax Codes](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/imports/tax-codes/how-to-fetch-and-match-tax-codes.md) and [How to Create, Update, and Archive Tax Codes](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/imports/tax-codes/how-to-create-update-archive-tax-codes.md).
> * If a how-to and the reference disagree, trust the how-to. How-tos record tested behaviour.

> **Sources for the Export API:**
>
> * OpenAPI reference: the endpoint pages under the [Export API Overview](https://developers.pleo.io/reference/export-api/export-api-overview.md). Use the v3 pages for new work. The [Export API Workflow](https://developers.pleo.io/reference/export-api/export-api-workflow.md) explains the order of the calls.
> * Attachments: [Attachments](https://developers.pleo.io/docs/current/platform/exports/attachments.md) explains the receipt file limits.
> * How-tos, all under `/docs/current/how-tos/accounting-integrations/`: [How to Detect and Start Export Jobs for Processing](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/how-to-detect-and-start-export-jobs-for-as-erp-processing.md), [How to Retrieve Export Job Items for Processing](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/how-to-retrieve-export-job-items-for-as-erp-processing.md), [How to Fetch Export Item Data for Processing](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/how-to-fetch-export-item-data-for-as-erp-processing.md), [How to Transfer Attachments](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/how-to-transfer-attachments-for-as-erp-processing.md), [How to Update Export Items](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/how-to-update-export-items-for-as-erp-processing.md) and [How to Update & Complete the Export Job](https://developers.pleo.io/docs/current/how-tos/accounting-integrations/how-to-update-and-complete-export-job-for-as-erp-processing.md).
> * If a how-to and the reference disagree, trust the how-to. How-tos record tested behaviour.

Terminology: Legacy and New

Both APIs are called the Tax Code API. These guides call the deprecated API the **legacy Tax Code API** and its replacement the **new Tax Code API**.

The legacy Tax Code API is under `https://openapi.pleo.io/v1/`. The new Tax Code API is under `https://external.pleo.io`, and its endpoints start with `/v0/`.

> [card] [Migrate to the New Tax Code API](https://developers.pleo.io/deprecation/legacy-tax-code-api/migrate-to-tax-code-api.md)
>
> For integrations that read the Tax Codes of a company. The new Tax Code API can also create, update and delete Tax Codes.

> [card] [Migrate to the New Export API (v3)](https://developers.pleo.io/deprecation/legacy-tax-code-api/migrate-to-export-api.md)
>
> For integrations that book expenses in an Accounting System. You get the Tax Code of each Accounting Entry line on the Export Item, so you no longer look it up.
