Returns the tax configuration with the given identifier.

GET /accounting/tax-configurations/{id}

Group: Accounting › Tax Configurations · Operation ID: getTaxConfiguration

Open in the interactive reference

Parameters

Name In Type Required Description
Api-Version header "v1" yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.
id path string yes The unique identifier for the tax configuration to return.

Response

200 Success

Under data (getTaxConfigurationOutput):

Field Type Required Description
id string yes The unique identifier for the tax configuration.
entityId string yes The legal entity this configuration belongs to. An entity has at most one tax configuration. See id on GET base/entities.
entityName string no The name of the owning legal entity.
status string yes The status of the tax configuration. The tax codes of an inactive configuration are not offered on documents. Possible values: 'Active', 'Inactive'.
taxRegime string yes The tax system that determines which tax components are valid. Possible values: 'EU_VAT', 'India_GST', 'Canada_GST', 'Ghana_VAT', 'SingleRate_GST'.
externalId string no An external system's identifier for this configuration, set when it was migrated from another system.
lastModifiedDate string (date-time) yes The date and time the tax configuration record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ.
lines array of object yes The tax codes of this configuration, in display order. Every configuration has at least one.
lines[].id string yes The unique identifier for the tax code line.
lines[].taxCode string no The business tax code as printed on source documents, for example 'V19EUG' or 'U00EU'. Absent when none was supplied.
lines[].title string yes The display title of the tax code. Unique within the configuration.
lines[].comment string no A free-form note on when to use this tax code. Absent when none was set.
lines[].vatDeclarationField string no The box or boxes on the VAT return that this code feeds, taken verbatim from the tax authority form, for example '66' or '46+47+67'. Free text, not evaluated. Absent when none was set.
lines[].percentage string (decimal) yes The tax rate, as a decimal fraction. For example, 0.19 is 19%. 0 for a zero-rated or exempt code.
lines[].rateType string yes The legal rate classification of the tax code. Possible values: 'Standard', 'Reduced', 'SuperReduced', 'Zero', 'Exempt'.
lines[].scope string yes The territorial scope of the transaction. Possible values: 'Domestic', 'IntraEU_B2B', 'IntraEU_B2C', 'ExtraEU_Goods', 'ExtraEU_Services'.
lines[].direction string yes Which side the tax sits on. 'Input' is tax paid on purchases, 'Output' is tax charged on sales. Possible values: 'Input', 'Output'.
lines[].isReverseCharge boolean yes Whether the recipient rather than the supplier accounts for the tax, for example under §13b UStG. A reverse-charge line books a second, crediting entry to reverseChargeCreditAccountId on each of its accounts.
lines[].isActive boolean yes Whether the tax code is offered for selection on new documents. Inactive codes stay readable on existing documents.
lines[].index number yes The position of the line within its configuration, used for display order.
lines[].accounts array of object yes The GL accounts this tax code books to, one per chart of accounts the entity books in. Every tax code has at least one, including exempt and zero-rated codes, which book a tax line at zero.
lines[].accounts[].id string yes The unique identifier for the account mapping.
lines[].accounts[].chartOfAccountsId string yes The chart of accounts this mapping applies to. See id on GET accounting/chart-of-accounts/:id.
lines[].accounts[].accountId string yes The account the tax amount is booked to. See id on GET accounting/accounts/:id.
lines[].accounts[].reverseChargeCreditAccountId string no The account credited with the offsetting tax amount on a reverse-charge line. Absent when isReverseCharge is false. See id on GET accounting/accounts/:id.

Errors

Code Status
NOT_FOUND 400

Statuses