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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# 인증 상태 확인

> 계정의 KYC 및 KYB 인증 목록을 가져오거나 ID로 하나를 조회하고, 각 상태의 의미를 확인하세요.

## 계정의 인증 목록 가져오기

계정의 `biz_` 태그를 `account_id` 쿼리 매개변수로 전달하면 해당 계정의 모든 인증을 가져올 수 있습니다. 계정에는 최대 두 개, 즉 개인 KYC(Know Your Customer) 인증 하나와 KYB(Know Your Business) 인증 하나가 있습니다.

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

```json Response theme={null}
{
  "data": [
    {
      "id": "idpf_xxxxxxxxxxxxx",
      "kind": "individual",
      "status": "approved",
      "first_name": "Jane",
      "last_name": "Doe",
      "date_of_birth": "1995-01-15",
      "country": "US",
      "address": {
        "line1": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105"
      },
      "requested_information": [],
      "created_at": "2026-06-03T22:15:00Z",
      "updated_at": "2026-06-04T10:00:00Z"
    }
  ]
}
```

## 단일 인증 조회하기

경로에 `idpf_` 태그를 전달해 하나의 프로필을 직접 읽으세요.

```bash cURL theme={null}
curl https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

응답은 단일 인증 객체입니다(목록의 `data` 배열 항목과 같은 형식).

## 상태

| 상태 | 의미 | 해야 할 일 |
| - | - | - |
| `pending` | 사용자가 아직 KYC를 완료하지 않음 | 사용자를 `session_url`로 보내세요 |
| `approved` | 신원 인증됨 | 사용자가 거래할 수 있음 |
| `rejected` | KYC 거절됨 | `restart: true`로 새 인증을 만드세요 |
| `action_required` | Whop에 추가 정보가 필요함 | `requested_information` 배열을 확인하세요. [RFI 처리](https://docs.whop.com/ko/developer/verification/rfis.md)를 참고하세요 |
| `not_started` | 프로필은 있지만 세션이 시작되지 않음 | 생성을 호출해 시작하세요 |

> [!NOTE]
>
> `session_url`은 `status`가 `pending`일 때만 표시되며, 사용자가 아직 KYC를 완료해야 한다는 뜻입니다. 승인되거나 거부되면 URL은 사라집니다.

## 응답 필드

필드는 `kind`에 따라 달라집니다. 개인 인증은 개인 필드를 반환하고, 사업체 인증은 계정 필드를 반환합니다.

### 개인(`kind: "individual"`)

| 필드 | 유형 | 설명 |
| - | - | - |
| `first_name` | `string` | 인증된 법적 이름 |
| `last_name` | `string` | 인증된 법적 성 |
| `date_of_birth` | `string` | ISO(International Organization for Standardization) 날짜(예: `1995-01-15`) |
| `country` | `string` | ISO 국가 코드 |
| `address` | `object` | 인증된 거주지 주소 |

### 사업체(`kind: "business"`)

| 필드 | 유형 | 설명 |
| - | - | - |
| `business_name` | `string` | 인증된 법인 이름 |
| `business_structure` | `string` | `private_corporation` 또는 `sole_proprietorship` 같은 법인 구조. [사업체 구조](https://docs.whop.com/ko/developer/verification/business-structures.md)를 참고하세요 |
| `registration_number` | `string` | 설립지에서 사업체가 등록된 인증된 번호(예: 미국의 주 파일 번호) |
| `country` | `string` | ISO 국가 코드 |
| `address` | `object` | 등록된 사업체 주소 |

## 인증

`identity:read` 스코프가 있는 계정 API 키가 필요합니다.

### 오류

| 상태 | 메시지 | 발생 시점 |
| - | - | - |
| `400` | `account_id is required` | `biz_` 태그가 제공되지 않음 |
| `401` | — | API 키가 없거나 유효하지 않음 |
| `403` | — | API 키에 `identity:read` 스코프가 없음 |
| `404` | `Account not found` | `biz_` 태그가 존재하지 않거나 액세스 권한이 없음 |


## Related topics

- [이용 권한 확인하기](https://docs.whop.com/ko/developer/guides/ios/check-entitlements.md)
- [KYC로 사용자 신원 인증하기](https://docs.whop.com/ko/developer/verification/overview.md)
- [KycElement](https://docs.whop.com/ko/elements/latest/verifications/kyc.md)
