> ## 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.

# Get KYB

> Retrieve a business verification record by id, with its current status and submitted data.

Returns the current status and the data as submitted. Files are returned as references, never as base64.

See the [Partner Business KYB guide](/guides/partner-business-kyb/overview) for the status lifecycle.

<Note>
  Don't have the `id`? Use [List KYB](/api-reference/kyb/list-kyb) with `reference_id` to find the record.
</Note>

## 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>

## Path Parameters

<ParamField path="id" type="string" required>
  The server-generated KYB record id returned by [Submit KYB](/api-reference/kyb/submit-kyb).
</ParamField>

## Status Values

| Status       | Value | Description                                                   |
| ------------ | ----- | ------------------------------------------------------------- |
| **Pending**  | `1`   | Submitted; awaiting operator review. `reviewed_at` is `null`. |
| **Approved** | `2`   | Approved by an operator                                       |
| **Rejected** | `3`   | Rejected by an operator; `rejection_reason` explains why      |

All submitted fields are echoed back at the same paths as in the request. Inside `documents[].files[]` and `persons[].documents[].files[]`, `data` is replaced by `file_ref` (`f_` followed by 12 hex characters), `filename`, `content_type`, and `size` in bytes of the decoded file.

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "success",
    "data": {
      "success": true,
      "kyb": {
        "id": "7c2f1a90-4d3b-4e2a-9f61-0b8c5d7e1234",
        "partner_id": "11111111-1111-1111-1111-111111111111",
        "subject_type": 2,
        "reference_id": "merchant-00042",
        "status": 2,
        "submitted_at": "2026-08-15T04:12:33Z",
        "reviewed_at": "2026-08-16T09:41:02Z",
        "rejection_reason": "",
        "legal_name": "ABC Trading Co., Ltd",
        "registration_number": "0312345678",
        "incorporation_country": "VN",
        "incorporation_date": "2019-03-14",
        "address": "12 Nguyen Hue, District 1, Ho Chi Minh City, Vietnam",
        "email": "ops@abctrading.vn",
        "phone": "+84901234567",
        "website": "https://abctrading.vn",
        "nature_of_business": "Wholesale import and distribution of consumer electronics accessories to retail chains. B2B only, net-30 terms, no direct consumer sales.",
        "geographic_scope": ["VN", "KH"],
        "persons": [
          {
            "role": 1,
            "name": "Nguyen Van A",
            "date_of_birth": "1985-06-02",
            "email": "a.nguyen@abctrading.vn",
            "phone": "+84901234567",
            "address": "12 Nguyen Hue, District 1, Ho Chi Minh City, Vietnam",
            "id_number": "C1234567",
            "id_type": 2,
            "sex": 1,
            "nationality": "VN",
            "date_of_issue": "2021-01-10",
            "date_of_expiry": "2031-01-10",
            "documents": [
              {
                "type": 10,
                "files": [
                  {
                    "file_ref": "f_9k2m4xa1b2c3",
                    "filename": "passport.pdf",
                    "content_type": "application/pdf",
                    "size": 842114
                  }
                ]
              }
            ]
          }
        ],
        "documents": [
          {
            "type": 1,
            "date_of_issue": "2019-03-14",
            "files": [
              {
                "file_ref": "f_a71bcd445566",
                "filename": "incorporation.pdf",
                "content_type": "application/pdf",
                "size": 512880
              }
            ]
          }
        ]
      }
    }
  }
  ```

  ```json 401 theme={null}
  {
    "error": "unauthorized",
    "error_code": "UNAUTHORIZED",
    "message": "Invalid or missing signature"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "NOT_FOUND",
    "message": "No KYB record with this id under this partner",
    "detail": ""
  }
  ```
</ResponseExample>