Create a registration
Register in one jurisdiction or record a registration you already hold. Send an Organization-Id, Connection-Id or Entity-Id header to say which organization it belongs to
registrationImportType chooses the kind of registration. REGULAR is the default and is a direct registration identified by countryCode and stateCode. OSS is an EU One Stop Shop scheme, identified by its member state instead. SST is the single Streamlined Sales Tax registration an organization may hold, covering the member states at once
DIRECT_REQUEST asks Kintsugi to obtain a registration you do not yet hold, rather than recording one you already have. Kintsugi resolves the jurisdiction from countryCode, stateCode and taxType, opens the registration in PROCESSING for its team to complete, and requires a paid plan that includes managed registrations. A free plan is refused with 403 PLAN_UPGRADE_REQUIRED. A paid plan that does not include managed registrations is refused with 403 FORBIDDEN. Use POST /registration-preflights first to see whether an existing registration would cover it
An SST registration is write-only on this surface. It records the organization's Streamlined Sales Tax enrollment and sign-in, and unlike a REGULAR or OSS registration it is not returned by GET /registrations/{registrationId} or the list
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
Discriminates this from an SST or EU OSS registration. Defaults to REGULAR.
ISO 3166-1 alpha-2 country to register in.
State or province code to register in, within countryCode. Omit it for a country-level registration.
Display name of the state or province. Omit it and Kintsugi derives it from countryCode and stateCode.
How often returns should be filed. Send UNKNOWN when the jurisdiction has not assigned one yet; Kintsugi replaces it once it does.
UNKNOWNMONTHLYQUARTERLYSEMI_ANNUALLYANNUALLYANNUAL_FISCAL_YEARSEMI_MONTHLYBI_MONTHLYFOUR_MONTHLYQUARTERLY_PREPAYMENTDate the registration takes effect in the jurisdiction, as YYYY-MM-DD. Omit it when the jurisdiction has not assigned one.
Email address the jurisdiction has on file for this registration.
First period to generate filings for, as YYYY-MM-DD. Omit it and Kintsugi derives the first filing period from the registration.
When the registration was submitted to the jurisdiction. Omit it on a registration you are asking Kintsugi to file and it is stamped for you.
When the jurisdiction confirmed the registration. Send it only for a registration you already hold.
When deregistration was submitted to the jurisdiction.
When the jurisdiction confirmed the deregistration.
Whether the registration was completed without manual intervention.
Set true to suppress returns for this registration. Kintsugi tracks it but does not file against it.
Set true when the organization files this registration itself. Kintsugi records and tracks it but does not manage the filing, so it is created in a self-managed state rather than awaiting Kintsugi validation. A self-managed registration is active, so registrationDate is required alongside it.
Filing regime to register under. Omit it in jurisdictions that offer only one regime.
STANDARDSIMPLIFIEDProgress of a request to move to a different filing regime. Omit it unless you are recording a regime change already in flight.
REQUESTEDAPPROVEDDONEACKNOWLEDGEDFree-text note to record against the registration.
Account number the jurisdiction issued, on a registration you already hold. Omit it when the jurisdiction has not issued one.
Importer of Record number to record on the registration.
Optional client-minted id for this confirm attempt. When present, duplicate submits of the same gesture can be grouped.
Values only this jurisdiction requires, such as a portal sign-on id or a state-issued account code. Property names are camelCase and differ per jurisdiction; one that requires none rejects this field. Only the credential-bearing ones are readable, via the credentials reveal endpoint.
Response
Kintsugi's unique identifier for the registration.
Organization the registration belongs to. Send it as Organization-Id to scope a request to this registration.
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.
ISO 3166-1 alpha-2 country the registration is held in.
State or province code the registration is held in, within countryCode. An empty string for a country-level registration.
Display name of the state or province. An empty string for a country-level registration.
Lifecycle status. Only a REGISTERED or SELF_MANAGED registration has returns filed against it; the others are in progress, wound down, or retained for reporting.
REGISTEREDPROCESSINGUNREGISTEREDDEREGISTERINGDEREGISTEREDCANCELLEDVALIDATINGAWAITING_CLARIFICATIONSELF_MANAGEDTrue on a PROCESSING registration that marks the organization as collecting tax in the jurisdiction ahead of registration details. Always false on any other status.
Whether the registration is an EU One Stop Shop scheme covering several member states, or a direct registration with one jurisdiction.
EU_OSSOTHERHow the registration was established: REGULAR for one Kintsugi filed, IMPORTED for one you already held and brought across, DEREGISTRATION for one being wound down.
REGULARIMPORTEDDEREGISTRATIONWhich taxes this registration account covers. SALES_AND_USE_TAX is one permit covering both; it does not imply sales activity.
SALES_TAXUSE_TAXSALES_AND_USE_TAXRETAIL_DELIVERY_FEEHow often returns are filed against this registration. UNKNOWN until the jurisdiction assigns one.
UNKNOWNMONTHLYQUARTERLYSEMI_ANNUALLYANNUALLYANNUAL_FISCAL_YEARSEMI_MONTHLYBI_MONTHLYFOUR_MONTHLYQUARTERLY_PREPAYMENTFiling frequency that replaces filingFrequency on filingFrequencyEffectiveDate. null when no frequency change is pending.
UNKNOWNMONTHLYQUARTERLYSEMI_ANNUALLYANNUALLYANNUAL_FISCAL_YEARSEMI_MONTHLYBI_MONTHLYFOUR_MONTHLYQUARTERLY_PREPAYMENTDate scheduledFilingFrequency takes effect, as YYYY-MM-DD. null when no frequency change is pending.
Date the registration takes effect in the jurisdiction, as YYYY-MM-DD. null before the jurisdiction has assigned one.
First period filings are generated for, as YYYY-MM-DD. null before a first filing period has been established.
When the registration was submitted to the jurisdiction. null when it has not been submitted.
When the jurisdiction confirmed the registration. null when it has not been confirmed.
When deregistration was submitted to the jurisdiction. null when no deregistration has been requested.
When the jurisdiction confirmed the deregistration. null when it has not been confirmed.
Effective date the registration closes. null when not set.
Reason the registration is closing. null when not set.
FULL_BUSINESS_CLOSURECLOSING_NEXUS_IN_STATEWhen final-return acknowledgement was recorded. null when not set.
Email address the jurisdiction has on file for this registration. An empty string when none is recorded.
Account number the jurisdiction issued. Holds the sales tax ID on a sales or combined permit, and the consumer use tax account number on a use tax registration. An empty string before one is issued.
Importer of Record number recorded on the registration. An empty string when none is recorded.
Date the Importer of Record number takes effect, as YYYY-MM-DD. In jurisdictions that start collection from this date rather than registrationDate, tax is collected on and after it. null when no IOR date applies.
Free-text note recorded against the registration. An empty string when there is none.
Filing regime the registration is held under. null in jurisdictions that offer only one regime.
STANDARDSIMPLIFIEDProgress of a request to move this registration to a different filing regime. null when no regime change is in flight.
REQUESTEDAPPROVEDDONEACKNOWLEDGEDOne Stop Shop scheme this registration files under. null for a registration that is not an EU OSS scheme.
UNIONNON_UNIONIOSSISO 3166-1 alpha-2 code of the EU member state the OSS registration is identified in. null for a registration that is not an EU OSS scheme.
Tax authority's filing portal for this jurisdiction. null when Kintsugi has no portal recorded for it.
Kintsugi's service fee for this registration, as a decimal string in amountFeesCurrency. 0.00 when no fee applies.
ISO-4217 currency code of amountFees.
Whether the registration was made under a Voluntary Disclosure Agreement.
Whether returns are suppressed for this registration. When true, Kintsugi does not file against it.
Whether the registration was already held and brought into Kintsugi, rather than filed by Kintsugi.
Whether the registration was completed without manual intervention.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.