For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
API StatusPartner Portal
HomeGuidesAPI ExplorerSDKsGitHubSupport
HomeGuidesAPI ExplorerSDKsGitHubSupport
  • API Concepts
    • Overview
    • Environments and URLs
    • Authentication
    • API versioning
    • Rate limiting
    • HTTP headers
    • Pagination, sorting, and filtering
  • General
  • Common
  • Accounts payable
  • Accounts receivable
  • E-invoicing
  • Payments
  • Accounting integration
  • Expense management
      • GETGet tax rates
      • POSTCreate a tax rate
      • GETGet a tax rate by ID
      • DELDelete a tax rate
      • PATCHUpdate a tax rate
  • Utilities
LogoLogo
API StatusPartner Portal
Expense managementAccounting tax rates

Get a tax rate by ID

GET
/accounting_tax_rates/:tax_rate_id
GET
/v1/accounting_tax_rates/:tax_rate_id
$curl https://api.sandbox.monite.com/v1/accounting_tax_rates/tax_rate_id \
>     -H "x-monite-version: 2024-05-25" \
>     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>     -H "Authorization: Bearer <token>"
1{
2  "id": "id",
3  "created_at": "2024-01-15T09:30:00Z",
4  "updated_at": "2024-01-15T09:30:00Z",
5  "code": "code",
6  "components": [
7    {
8      "is_compound": true,
9      "name": "name",
10      "rate": 1
11    }
12  ],
13  "description": "description",
14  "effective_tax_rate": 1,
15  "is_external": true,
16  "name": "name",
17  "status": "status",
18  "total_tax_rate": 1
19}
Get tax rate account by id
Was this page helpful?
Previous

Delete a tax rate

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

tax_rate_idstringRequired

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Response

Successful Response
idstringformat: "uuid"

A unique Monite-generated ID assigned to this tax rate. You can use this ID as the value of the accounting_tax_rate_id field in line items of payables, receivables, and receipts.

created_atdatetime
UTC date and time when this tax rate was created in Monite. Timestamps follow the ISO 8601 format.
updated_atdatetime
UTC date and time when this tax rate was last updated in Monite.
codestring
The reference code of the tax rate.
componentslist of objects
An array of tax components.
descriptionstring
An arbitrary description of the tax rate.
effective_tax_rateinteger

The effective tax rate value as the percentage multiplied by 100. For example, 12.5% is represented as 1250.

For manually created tax rates (is_external=false), this is the tax rate value defined by the user.

For tax rates fetched from accounting systems (is_external=true), the effective tax rate is calculated based on the components.

  • In case of QuickBooks, effective_tax_rate is the same as total_tax_rate and is the sum of all tax components.
  • In case of Xero, the effective rate can be higher than the sum total. This happens in the compounded tax rate scenarios, where multiple taxes are applied in a sequence and later taxes are applied to amounts that already include earlier taxes.
is_externalbooleanDefaults to false

true if this tax rate was fetched from the connected accounting system, or false if it was created manually by the entity.

namestring
The display name of the tax rate.
statusstring
total_tax_rateinteger

Used only in tax rates fetched from accounting systems (is_external=true). Specifies the total (not compounded) tax rate value as the sum of all components. The value is the percentage multiplied by 100. For example, 12.5% is represented as 1250.

For QuickBoooks, total_tax_rate is the same as effective_tax_rate.

Errors

400
Get Accounting Tax Rates ID Request Bad Request Error
401
Get Accounting Tax Rates ID Request Unauthorized Error
403
Get Accounting Tax Rates ID Request Forbidden Error
404
Get Accounting Tax Rates ID Request Not Found Error
422
Get Accounting Tax Rates ID Request Unprocessable Entity Error
429
Get Accounting Tax Rates ID Request Too Many Requests Error