> ## 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, bir kişi veya işletme için yasal bir kimliği temsil eder.

Hesaplar ve kullanıcılar, Whop'un ödemeleri veya uyumluluk açısından hassas iş akışlarını etkinleştirmeden önce kim olduklarını doğrulaması gerektiğinde doğrulamayı tamamlar.

Verifications API'yi barındırılan bir doğrulama oturumunu başlatmak veya sürdürmek, inceleme durumunu kontrol etmek ve istenen ayrıntıları veya belgeleri göndermek için kullanın. `requested_information` öğeler içeriyorsa, yanıtları [Doğrulamayı Güncelle](https://docs.whop.com/tr/api-reference/verifications/update-verification.md) ile gönderin.

> [!NOTE]
>
> Legacy [Verifications](https://docs.whop.com/tr/api-reference/verifications/verification) kaynağının yerini alır. Mevcut Legacy entegrasyonları çalışmaya devam eder; kararlılık sözleşmesi için [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md) sayfasına bakın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Doğrulamaları Listele](https://docs.whop.com/tr/api-reference/verifications/list-verifications.md) | GET `/verifications` |
| [Doğrulamayı Getir](https://docs.whop.com/tr/api-reference/verifications/retrieve-verification.md) | GET `/verifications/{id}` |
| [Doğrulama Oluştur](https://docs.whop.com/tr/api-reference/verifications/create-verification.md) | POST `/verifications` |
| [Doğrulamayı Güncelle](https://docs.whop.com/tr/api-reference/verifications/update-verification.md) | PATCH `/verifications/{id}` |

## Öznitelikler

**id** `string`

Doğrulama profili kimliği, `idpf_` önekli.

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

Bu doğrulamanın okunduğu hesaplar, her biri `biz_` önekli: listelemede kullandığınız hesap, `include_subaccounts` ile ait olduğu hesap veya alt hesap ya da kimliğe göre getirildiğinde ait olduğu ve okuyabildiğiniz her hesap. Genellikle bir tanedir. Kişisel bir doğrulama için boştur.

**address** `object | null`

Doğrulama profilindeki adres. Adres ayarlanmadığında `null`.

> [accordion] Özellikler
>
> **city** `string | null`
>
> **country** `string | null`
>
> İki harfli ISO 3166-1 ülke kodu, örneğin `US`, `DE` veya `GB`.
>
> **line1** `string`
>
> Sokak adresinin ilk satırı.
>
> **line2** `string | null`
>
> Sokak adresinin ikinci satırı.
>
> **postal\_code** `string | null`
>
> Posta kodu.
>
> **state** `string | null`
>
> Eyalet, il veya bölge kodu, örneğin `CA`.

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

Yasal işletme adı.

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

İşletmenin yasal kuruluş yapısı, örneğin `private_corporation` veya `sole_proprietorship`. Desteklenen değerler kuruluş ülkesine göre değişir — bkz. [İşletme yapıları](https://docs.whop.com/tr/developer/verification/business-structures.md).

**country** `string | null`

İki harfli ISO 3166-1 ülke kodu, örneğin `US`, `DE` veya `GB`.

**created\_at** `string`

Doğrulama profilinin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

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

`YYYY-MM-DD` biçiminde.

**email** `string | null`

Doğrulama profilindeki e-posta adresi.

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

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

İşletmenin kurulduğu tarih, `YYYY-MM-DD` biçiminde, işletme doğrulaması için kayıtlı olduğu şekliyle. Yalnızca işletme doğrulamaları; gönderilene kadar `null`.

**kind** `string`

Kullanılabilir seçenekler: `individual`, `business`

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

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

İşletmenin sahipleri ve her birinin kendi doğrulamasının ilerleyişi. Bireysel doğrulamalar için boştur.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Sahip kimliği, `own_` önekli. Barındırılan oturumda eklenen sahip dahil, sahibi değiştirmek veya kaldırmak için bunu Update Verification'ın `owners` alanında gönderin.
>
> **date\_of\_birth** `string | null` *required*
>
> Sahibin kayıtlı doğum tarihi, `YYYY-MM-DD` biçiminde.
>
> **first\_name** `string | null` *required*
>
> **last\_name** `string | null` *required*
>
> **ownership\_percentage** `number | null` *required*
>
> Kişinin sahip olduğu işletme payı, 0 ile 100 arasında.
>
> **rejected\_checks** `string[]` *required*
>
> Sahibin doğrulaması geri gönderildiğinde sağlayıcının neyi reddettiği: `details` (adı, doğum tarihi veya diğer ayrıntıları kimliğiyle eşleşmiyor), `identity_document` veya `selfie`. Yalnızca bunları Update Verification ile düzeltin. Aksi halde boştur.
>
> Kullanılabilir seçenekler: `details`, `identity_document`, `selfie`
>
> **required\_documents** `object[]` *required*
>
> Sahibin belgeleri ve ilerleyişleri. `verification_id` ile eklenen bir sahip için boştur.
>
> > [accordion] Özellikler
> >
> > **document** `string`
> >
> > Belge yuvası anahtarı, örneğin `id_card_front`, `id_card_back` veya `selfie`.
> >
> > **rejection\_reason** `string | null`
> >
> > Sağlayıcı yeni belgeler istediğinde veya doğrulamayı reddettiğinde, önceki gönderimin neden reddedildiği.
> >
> > **status** `string`
> >
> > Belge incelemeye iletilene kadar `pending_upload`; sonrasında `submitted`.
> >
> > Kullanılabilir seçenekler: `pending_upload`, `submitted`
>
> **roles** `string[]` *required*
>
> Kişinin işletmeyle ilişkisi.
>
> Kullanılabilir seçenekler: `ubo`, `director`, `representative`, `shareholder`
>
> **status** `string` *required*
>
> Sahibin kendi doğrulamasının durumu, `status` ile aynı durumlarda. Belgelerinin yeniden gönderilmesi gerektiğinde `action_required`.
>
> Kullanılabilir seçenekler: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**phone** `string | null`

Doğrulama profilindeki telefon numarası.

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

İşletmenin kurulduğu eyalet veya bölge, işletme doğrulaması için kayıtlı olduğu şekliyle. Yalnızca işletme doğrulamaları; gönderilene kadar `null`.

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

İşletmenin kuruluş yerinde kayıtlı olduğu numara, örneğin ABD'de bir eyalet dosya numarası veya Birleşik Krallık'ta bir Company Number. Yalnızca işletme doğrulamaları; işletme doğrulaması için kayıtlı olduğu şekliyle veya gönderilene kadar `null`.

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

İncelemenin devam edebilmesi için Whop'un hâlâ neye ihtiyaç duyduğu; giriş başına bir gereksinim. Update Verification ile yanıtlayın. Yanıttan hiçbir şey geri yansıtılmaz. Geçerli olmayan anahtarlar atlanır. `documents` veya `owners` ile oluşturulan bir işletme doğrulaması için bu, incelemeye gönderilmeden önce hâlâ eksik olan işletme ayrıntılarını ve belgeleri içerir. Her sahibin belgeleri o sahibin altında listelenir.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> İstenen bilgi öğesi kimliği, `inrqi_` önekli.
>
> **action\_url** `string`
>
> İlgili bir eylem için URL, örneğin canlılık doğrulamasını tamamlama veya bir ödemeyi görüntüleme. Kullanılabilir eylem olmadığında bulunmaz.
>
> **alternative\_document\_label** `string`
>
> Bu öğeyi `value` yerine yanıtlayan bir belge, örneğin EIN eşleştirilemediğinde bir IRS EIN mektubu. Sayfalarını düzeltilmiş bir `value` ile veya olmadan `files` içinde gönderin. Yalnızca `value` kabul edildiğinde bulunmaz.
>
> **details\_label** `string`
>
> Bu gereksinimle birlikte gösterilen takip sorusu.
>
> **details\_required** `boolean`
>
> Görünür olduğunda takip yanıtının zorunlu olup olmadığı.
>
> **details\_visible\_for** `string[]`
>
> Takip sorusunu görünür kılan seçili seçenek değerleri.
>
> **errors** `object[]`
>
> Reddedilen bir gönderimden sonra bulunur.
>
> > [accordion] Özellikler
> >
> > **code** `string`
> >
> > Sabit hata kodu.
> >
> > **reason** `string`
> >
> > Neden reddedildiği.
>
> **label** `string` *required*
>
> Kullanıcıya gösterilecek talimat. Varsa incelemecinin notunu aynen taşır.
>
> **optional** `boolean`
>
> Öğe atlanabildiğinde `true`.
>
> **options** `string[]`
>
> Bir `select` öğesinde `value` alanının alabileceği değerler. Bir `id_document` öğesinde bunlar kabul edilen kimlik türleridir ve seçilen tür hangi `documents` yuvalarının gönderileceğini belirler. Öğede yapılacak bir seçim olmadığında bulunmaz.
>
> **requirement** `string` *required*
>
> Neyin gerektiği: `bank_statement` gibi bir belge adı veya `ssn` ya da `identity_document` gibi bir alan anahtarı. Tanınmayan değerleri `type` alanına göre işleyin.
>
> **response\_type** `string`
>
> Metin yanıtı için isteğe bağlı yerel giriş biçimi.
>
> Kullanılabilir seçenekler: `yes_no`, `yes_no_na`, `date`, `url`, `number`, `tel`
>
> **selection\_mode** `string`
>
> `options` içeren bir sorunun tek bir değer mi yoksa birden fazla değer mi kabul ettiği.
>
> Kullanılabilir seçenekler: `single`, `multiple`
>
> **supporting\_documents** `object[]`
>
> Bağlam için gereksinimle birlikte sağlanan belgeler.
>
> > [accordion] Özellikler
> >
> > **id** `string` *required*
> >
> > Dosyanın kimliği, `file_` önekli.
> >
> > **blurhash** `string | null` *required*
> >
> > Bir görsel veya video için BlurHash yer tutucusu. Mevcut olmadığında veya moderasyon tarafından kaldırıldığında Null.
> >
> > **content\_type** `string | null` *required*
> >
> > Orijinal dosyanın MIME türü, örneğin `application/pdf`. Moderasyon dosyayı kaldırdığında korunur.
> >
> > **created\_at** `string` *required*
> >
> > Dosyanın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Saniye cinsinden ses veya video süresi. Mevcut olmadığında veya moderasyon tarafından kaldırıldığında Null.
> >
> > **filename** `string | null` *required*
> >
> > Uzantısı dahil orijinal dosya adı.
> >
> > **height** `integer | null` *required*
> >
> > Piksel cinsinden görsel veya video yüksekliği. Mevcut olmadığında veya moderasyon tarafından kaldırıldığında Null.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > Her parçanın (sonuncusu hariç) olması gereken bayt boyutu. Yalnızca oluşturmada ve yalnızca çok parçalı yüklemeler için bulunur.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > `complete` çağrısına geri iletilen çok parçalı yüklemenin kimliği. Yalnızca oluşturmada ve yalnızca çok parçalı yüklemeler için bulunur.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > Her parça için önceden imzalanmış URL. Yalnızca oluşturmada ve yalnızca çok parçalı yüklemeler için bulunur.
> >
> > > [accordion] Özellikler
> > >
> > > **part\_number** `integer` *required*
> > >
> > > Bu parçanın çok parçalı yükleme içindeki 1 tabanlı dizini.
> > >
> > > **url** `string` *required*
> > >
> > > Bu parçanın baytlarının PUT ile gönderileceği önceden imzalanmış URL.
> >
> > **object** `string` *required*
> >
> > Bu nesnenin türü, her zaman `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Moderasyonun dosyayı kaldırıp kaldırmadığı. `true` olduğunda `url` yerine geçen bir görsel sunar. `filename`, `size` ve `content_type` hâlâ orijinal dosyayı tanımlar.
> >
> > **size** `integer | null` *required*
> >
> > Bayt cinsinden dosya boyutu. Yükleme tamamlanana kadar `null`.
> >
> > **upload\_headers** `object`
> >
> > Yükleme PUT isteğiyle gönderilecek başlıklar. Yalnızca oluşturmada bulunur.
> >
> > **upload\_status** `string` *required*
> >
> > Dosyanın yükleme yaşam döngüsünde nerede olduğu.
> >
> > Kullanılabilir seçenekler: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > Dosyanın baytlarının PUT ile gönderileceği önceden imzalanmış URL. Yalnızca oluşturmada ve yalnızca tek parçalı yüklemeler için bulunur.
> >
> > **url** `string | null` *required*
> >
> > Dosyayı indirmek için bir URL. Herkese açık dosyalar kalıcı bir CDN URL'si, özel dosyalar ise süresi dolan imzalı bir URL alır. Yükleme tamamlanana kadar `null`. Moderasyon dosyayı kaldırdığında, yerine geçen bir görsel URL'si.
> >
> > **visibility** `string` *required*
> >
> > `public` dosyalar imzasız bir CDN URL'sinden sunulur. `private` dosyalar süresi dolan imzalı bir URL'den sunulur.
> >
> > Kullanılabilir seçenekler: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > Ses dalga formu URL'si. Mevcut olmadığında veya moderasyon tarafından kaldırıldığında Null.
> >
> > **width** `integer | null` *required*
> >
> > Piksel cinsinden görsel veya video genişliği. Mevcut olmadığında veya moderasyon tarafından kaldırıldığında Null.
>
> **supporting\_files\_explanation\_allowed** `boolean`
>
> Yazılı bir açıklamanın gerekli destekleyici dosyaların yerine geçip geçemeyeceği.
>
> **supporting\_files\_required** `boolean`
>
> Bu gereksinimin ayrıca destekleyici dosyalar gerektirip gerektirmediği.
>
> **supporting\_files\_visible\_for** `string[]`
>
> Destekleyici dosya girişini görünür kılan seçili seçenek değerleri.
>
> **type** `string` *required*
>
> Yanıt olarak ne gönderileceği, böylece asla tahmin etmek zorunda kalmazsınız: `files` (sayfalarının listesi olarak bir belge), `id_document` (yüklediğiniz kimliğin yuva anahtarlarıyla `documents` gönderin), `text`, `date`, `phone` veya `select` (`value` gönderin), `text_with_files` (`value` ve isteğe bağlı `files` gönderin), `address` (`address` gönderin) veya `liveness` (`action_url` adresini açın, ardından tamamlandıktan sonra `value` değerini `true` olarak gönderin).

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

Belge yüklemeli bir doğrulamanın belgeleri ve ilerleyişleri. Yalnızca `documents` gönderilerek oluşturulan bireysel doğrulamalarda bulunur. `pending_upload` belgeleri henüz kabul edilmemiştir — tüm kümeyi başka bir Create Verification çağrısıyla yeniden gönderin.

> [accordion] Özellikler
>
> **document** `string`
>
> Belge yuvası anahtarı, örneğin `id_card_front`, `id_card_back` veya `selfie`.
>
> **rejection\_reason** `string | null`
>
> Sağlayıcı yeni belgeler istediğinde veya doğrulamayı reddettiğinde, önceki gönderimin neden reddedildiği.
>
> **status** `string`
>
> Belge incelemeye iletilene kadar `pending_upload`; sonrasında `submitted`.
>
> Kullanılabilir seçenekler: `pending_upload`, `submitted`

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

Kullanıcının kimlik kontrollerini tamamlaması için barındırılan doğrulama oturumu URL'si. Oluşturulduktan 7 gün sonra süresi dolar.

**status** `string`

Mevcut doğrulama durumu. Herhangi bir oturum yokken `not_started`; bir oturum kullanıcının girdisini beklerken `pending`; sağlayıcının otomatik kontrolleri yeni bir gönderim üzerinde çalışırken `processing`; `requested_information` yanıt gerektirdiğinde `action_required`; zaten gönderilmiş bilgiler incelenirken `manual_review` — bir denetim yanıtı veya ödeme sağlayıcısının tuttuğu bir belge — gönderilecek bir şey yoktur, genellikle 3 iş günü içinde tamamlanır; başarı durumunda `approved`; başarısızlık durumunda `rejected`. Yeni bir oturum başlatmak için Create Verification'ı yeniden çağırın.

Kullanılabilir seçenekler: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**updated\_at** `string`

Doğrulama profilinin son güncellendiği zaman, ISO 8601 zaman damgası olarak.

```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/tr/elements/latest/verifications/overview.md)
- [List verifications](https://docs.whop.com/tr/api-reference/legacy/verifications/list-verifications.md)
- [Retrieve verification](https://docs.whop.com/tr/api-reference/legacy/verifications/retrieve-verification.md)
