Get person filing data

Returns statutory filing data for a person in a jurisdiction. The response is a merged view: fields explicitly submitted via PUT are combined with defaults read from the person service (e.g., firstName, lastName).

GET /v1/statutory/persons/{person_id}/fields/{country_code}

Get person filing data

cURL

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

200

{
  "entityType": "person",
  "entityId": "per_xyz789",
  "countryCode": "DE",
  "fields": {
    "steuerID": "97148835200",
    "sozialversicherungsnummer": "54211075L005",
    "firstName": "Max",
    "lastName": "Mustermann"
  }
}

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

person_id · string · required

Person identifier

country_code · string · required

ISO 3166-1 alpha-2 country code

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

Response

200

application/json

Person 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"
}