KintsugiKintsugi

Get a jurisdiction's registration form

GET/registration-jurisdiction-fields

Return the fields a jurisdiction requires on a registration: a JSON Schema plus UI metadata for rendering the form. This is reference data shared by every organization, but a valid credential is still required. The schema's property names match the jurisdictionSpecificFields you send on a registration create. When the jurisdiction needs no jurisdiction-specific fields, defaultForm is true, the schema is an empty object and metadata is null.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/registration-jurisdiction-fields?countryCode=<countryCode>&stateCode=<stateCode>
countryCodestringRequired

ISO 3166-1 alpha-2 country code.

stateCodestringRequired

State or province code.

Response

countryCodestringRequired

ISO 3166-1 alpha-2 country code the schema is for.

stateCodestringRequired

State or province code the schema is for.

defaultFormbooleanRequired

true when this jurisdiction requires no jurisdiction-specific fields and the generic registration form should be used. jurisdictionFieldsJsonSchema is then an empty object and metadata is null.

jurisdictionFieldsJsonSchemaobjectRequired

JSON Schema for the fields this jurisdiction accepts under jurisdictionSpecificFields. Property names are camelCase. An empty object when defaultForm is true.

metadataJurisdictionFormMetadata

UI metadata for rendering the form. null when defaultForm is true.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
GET /registration-jurisdiction-fields?countryCode={countryCode}&stateCode={stateCode}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/registration-jurisdiction-fields?countryCode={countryCode}&stateCode={stateCode}
Response
{
"countryCode": "US",
"stateCode": "AL",
"defaultForm": false,
"jurisdictionFieldsJsonSchema": {},
"metadata": {
"title": "Example title",
"portalWebsiteUrl": "https://www.example.com",
"portalWebsiteLabel": "portal website label",
"helpArticles": [
{
"label": "Primary",
"url": "https://www.example.com"
}
],
"sstBannerEnabled": false,
"filingFrequencies": [
"filing frequencie"
],
"securityQuestionsEnabled": false,
"securityQuestionsMax": 1
}
}
Get a jurisdiction's registration form (2026-07-21) | Kintsugi API Reference