v1

latestOpenAPI 3.1.02026-07-2496304466.3 KB

Accounts: General

Get Account

get/accounts/{account_id}

Path parameters

account_idstring required

An account identifier.

Query parameters

person_customerboolean

If set to true, returns a simplified person customer object containing only the type and person ID, instead of the full customer details. The parameter will be deprecated in a future version of this API. Once deprecated, all responses will behave as if person_customer=true.

Headers

LMG-Data-Privacy-Access-Principalstring required

LMG-Data-Privacy-Access-Justificationstring required

Response

Successful Response

idstring required

A value identifiying the individual user's account.

declaration_of_acting_on_own_accountboolean required

An boolean value indicating whether the user has explicitly stated that they are acting on their own account and not in someone else's name.

status'closed' | 'created' | 'opened' | 'rejected' required

A category representing the status of a user's account.

<ul> <li><code>closed</code> <li><code>created</code> <li><code>opened</code> <li><code>rejected</code> </ul> <strong>NOTE:</strong> This list is not final yet, there will be more values added later.

metadataobject

Optional metadata for the account as key-value pairs.

Example response

{
  "id": "cusa_c2c3f89ec0524b6e818ce00c16e4897f",
  "customer": {
    "id": "pers_f1e3a7f504414b5e99041ebc1c0f55cd",
    "firstname": "Erika",
    "lastname": "Mustermann",
    "date_of_birth": "1964-08-13",
    "place_of_birth": {
      "city": "Berlin",
      "country": "DE"
    },
    "nationalities": [
      "DE"
    ],
    "phone_number": "+49172997318",
    "email": "erika.mustermann@example.com",
    "registered_address": {
      "line_1": "Heidestraße 17",
      "postal_code": "51147",
      "city": "Köln",
      "country": "DE"
    },
    "tax_residencies": [
      {
        "country": "DE"
      }
    ]
  },
  "history": [
    {
      "status": "created",
      "timestamp": "2023-06-23T07:29:55.465000+00:00"
    }
  ],
  "agreements": [
    {
      "agreement": "agr_9902271f791d413aad781763c61b9bb0",
      "accepted_at": "2023-06-29T14:39:29Z",
      "person": "per_3a0baf04657b4fb9bcaa03d8120b5e9e"
    },
    {
      "agreement": "agr_8ec894e1ec764a339e172292dff9aeff",
      "accepted_at": "2023-06-29T14:39:29Z",
      "person": "per_3a0baf04657b4fb9bcaa03d8120b5e9e"
    }
  ]
}