# Preview registering a jurisdiction

> POST /registration-preflights

Source: https://docs.trykintsugi.com/reference/2026-07-21/preview-registering-a-jurisdiction

POST /registration-preflights

Preview registering a jurisdiction

Report what a DIRECT_REQUEST `POST /registrations` for a jurisdiction would do, without creating anything. Send an `Organization-Id`, `Connection-Id` or `Entity-Id` header to say which organization it is for

`result` is OK when a new registration would be opened, ABSORBED when an existing sales-tax registration would cover the jurisdiction instead (returned as `registration`), PLAN_UPGRADE_REQUIRED when the organization's plan does not include the registration, or SALES_TAX_REGISTRATION_REQUIRED when a retail delivery fee registration needs an active sales-tax registration in the jurisdiction first

It assumes the jurisdiction has a nexus, like the register dialog, which only previews jurisdictions the organization is exposed in. A jurisdiction with no nexus reports OK

This is read-only: it stores nothing and never creates a registration.

Category: Registrations

Request body:
countryCode (string, required) - ISO 3166-1 alpha-2 country to check.
stateCode (string) - State or province code within `countryCode`. Omit it for a country-level check.
taxType (PublicTaxTypeEnum) - Which taxes the prospective registration would cover.
  allowed values: SALES_TAX, USE_TAX, SALES_AND_USE_TAX, RETAIL_DELIVERY_FEE

Response fields:
result (PublicRegisterPreflightResultEnum, required) - OK to open a new registration, ABSORBED when a sales-tax registration would cover it, PLAN_UPGRADE_REQUIRED when the plan does not include it, or SALES_TAX_REGISTRATION_REQUIRED when the retail delivery fee needs an active sales-tax registration first.
  allowed values: OK, ABSORBED, PLAN_UPGRADE_REQUIRED, SALES_TAX_REGISTRATION_REQUIRED
registration (Registration) - The existing sales-tax registration that would absorb this one. Present only when `result` is ABSORBED, `null` otherwise.
  id (string, required) - Kintsugi's unique identifier for the registration.
  organizationId (string, required) - Organization the registration belongs to. Send it as `Organization-Id` to scope a request to this registration.
  organizationName (string) - Display name of the organization the registration belongs to. `null` when the organization has no name set. Sort a list by it with `sort=organizationName`.
  countryCode (string, required) - ISO 3166-1 alpha-2 country the registration is held in.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt
