> For the complete documentation index, see [llms.txt](https://prepaidify.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prepaidify.gitbook.io/docs/physical-card/api-integration/create-cardholder.md).

# Create Cardholder

### POST Create Cardholder

POST /api/mastercard/holderCreate.html

Create a cardholder. Status: 0 - Pending review, 1 - Under review, 2 - Approved, 3 - Rejected.

> Request Body Example

```
```

```json
{
  "address": "Laisvés pr. 60",
  "countryCode": "LT",
  "dateOfBirth": "1994-04-10",
  "email": "xxxx@gmail.com",
  "firstName": "JohnA",
  "idno": "ABC12345633",
  "idnoType": 2,
  "lastName": "DoeA",
  "mobile": "+8617601081839",
  "nationality": "US",
  "postCode": "05120",
  "randomStr": "abcdef12345678901",
  "sex": 1,
  "town": "Vilnius"
}
```

#### Request Parameters

| Name        | Type          | Required | Base64 Encoded | Field Name            | Description                                                                                    |
| ----------- | ------------- | -------- | -------------- | --------------------- | ---------------------------------------------------------------------------------------------- |
| mobile      | string        | true     | none           | Mobile Number         | Country code + phone number (+861866666)                                                       |
| lastName    | string        | false    | Y              | Last Name             | Last name                                                                                      |
| firstName   | string        | true     | Y              | First Name            | First name                                                                                     |
| email       | string(email) | true     | none           | Email                 | Email address                                                                                  |
| dateOfBirth | string        | true     | none           | Date of Birth         | Date of birth (yyyy-MM-dd)                                                                     |
| nationality | string        | true     | none           | Nationality           | Nationality (two-letter country code)                                                          |
| sex         | integer       | true     | none           | Gender                | Gender: 1 - Male, 2 - Female                                                                   |
| countryCode | string        | true     | none           | European Country Code | Country code (two-letter country code)                                                         |
| town        | string        | true     | Y              | European Region       | European region or city name (in English)                                                      |
| address     | string        | true     | Y              | European Address      | European address details (in English)                                                          |
| postCode    | string        | true     | none           | Postal Code           | Postal code                                                                                    |
| idnoType    | integer       | true     | none           | ID Document Type      | ID document type: 1 - European ID card (supported for European nationality only), 2 - Passport |
| idno        | string        | true     | none           | ID Document Number    | ID document number                                                                             |
| randomStr   | string        | true     | none           | Random String         | Random string with a length of 32 characters                                                   |

> Response Example
>
> 200 Response

```
```

```json
{
  "auditStatus": 0,
  "errMsg": "string",
  "firstName": "string",
  "holderId": "string",
  "idno": "string",
  "idnoType": 0,
  "lastName": "string",
  "mobile": "string"
}
```

#### Response Parameters

| Name        | Type    | Required | Constraints | Description                                                                                        |
| ----------- | ------- | -------- | ----------- | -------------------------------------------------------------------------------------------------- |
| auditStatus | integer | true     | none        | Audit status,0: Pending review, 1: Under review, 2: Approved, 3: Rejected, 4: Data to be completed |
| errMsg      | string  | true     | none        | Description                                                                                        |
| firstName   | string  | true     | none        | First Name                                                                                         |
| holderId    | string  | true     | none        | Cardholder ID                                                                                      |
| idno        | string  | true     | none        | ID Document Number                                                                                 |
| idnoType    | integer | true     | none        | ID Document Type                                                                                   |
| lastName    | string  | true     | none        | Last Name                                                                                          |
| mobile      | string  | true     | none        | Mobile Number                                                                                      |