---
title: "Register Cardholder"
method: POST
path: "/cardholders/register"
tags: ["Cardholders"]
---

# Register Cardholder

`POST /cardholders/register`

Register a new [cardholder](/docs/cardholder-entity) directly as an active cardholder. This creates the [cardholder](/docs/cardholder-entity) _without_ the option to use Pliant-based apps like the web or mobile app. This is normally used if the cardholders only interact with the API consumers app and not Pliant itself.
Wait for the callback about the fully finished registration process to use this cardholder.
For travel use cases, the cardholder can also be a purely technical cardholder. Meaning it is used for issuing a variety of cards, each with a custom customer first and last names. For details, please contact Pliant directly.

## Request body

- object
  - `organizationId` string, uuid, required — The ID of the organization.
  - `salutation` 'MR' | 'MRS' — Used mainly for email communication.
  - `firstName` string, required — The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
  - `lastName` string, required — The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
  - `email` string, required — The email address of the cardholder. This will be used for email communication.
  - `phoneNumber` string, nullable — If provided, the phone number must start with `+` followed by 8 to 15 numbers, e.g. `+49123456789`. As long as the cardholder does not have a phone number, no cards can be issued for this cardholder! The phone number is mandatory for card usage, since needed for 3DS security mechanism during a purchase.
  - `language` 'en' | 'de' | 'es' | 'fi' | 'fr' | 'it' | 'pt' | 'nl' | 'et' | 'el' | 'lv' | 'lt' | 'sk' | 'sl' | 'pl', required — Used for setting the language in Pliant apps as well as for email communication.
  - `tocConfirmedAt` string, date-time, required — The date-time the terms and conditions which apply to this [cardholder](/docs/cardholder-entity) were confirmed by the [cardholder](/docs/cardholder-entity) itself. Please refer to Pliant if you are unsure which terms and conditions are meant here. E.g. `2022-04-13T14:49:50.237794Z`.
  - `phoneNumberVerifiedAt` string, date-time, required — The date-time the phone number was verified by the cardholder. E.g. `2022-04-13T14:49:50.237794Z`.
  - `dateOfBirth` string, date, nullable — The date-of-birth of the cardholder. Depending on the compliance configuration of your payment program, this field may be required. Omitting it in those cases will result in a 400 Bad Request.
  - `nationality` string, nullable — The nationality of the cardholder (ISO 3166-1 alpha-2). Depending on the compliance configuration of your payment program, this field may be required. Omitting it in those cases will result in a 400 Bad Request.
  - `personalAddress` object, nullable — The personal address of the cardholder.
    - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation.
    - `city` string, nullable — The city of the address.
    - `postalCode` string, nullable — The postal code of the address. Must match the country-specific format (e.g. 5 digits for `DE`/`FR`/`ES`, 4 digits for `AT`/`BE`). Both `postalCode` and `country` must be provided together.
    - `streetName` string, nullable — The street name of the address.
    - `streetNumber` string, nullable — The street number of the address.
    - `additionalInformation` string, nullable — Optional additional address information.
  - `deliveryAddress` object, nullable — The delivery address of the cardholder.
    - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation.
    - `city` string, nullable — The city of the address.
    - `postalCode` string, nullable — The postal code of the address. Must match the country-specific format (e.g. 5 digits for `DE`/`FR`/`ES`, 4 digits for `AT`/`BE`). Both `postalCode` and `country` must be provided together.
    - `streetName` string, nullable — The street name of the address.
    - `streetNumber` string, nullable — The street number of the address.
    - `additionalInformation` string, nullable — Optional additional address information.

## Response `201`

Cardholder is in creation process, wait for the callback to use it.

- 0 — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)