Identity Information

Update entity identity and registration information for KYB compliance.

`PATCH /v1/businesses/:id/identity`

Request Example

PATCH https://wallet.swipelux.com/v1/businesses/biz_cK69MttD5nAUAbud1B/identity
Content-Type: application/json
X-API-Key: your_api_key
 
{
  "jurisdiction": "DE",
  "entityType": "gmbh",
  "registrationNumber": "HRB 12345",
  "incorporationDate": "2020-01-15",
  "taxNumber": "DE123456789",
  "tradeName": "Acme Invest"
}

Request Fields

Field	Type	Required	Description
`jurisdiction`	string	Yes	Country code of incorporation (ISO 3166-1 alpha-2)
`entityType`	string	Yes	Entity type (e.g., `gmbh`, `llc`, `corporation`, `limited`)
`registrationNumber`	string	Yes	Company registration number
`incorporationDate`	string	Yes	Date of incorporation (ISO 8601 format)
`taxNumber`	string	No	Tax identification number
`tradeName`	string	No	Trading name if different from legal name

Entity Types

Common entity types by jurisdiction:

Germany (DE): gmbh, ag, ug
UK (GB): limited, plc, llp
US (US): llc, corporation, partnership
EU: se (Societas Europaea)

Response

{
  "id": "biz_cK69MttD5nAUAbud1B",
  "legalName": "Acme Investment GmbH",
  "status": "incomplete",
  "identity": {
    "jurisdiction": "DE",
    "entityType": "gmbh",
    "registrationNumber": "HRB 12345",
    "incorporationDate": "2020-01-15",
    "taxNumber": "DE123456789",
    "tradeName": "Acme Invest"
  },
  "updatedAt": "2025-10-17T15:35:00Z"
}

Next Steps

After completing identity information:

PATCH /v1/businesses/:id/identity

Request Example

Request Fields

Entity Types

Response

Next Steps

On this page

`PATCH /v1/businesses/:id/identity`