> 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/cardholder-query.md).

# Cardholder Query

### POST Cardholder Query

POST /api/mastercard/holderQuery.html

Cardholder query: Audit status - 0 Pending review, 1 Under review, 2 Approved, 3 Rejected, 4 Data to be completed

> Request Body

```
```

```json
{
  "holderId": "100960",
  "idno": "ABC123456",
  "idnoType": 1,
  "randomStr": "abcdef1234567890"
}
```

#### Request Parameters

| Name      | Type    | Required | Base64 Encoding | Field Name    | Description                                                                            |
| --------- | ------- | -------- | --------------- | ------------- | -------------------------------------------------------------------------------------- |
| holderId  | string  | false    | none            | Cardholder ID | Cardholder ID (Choose either holderId or idnoType+idno)                                |
| idnoType  | integer | false    | none            | ID Type       | ID type: 1 - European ID card (only for users with European nationality), 2 - Passport |
| idno      | string  | false    | none            | ID Number     | ID number                                                                              |
| randomStr | string  | true     | none            | Randomstr     | A random string of 32 characters                                                       |

> Example Response
>
> 200 Response

```
```

```json
{
    "auditStatus": 1,
    "errMsg": "Approved",
    "firstName": "John",
    "holderId": "1234567890",
    "idno": "ABC123456",
    "idnoType": 2,
    "lastName": "Doe",
    "mobile": "+8618666666666"
}
```

#### Response Fields

| Name        | Type    | Required | Constraints | Description                                                                                              |
| ----------- | ------- | -------- | ----------- | -------------------------------------------------------------------------------------------------------- |
| holderId    | string  | true     | none        | Cardholder ID                                                                                            |
| 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                                                                                              |
| mobile      | string  | true     | none        | Mobile phone number                                                                                      |
| lastName    | string  | true     | none        | Last name                                                                                                |
| firstName   | string  | true     | none        | First name                                                                                               |
| idnoType    | integer | true     | none        | ID type                                                                                                  |
| idno        | string  | true     | none        | ID number                                                                                                |