Skip to content

Tax rules unavailable

HTTP 422tax_rules_unavailable

When the API answers 422 tax_rules_unavailable, and how to fix it.

Version v1.1, updated

The type field of every tax_rules_unavailable response links to this page.

On this page

No tax rules of the company's country apply at this date, so BIRP cannot compute any tax. date gives the date of the request.

At a glance

  • Status: 422 Unprocessable Content

  • Code: tax_rules_unavailable

  • Retry: No. Fix the cause first: the same request gets the same answer.

Causes and fixes

Likely cause

How to fix it

The country of the company is not set in BIRP: GET /v1/me returns no country_code.

A company administrator checks the country in the company settings of BIRP.

The document date is earlier than the dates the tax codes of the company's country cover.

List the codes for that date with GET /v1/tax-codes?date=YYYY-MM-DD, and use a document date they cover.

Example

422 tax_rules_unavailableJSON
{
  "code": "tax_rules_unavailable",
  "date": "2026-09-28",
  "detail": "No tax rules of the company's country apply at this date, so no tax can be computed.",
  "instance": "/v1/invoices",
  "request_id": "a1b2c3d4-0000-4000-8000-0000000000ee",
  "status": 422,
  "title": "Tax rules unavailable",
  "type": "https://birp.io/developers/errors/tax_rules_unavailable"
}

Related

  • invoices
  • me-and-tax-codes
  • no-rule-for-date