Sign in

v1

latestOpenAPI 3.1.02026-07-2496304466.3 KB
Accounts: General

Create Account

post/accounts

Headers

LMG-Data-Privacy-Access-Principalstring required
LMG-Data-Privacy-Access-Justificationstring required

Request body

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.

metadataobject

Optional metadata for the account as key-value pairs.

Example request

{
  "customer": {
    "firstname": "Erika",
    "lastname": "Mustermann",
    "date_of_birth": "1964-08-13",
    "place_of_birth": {
      "city": "Berlin",
      "country": "DE"
    },
    "nationalities": [
      "DE"
    ],
    "phone_number": "+49172997318",
    "registered_address": {
      "line_1": "Heidestraße 17",
      "postal_code": "51147",
      "city": "Köln",
      "country": "DE"
    },
    "tax_residencies": [
      {
        "country": "DE"
      }
    ]
  },
  "accepted_agreements": [
    {
      "agreement_id": "agr_9902271f791d413aad781763c61b9bb0",
      "accepted_at": "2023-06-29T14:39:29Z",
      "legal_representative": "le_3a0baf04657b4fb9bcaa03d8120b5e9e"
    }
  ]
}

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