KintsugiKintsugi
API reference / List a registration's OSS countries

List a registration's OSS countries

GET/registrations/{registration_id}/oss-countries

List the EU member states an EU One Stop Shop registration covers. Searched across every organization your credential owns, so no selector is needed for a known id. Returns 404 if the registration does not exist or belongs to an organization your credential cannot access, so the API never confirms an id exists. A registration that is not an EU OSS scheme returns an empty list.

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.

Path parameters

registration_idstringRequired

The unique identifier of the registration.

Response

ossCountriesRegistrationOssCountry[]Required

EU member states covered by this OSS registration. Empty for a registration that is not an EU OSS scheme.

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 /registrations/{registration_id}/oss-countries
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/registrations/{registration_id}/oss-countries
Response
{
"ossCountries": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"countryCode": "DE",
"effectiveDate": "2026-01-01",
"endDate": "2026-12-31",
"status": "ACTIVE"
}
]
}
List a registration's OSS countries (2026-07-21) | Kintsugi API Reference