Get business filing data

Returns statutory filing data for a business in a jurisdiction. The response is a merged view: fields explicitly submitted via PUT are combined with defaults read from the business service.

GET /v1/statutory/businesses/{business_id}/fields/{country_code}

Get business filing data

cURL

curl --request GET \
  --url https://api.cadanapay.com/v1/statutory/businesses/{business_id}/fields/{country_code} \
  --header 'Authorization: Bearer <token>'

200

{
  "entityType": "business",
  "entityId": "biz_01ABC",
  "countryCode": "DE",
  "fields": {
    "betriebsnummer": "12345678",
    "finanzamtNummer": "2722",
    "steuernummer": "21/815/08150"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-MultiTenantKey · string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Path Parameters

business_id · string · required

Business identifier

country_code · string · required

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Z]{2}$

Response

200

application/json

Business filing data

Merged view of statutory filing data for an entity. Combines fields explicitly submitted via PUT with defaults read from the upstream service (person service or business service).

entityType · enum<string>

Type of entity this data belongs to

Available options: person, business

Example:

"person"

entityId · string

ID of the person or business

Example:

"per_xyz789"

countryCode · string

Example:

"DE"

fields · object

Merged field data

Show child attributes

Example:

{
  "steuerID": "97148835200",
  "sozialversicherungsnummer": "54211075L005",
  "firstName": "Max",
  "lastName": "Mustermann"
}