Tax Rate

Get tax rate by id

Returns one tax rate by MongoDB id (GET /tax-rate/{id}), scoped to your API key. 200 — TaxRateResponseDto. 404 if not in scope; 400 if id is not a valid ObjectId.

get/v1/tax-rate/{id}

Request

  • Base URL: https://api.finalpos.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.finalpos.com/v1/tax-rate/{id}
  • Auth: API key in header x-api-key

Path parameters

idstring required

Tax Rate ID

Response

The tax rate has been successfully retrieved.

idstring

Unique identifier for the TaxRate.

createdAtstring date-time

Timestamp when the TaxRate was created.

updatedAtstring date-time

Timestamp when the TaxRate was last updated.

companyIdstring

Company ID associated with the TaxRate.

namestring

Name of the tax rate.

externalIdstring

External provider id for the tax rate (e.g. the QuickBooks TaxRate Id). Integration correlation key.

sourcestring

Origin of the tax rate — the integration provider that created it.

Example response

{
  "id": "o1p2q3r4s5t6u7v8w9x0y1z2",
  "createdAt": "2025-12-07T19:31:48.436+00:00",
  "updatedAt": "2025-12-07T19:35:48.436+00:00",
  "companyId": "o1p2q3r4s5t6u7v8w9x0y1z2",
  "name": "Standard Rate",
  "externalId": "12",
  "source": "quickbooks"
}

Changes

No recorded changes to this operation across all 1 revision of this API.