KintsugiKintsugi

List the physical presence category catalog

GET/physical-nexus/categories

List the physical presence categories a jurisdiction accepts. Each name is a value category accepts on a create or an update, and isCategoryAssigned reports whether the organization already records that category in this jurisdiction. Because that flag is organization data, this route needs exactly one organization: send Organization-Id, Connection-Id, or Entity-Id if your credential reaches more than one.

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.

/physical-nexus/categories?countryCode=<countryCode>&stateCode=<stateCode>
countryCodestring

ISO 3166-1 alpha-2 country of the jurisdiction. Defaults to US.

stateCodestring

State or province code within countryCode. Omit it for the country-level catalog, in which case no category reads as assigned.

Response

namePublicPhysicalNexusCategoryEnumRequired

The category value. Send it as category on a create or an update. Ignore unrecognized values.

Available options:PHYSICAL_BUSINESS_LOCATIONTELECOMMUTING_OR_REMOTE_EMPLOYEEWARRANTY_AND_REPAIR_SERVICESCATALOGUE_DISTRIBUTION_OR_ADVERTISING_MATERIALDELIVERY_BY_COMMON_CARRIERDELIVERY_BY_OWN_VEHICLESIN_STATE_SALES_PERSONINDEPENDENT_CONTRACTOR_OR_THIRD_PARTY_SALES_PERSONWAREHOUSE_AND_INVENTORY_PRESENCEEMPLOYEES_AGENTS_CONTRACTORSOWN_LEASE_A_PROPERTYINVENTORYDELIVERY_USING_COMPANY_VEHICLESOWN_BUSINESS_INFRASTRUCTURE_AND_EQUIPMENTON_SITE_INSTALLATION_MAINTENANCE_SERVICESFREQUENT_PARTICIPATION_IN_TRADE_SHOWS_EVENTSMANUFACTURE_OR_PRODUCTION_IN_CANADAPERFORMING_SERVICES_IN_THE_JURISDICTIONMANUFACTURING_FACILITIESSERVERS_DATA_CENTERSTRADE_SHOW_PRESENCETRADE_SHOW_PRESENCE_WITHOUT_SALESDIGITAL_INFRASTRUCTURE_LOCALIZEDPERMANENT_ESTABLISHMENTENTER_CONTRACTS_WITH_LOCALSCONSIGNMENT_STOCK_ARRANGEMENTS
titlestringRequired

Display label for this category. Empty if none is defined.

descriptionstringRequired

What this category covers. Empty if no description is defined.

examplestringRequired

Worked example of a presence in this category. Empty if none is defined.

isCategoryAssignedbooleanRequired

Whether the resolved organization already records this category in the requested jurisdiction.

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 /physical-nexus/categories?countryCode={countryCode}&stateCode={stateCode}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/physical-nexus/categories?countryCode={countryCode}&stateCode={stateCode}
Response
[
{
"name": "PHYSICAL_BUSINESS_LOCATION",
"title": "Telecommuting Or Remote Employee",
"description": "Annual software subscription",
"example": "example",
"isCategoryAssigned": false
}
]
List the physical presence category catalog (2026-07-21) | Kintsugi API Reference