Swipelux

Identity Information

Update business entity identity and registration details

Update entity identity and registration information for KYB compliance.

PATCH /v1/customers/:id/identity

Request Example

PATCH https://wallet.swipelux.com/v1/customers/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

FieldTypeRequiredDescription
jurisdictionstringYesCountry code of incorporation (ISO 3166-1 alpha-2)
entityTypestringYesEntity type (e.g., gmbh, llc, corporation, limited)
registrationNumberstringYesCompany registration number
incorporationDatestringYesDate of incorporation (ISO 8601 format)
taxNumberstringNoTax identification number
tradeNamestringNoTrading 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:

On this page