> ## Documentation Index
> Fetch the complete documentation index at: https://pay-docs.holdstation.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Customer KYC

> List your customer KYC records, paged.

List the partner's customer KYC records. Results are paged. `page_size` is capped at `100`.

## Authentication

<ParamField header="Partner-App-Key" type="string" required>
  Your partner app key.
</ParamField>

<ParamField header="X-HSPay-Signature" type="string" required>
  Base64-encoded Ed25519 signature of the sign data.
</ParamField>

<ParamField header="X-HSPay-Timestamp" type="string" required>
  Unix timestamp (seconds) of the request. Must be within 60 seconds of server time.
</ParamField>

## Query Parameters

<ParamField query="page" type="integer">
  Page number (1-based). Defaults to `1`.
</ParamField>

<ParamField query="page_size" type="integer">
  Number of records per page. Defaults to `20`; capped at `100`.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "success",
    "data": [
      {
        "id": "cust-001",
        "name": "Jane Doe",
        "email": "jane@example.com",
        "phone": "+84123456789",
        "address": "123 Le Loi, District 1, Ho Chi Minh City",
        "id_number": "012345678",
        "id_type": 2,
        "sex": 2,
        "nationality": "VN",
        "date_of_issue": "2020-01-01",
        "date_of_expiry": "2030-01-01"
      },
      {
        "id": "cust-002",
        "name": "John Smith",
        "email": "john@example.com",
        "phone": "+84987654321",
        "address": "789 Tran Hung Dao, District 5, Ho Chi Minh City",
        "id_number": "987654321",
        "id_type": 1,
        "sex": 1,
        "nationality": "VN",
        "date_of_issue": "2021-06-15",
        "date_of_expiry": "2031-06-15"
      }
    ]
  }
  ```
</ResponseExample>