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

# Verifications API

> Verification은 개인 또는 비즈니스의 법적 신원을 나타냅니다.

계정과 사용자는 Whop이 지급이나 규정 준수에 민감한 워크플로를 활성화하기 전에 신원을 확인해야 할 때 인증을 완료합니다.

Verifications API를 사용하여 호스팅된 인증 세션을 시작하거나 재개하고, 검토 상태를 확인하고, 요청된 정보나 문서를 제출하세요. `requested_information`에 항목이 있으면 [Update Verification](https://docs.whop.com/ko/api-reference/verifications/update-verification.md)으로 답변을 제출하세요.

> [!NOTE]
>
> 레거시 [Verifications](https://docs.whop.com/ko/api-reference/verifications/verification) 리소스를 대체합니다. 기존 레거시 통합은 계속 작동합니다. 안정성 약속은 [API 버전](https://docs.whop.com/ko/developer/api/versioning.md)을 참조하세요.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [인증 목록 조회](https://docs.whop.com/ko/api-reference/verifications/list-verifications.md) | GET `/verifications` |
| [인증 조회](https://docs.whop.com/ko/api-reference/verifications/retrieve-verification.md) | GET `/verifications/{id}` |
| [인증 생성](https://docs.whop.com/ko/api-reference/verifications/create-verification.md) | POST `/verifications` |
| [인증 업데이트](https://docs.whop.com/ko/api-reference/verifications/update-verification.md) | PATCH `/verifications/{id}` |

## 속성

**id** `string`

인증 프로필 ID이며, 접두사는 `idpf_`입니다.

**account\_ids** `string[]` *required*

이 인증이 조회된 대상 계정으로, 각각 `biz_` 접두사가 붙습니다: 목록 조회에 사용한 계정, `include_subaccounts` 사용 시 인증이 속한 계정 또는 하위 계정, 또는 ID로 조회한 경우 인증이 속하며 읽을 수 있는 모든 계정. 보통 하나입니다. 개인 인증의 경우 비어 있습니다.

**address** `object | null`

인증 프로필의 주소. 주소가 설정되지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **city** `string | null`
>
> **country** `string | null`
>
> `US`, `DE`, `GB`와 같은 두 글자 ISO 3166-1 국가 코드.
>
> **line1** `string`
>
> 도로명 주소의 첫 번째 줄.
>
> **line2** `string | null`
>
> 도로명 주소의 두 번째 줄.
>
> **postal\_code** `string | null`
>
> 우편번호입니다.
>
> **state** `string | null`
>
> `CA`와 같은 주, 도 또는 지역 코드.

**business\_name** `string | null`

법적 사업자명.

**business\_structure** `string | null`

`private_corporation` 또는 `sole_proprietorship`과 같은 비즈니스의 법적 실체 구조. 지원되는 값은 설립 국가에 따라 다릅니다. [비즈니스 구조](https://docs.whop.com/ko/developer/verification/business-structures.md)를 참조하세요.

**country** `string | null`

`US`, `DE`, `GB`와 같은 두 글자 ISO 3166-1 국가 코드.

**created\_at** `string`

인증 프로필이 생성된 시점(ISO 8601 타임스탬프).

**date\_of\_birth** `string | null`

`YYYY-MM-DD` 형식.

**email** `string | null`

인증 프로필의 이메일 주소.

**first\_name** `string | null`

**incorporation\_date** `string | null`

비즈니스 인증에 기록된 비즈니스 설립일(`YYYY-MM-DD` 형식). 비즈니스 인증에만 해당하며, 전송될 때까지 `null`입니다.

**kind** `string`

사용 가능한 옵션: `individual`, `business`

**last\_name** `string | null`

**owners** `object[]` *required*

비즈니스의 소유자와 각 소유자 자신의 인증 진행 상황. 개인 인증의 경우 비어 있습니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 소유자 ID이며, 접두사는 `own_`입니다. 호스팅된 세션에서 추가된 소유자를 포함하여 소유자를 변경하거나 제거하려면 Update Verification의 `owners`에 이 값을 보내세요.
>
> **date\_of\_birth** `string | null` *required*
>
> 기록된 소유자의 생년월일(`YYYY-MM-DD` 형식).
>
> **first\_name** `string | null` *required*
>
> **last\_name** `string | null` *required*
>
> **ownership\_percentage** `number | null` *required*
>
> 개인이 소유한 비즈니스 지분(0\~100).
>
> **rejected\_checks** `string[]` *required*
>
> 소유자의 인증이 반려되었을 때 제공업체가 거부한 항목: `details`(이름, 생년월일 또는 기타 정보가 신분증과 일치하지 않음), `identity_document` 또는 `selfie`. Update Verification으로 이 항목만 수정하세요. 그 외에는 비어 있습니다.
>
> 사용 가능한 옵션: `details`, `identity_document`, `selfie`
>
> **required\_documents** `object[]` *required*
>
> 소유자의 문서와 진행 상황. `verification_id`로 추가된 소유자의 경우 비어 있습니다.
>
> > [accordion] 속성
> >
> > **document** `string`
> >
> > `id_card_front`, `id_card_back` 또는 `selfie`와 같은 문서 슬롯 키.
> >
> > **rejection\_reason** `string | null`
> >
> > 제공업체가 새 문서를 요청하거나 인증을 거절한 경우, 이전 제출이 거부된 이유.
> >
> > **status** `string`
> >
> > 문서가 검토를 위해 전달될 때까지는 `pending_upload`, 그 이후에는 `submitted`입니다.
> >
> > 사용 가능한 옵션: `pending_upload`, `submitted`
>
> **roles** `string[]` *required*
>
> 해당 개인과 비즈니스의 관계.
>
> 사용 가능한 옵션: `ubo`, `director`, `representative`, `shareholder`
>
> **status** `string` *required*
>
> 소유자 자신의 인증 진행 상태로, `status`와 같은 상태를 사용합니다. 문서를 다시 보내야 하는 경우 `action_required`입니다.
>
> 사용 가능한 옵션: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**phone** `string | null`

인증 프로필의 전화번호.

**place\_of\_incorporation** `string | null`

비즈니스 인증에 기록된 비즈니스 설립 주 또는 지역. 비즈니스 인증에만 해당하며, 전송될 때까지 `null`입니다.

**registration\_number** `string | null`

미국의 주 파일 번호나 영국의 Company Number처럼 비즈니스가 설립지에서 등록된 번호. 비즈니스 인증에만 해당하며, 비즈니스 인증에 기록된 값이거나 전송될 때까지 `null`입니다.

**requested\_information** `object[]`

검토를 계속하기 전에 Whop이 아직 필요로 하는 항목으로, 항목당 하나의 요구 사항입니다. Update Verification으로 답변하세요. 응답의 어떤 내용도 다시 표시되지 않습니다. 해당하지 않는 키는 생략됩니다. `documents` 또는 `owners`로 생성된 비즈니스 인증의 경우, 검토를 위해 전송하기 전에 아직 누락된 비즈니스 정보와 문서가 포함됩니다. 각 소유자의 문서는 해당 소유자 아래에 나열됩니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 요청된 정보 항목 ID이며, 접두사는 `inrqi_`입니다.
>
> **action\_url** `string`
>
> 라이브니스 인증 완료나 결제 보기와 같은 관련 작업의 URL. 사용 가능한 작업이 없으면 없습니다.
>
> **alternative\_document\_label** `string`
>
> `value` 대신 이 항목에 답변하는 문서로, 예를 들어 EIN을 매칭할 수 없을 때의 IRS EIN 서한입니다. 수정된 `value`와 함께 또는 없이 문서의 페이지를 `files`로 보내세요. `value`만 허용되는 경우 없습니다.
>
> **details\_label** `string`
>
> 이 요구 사항과 함께 표시되는 후속 질문.
>
> **details\_required** `boolean`
>
> 표시될 때 후속 응답이 필수인지 여부.
>
> **details\_visible\_for** `string[]`
>
> 후속 질문을 표시하게 하는 선택된 옵션 값.
>
> **errors** `object[]`
>
> 제출이 거부된 후에 존재합니다.
>
> > [accordion] 속성
> >
> > **code** `string`
> >
> > 고정 오류 코드.
> >
> > **reason** `string`
> >
> > 거부된 이유.
>
> **label** `string` *required*
>
> 사용자에게 표시할 안내. 검토자의 메모가 있으면 그대로 포함합니다.
>
> **optional** `boolean`
>
> 항목을 건너뛸 수 있으면 `true`입니다.
>
> **options** `string[]`
>
> `select` 항목에서 `value`가 가질 수 있는 값. `id_document` 항목에서는 허용되는 신분증 유형이며, 선택한 유형에 따라 보낼 `documents` 슬롯이 결정됩니다. 항목에 선택할 사항이 없으면 없습니다.
>
> **requirement** `string` *required*
>
> 필요한 것: `bank_statement`와 같은 문서 이름, 또는 `ssn`이나 `identity_document`와 같은 필드 키. 인식할 수 없는 값은 `type`으로 처리하세요.
>
> **response\_type** `string`
>
> 텍스트 응답을 위한 선택적 네이티브 입력 형식.
>
> 사용 가능한 옵션: `yes_no`, `yes_no_na`, `date`, `url`, `number`, `tel`
>
> **selection\_mode** `string`
>
> `options`가 있는 질문이 하나의 값을 받는지 여러 값을 받는지 여부.
>
> 사용 가능한 옵션: `single`, `multiple`
>
> **supporting\_documents** `object[]`
>
> 컨텍스트를 위해 요구 사항과 함께 제공되는 문서.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 파일 ID로, 접두사는 `file_`입니다.
> >
> > **blurhash** `string | null` *required*
> >
> > 이미지 또는 동영상의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 원본 파일의 MIME 유형으로, 예를 들어 `application/pdf`입니다. 모더레이션으로 파일이 삭제되어도 유지됩니다.
> >
> > **created\_at** `string` *required*
> >
> > 파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > 오디오 또는 동영상의 재생 시간(초)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
> >
> > **filename** `string | null` *required*
> >
> > 확장자를 포함한 원본 파일 이름입니다.
> >
> > **height** `integer | null` *required*
> >
> > 이미지 또는 동영상의 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > 각 파트(마지막 파트 제외)가 가져야 하는 바이트 크기입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > 멀티파트 업로드의 ID로, `complete`에 다시 전달합니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > 각 파트의 미리 서명된 URL입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
> >
> > > [accordion] 속성
> > >
> > > **part\_number** `integer` *required*
> > >
> > > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스입니다.
> > >
> > > **url** `string` *required*
> > >
> > > 이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
> >
> > **object** `string` *required*
> >
> > 이 객체의 유형으로, 항상 `file`입니다.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > 모더레이션으로 파일이 삭제되었는지 여부입니다. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
> >
> > **size** `integer | null` *required*
> >
> > 파일 크기(바이트)입니다. 업로드가 완료될 때까지 `null`입니다.
> >
> > **upload\_headers** `object`
> >
> > 업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
> >
> > **upload\_status** `string` *required*
> >
> > 파일의 업로드 수명 주기 단계입니다.
> >
> > 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > 파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 그리고 단일 파트 업로드에서만 존재합니다.
> >
> > **url** `string | null` *required*
> >
> > 파일을 다운로드할 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 삭제된 경우 대체 이미지 URL입니다.
> >
> > **visibility** `string` *required*
> >
> > `public` 파일은 서명되지 않은 CDN URL에서 제공됩니다. `private` 파일은 만료되는 서명된 URL에서 제공됩니다.
> >
> > 사용 가능한 옵션: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > 오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
> >
> > **width** `integer | null` *required*
> >
> > 이미지 또는 동영상의 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
>
> **supporting\_files\_explanation\_allowed** `boolean`
>
> 필수 증빙 파일을 서면 설명으로 대체할 수 있는지 여부.
>
> **supporting\_files\_required** `boolean`
>
> 이 요구 사항에 증빙 파일도 필요한지 여부.
>
> **supporting\_files\_visible\_for** `string[]`
>
> 증빙 파일 입력을 표시하게 하는 선택된 옵션 값.
>
> **type** `string` *required*
>
> 추론할 필요가 없도록 답변으로 보낼 내용: `files`(페이지 목록으로 된 문서), `id_document`(업로드하는 신분증의 슬롯 키와 함께 `documents`를 보냄), `text`, `date`, `phone` 또는 `select`(`value`를 보냄), `text_with_files`(`value`와 선택적 `files`를 보냄), `address`(`address`를 보냄), 또는 `liveness`(`action_url`을 연 다음 완료 후 `value`를 `true`로 보냄).

**required\_documents** `object[]`

문서 업로드 인증의 문서와 진행 상황. `documents`를 보내 생성된 개인 인증에만 존재합니다. `pending_upload` 문서는 아직 수락되지 않았으므로, Create Verification을 다시 호출하여 전체 문서 세트를 다시 보내세요.

> [accordion] 속성
>
> **document** `string`
>
> `id_card_front`, `id_card_back` 또는 `selfie`와 같은 문서 슬롯 키.
>
> **rejection\_reason** `string | null`
>
> 제공업체가 새 문서를 요청하거나 인증을 거절한 경우, 이전 제출이 거부된 이유.
>
> **status** `string`
>
> 문서가 검토를 위해 전달될 때까지는 `pending_upload`, 그 이후에는 `submitted`입니다.
>
> 사용 가능한 옵션: `pending_upload`, `submitted`

**session\_url** `string | null`

사용자가 신원 확인을 완료할 수 있는 호스팅된 인증 세션 URL. 생성 후 7일이 지나면 만료됩니다.

**status** `string`

현재 인증 상태. 세션이 존재하기 전에는 `not_started`, 세션에 사용자 입력이 필요한 동안에는 `pending`, 새 제출에 대해 제공업체의 자동 확인이 실행되는 동안에는 `processing`, `requested_information`에 답변이 필요한 경우 `action_required`, 이미 보낸 정보(감사 답변 또는 지급 제공업체가 보유한 문서)가 검토 중인 동안에는 `manual_review`(제출할 것은 없으며 보통 영업일 기준 3일 이내에 완료), 성공 시 `approved`, 실패 시 `rejected`입니다. 새 세션을 시작하려면 Create Verification을 다시 호출하세요.

사용 가능한 옵션: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**updated\_at** `string`

인증 프로필이 마지막으로 업데이트된 시점(ISO 8601 타임스탬프).

```json Verification theme={null}
{
	"id": "idpf_xxxxxxxxxxxx",
	"account_ids": ["biz_xxxxxxxxxxxxxx"],
	"address": {
		"city": "New York",
		"country": "US",
		"line1": "123 Spring Street",
		"line2": "Apt 4B",
		"postal_code": "10012",
		"state": "NY"
	},
	"owners": [
		{
			"id": "idpf_xxxxxxxxxxxx",
			"first_name": "Riley",
			"last_name": "Owner",
			"date_of_birth": "1985-06-01",
			"ownership_percentage": 60,
			"required_documents": [
				{
					"document": "passport_front",
					"rejection_reason": null,
					"status": "submitted"
				},
				{
					"document": "selfie",
					"rejection_reason": null,
					"status": "submitted"
				}
			],
			"roles": ["ubo", "director"],
			"status": "processing",
			"rejected_checks": []
		}
	],
	"business_name": null,
	"business_structure": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"date_of_birth": "1990-01-01",
	"email": "alex@example.com",
	"first_name": "Alex",
	"kind": "individual",
	"last_name": "Rivera",
	"phone": "+15551234567",
	"registration_number": null,
	"requested_information": [
		{
			"id": "inrqi_xxxxxxxxxxx",
			"label": "Identity document",
			"options": ["PASSPORT", "ID_CARD", "DRIVERS", "RESIDENCE_PERMIT"],
			"requirement": "identity_document",
			"type": "id_document"
		},
		{
			"id": "inrqi_yyyyyyyyyyy",
			"label": "Bank Statement or a check for account ending in 4242",
			"requirement": "bank_statement",
			"type": "files"
		}
	],
	"required_documents": [
		{
			"document": "id_card_front",
			"rejection_reason": null,
			"status": "submitted"
		},
		{
			"document": "id_card_back",
			"rejection_reason": null,
			"status": "submitted"
		},
		{
			"document": "selfie",
			"rejection_reason": null,
			"status": "submitted"
		}
	],
	"session_url": "https://verify.whop.com/session/idpf_xxxxxxxxxxxx",
	"status": "action_required",
	"updated_at": "2026-06-02T12:00:00Z"
}
```


## Related topics

- [Verifications](https://docs.whop.com/ko/elements/latest/verifications/overview.md)
- [Verification](https://docs.whop.com/ko/api-reference/legacy/verifications/verification.md)
- [List verifications](https://docs.whop.com/ko/api-reference/legacy/verifications/list-verifications.md)
