All user related paths.

Get all users

get /users

Returns the list of all users.

sort

string

Sort the result by created_at, updated_at.

Default
"created_at"
Enum
  • created_at
  • updated_at

order

string

Sort order of the result list if the sort parameter is specified. Use ASC for ascending or DESC for descending sort order.

Default
"ASC"
Enum
  • ASC
  • DESC

offset

int

i32

Use the offset argument to specify where in the list of results to start when returning items for a particular query.

Min
0

limit

int

i32

Use the limit argument to specify the maximum number of items returned.

Default
100
Min
0
Max
1000

Response

ExamplesSchema

OK

{
  "meta": {
    "offset": 0,
    "limit": 100,
    "count": 1,
    "total_count": 1,
    "sort": "created_at",
    "order": "ASC"
  },
  "data": [
    {
      "id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
      "created_at": "2021-07-21T14:10:00.00Z",
      "updated_at": "2021-07-21T14:10:00.00Z",
      "first_name": "Karl",
      "last_name": "Schmidt",
      "salutation": "SALUTATION_MALE",
      "title": "DR",
      "birth_date": "1972-09-30",
      "birth_city": "Berlin",
      "birth_country": "DE",
      "birth_name": "Schmidt",
      "nationalities": [
        "DE",
        "AU"
      ],
      "postal_address": {
        "address_line1": "Rosenweg 221",
        "address_line2": "apt. 33",
        "postcode": "45678",
        "city": "Berlin",
        "state": "BE",
        "country": "DE"
      },
      "address": {
        "address_line1": "Rosenweg 221",
        "address_line2": "apt. 33",
        "postcode": "45678",
        "city": "Berlin",
        "state": "BE",
        "country": "DE"
      },
      "status": "ACTIVE"
    },
    {
      "id": "287673ef-1bae-4d8a-9e78-8ddaae249d72",
      "created_at": "2021-07-21T14:10:00.00Z",
      "updated_at": "2021-07-21T14:10:00.00Z",
      "first_name": "John",
      "last_name": "Doe",
      "salutation": "SALUTATION_MALE",
      "title": "PROF_DR",
      "birth_date": "1970-10-01",
      "birth_city": "Berlin",
      "birth_country": "DE",
      "birth_name": "Schmidt",
      "nationalities": [
        "DE",
        "AU"
      ],
      "postal_address": null,
      "address": {
        "address_line1": "Rosenweg 221",
        "address_line2": "apt. 33",
        "postcode": "45678",
        "city": "Berlin",
        "state": "BE",
        "country": "DE"
      },
      "status": "ACTIVE"
    }
  ]
}

Create a user

post /users

Creates a user.

User - Create - Request

Any Of

Request

{
  "first_name": "Karl",
  "last_name": "Schmidt",
  "salutation": "SALUTATION_MALE",
  "title": "DR",
  "birth_date": "1972-09-30",
  "birth_city": "Berlin",
  "birth_country": "DE",
  "birth_name": "Schmidt",
  "nationalities": [
    "DE",
    "AU"
  ],
  "postal_address": {
    "address_line1": "Rosenweg 221",
    "address_line2": "apt. 33",
    "postcode": "45678",
    "city": "Berlin",
    "state": "BE",
    "country": "DE"
  },
  "address": {
    "address_line1": "Rosenweg 221",
    "address_line2": "apt. 33",
    "postcode": "45678",
    "city": "Berlin",
    "state": "BE",
    "country": "DE"
  }
}

Response

ExamplesSchema

User created.

{
  "id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
  "created_at": "2021-07-21T14:10:00.00Z",
  "updated_at": "2021-07-21T14:10:00.00Z",
  "first_name": "Karl",
  "last_name": "Schmidt",
  "salutation": "SALUTATION_MALE",
  "title": "DR",
  "birth_date": "1972-09-30",
  "birth_city": "Berlin",
  "birth_country": "DE",
  "birth_name": "Schmidt",
  "nationalities": [
    "DE",
    "AU"
  ],
  "postal_address": {
    "address_line1": "Rosenweg 221",
    "address_line2": "apt. 33",
    "postcode": "45678",
    "city": "Berlin",
    "state": "BE",
    "country": "DE"
  },
  "address": {
    "address_line1": "Rosenweg 221",
    "address_line2": "apt. 33",
    "postcode": "45678",
    "city": "Berlin",
    "state": "BE",
    "country": "DE"
  },
  "status": "ACTIVE"
}

Get a user by ID

get /users/{user_id}

Returns the user specified by ID.

user_id

string

uuid

required

User unique identifier.

Response

ExamplesSchema

OK

{
  "id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
  "created_at": "2021-07-21T14:10:00.00Z",
  "updated_at": "2021-07-21T14:10:00.00Z",
  "first_name": "Karl",
  "last_name": "Schmidt",
  "salutation": "SALUTATION_MALE",
  "title": "DR",
  "birth_date": "1972-09-30",
  "birth_city": "Berlin",
  "birth_country": "DE",
  "birth_name": "Schmidt",
  "nationalities": [
    "DE",
    "AU"
  ],
  "postal_address": {
    "address_line1": "Rosenweg 221",
    "address_line2": "apt. 33",
    "postcode": "45678",
    "city": "Berlin",
    "state": "BE",
    "country": "DE"
  },
  "address": {
    "address_line1": "Rosenweg 221",
    "address_line2": "apt. 33",
    "postcode": "45678",
    "city": "Berlin",
    "state": "BE",
    "country": "DE"
  },
  "status": "ACTIVE"
}

Offboard a user

delete /users/{user_id}

Starts the user offboarding process in the background.

user_id

string

uuid

required

User unique identifier.

Response

ExamplesSchema

The request has been successfully accepted and will be processed asynchronously.

Empty response

Change user data

post /users/{user_id}/data_change_requests

Requests a data change for a user specified by ID.

User - Data Change - Request

Any Of

Request

{
  "first_name": "Karl",
  "last_name": "Schmidt",
  "issuance_date": "2030-01-01",
  "data_download_link": "https://bucket.customer.com/ident/user3.zip",
  "document_type": "ID_CARD"
}

Response

ExamplesSchema

The request has been successfully accepted and will be processed asynchronously.

Empty response

Users events

webhook

Users events

id

string

uuid

required

Event unique identifier

created_at

string

date-time

required

Date and time when the event was created. RFC 3339-5, ISO8601 UTC

type

string

required

Event type

Enum
  • USER.CREATED
  • USER.ACTIVATED
  • USER.DEACTIVATED
  • USER.DATA_CHANGED
  • USER.DATA_CHANGE_FAILED
  • USER.OFFBOARDING_INITIATED
  • USER.OFFBOARDED

object

One Of

required

webhook_id

string

uuid

required

Webhook unique identifier.

Request

{
  "id": "2df83681-6a42-4837-a554-a8197335bcfa",
  "created_at": "2021-11-19T13:06:51.980159529Z",
  "type": "USER.CREATED",
  "object": {
    "created_at": "2021-11-22T09:04:42Z",
    "updated_at": "2021-11-22T09:04:42Z",
    "first_name": "Jane",
    "last_name": "Doe",
    "salutation": "SALUTATION_FEMALE",
    "title": "PROF",
    "birth_date": "1990-01-01",
    "birth_city": "Berlin",
    "birth_country": "DE",
    "birth_name": "Smith",
    "nationalities": [
      "DE",
      "CH"
    ],
    "address": {
      "address_line1": "Torstrasse",
      "address_line2": "12a",
      "city": "Berlin",
      "country": "DE",
      "postcode": "10115",
      "state": "BE"
    },
    "id": "a1752f00-93d5-4b77-a148-959cd315581b",
    "postal_address": {
      "address_line1": "Thorstrasse",
      "address_line2": "123",
      "city": "Berlin",
      "country": "DE",
      "postcode": "10115",
      "state": "BE"
    },
    "status": "ACTIVE"
  },
  "webhook_id": "1b097e06-8a14-4181-b72a-de0972a3c57b"
}

Response

ExamplesSchema

Request has been processed successfully.

Empty response