---
title: "Create Identity Verification (API only flow)"
method: POST
path: "/v2/accounts/{account_id}/identity_verification_api"
tags: ["Verification"]
---

# Create Identity Verification (API only flow)

`POST /v2/accounts/{account_id}/identity_verification_api`

Submit document images and a selfie photo directly to perform identity verification only with API (without the need to open hosted verification website). The caller uploads files via multipart/form-data.

Only the account itself or its parent account can create a verification session.

**Primary vs Secondary IDs:** Document types are classified as either primary or secondary. Primary IDs require only 1 document. Secondary IDs require 2 different secondary documents.

## Path parameters

- `account_id` string, required

## Response `200`

Verification session created successfully

- VerificationAPISessionResponse
  - `data` VerificationAPISession — Verification session created via the API-only flow (no hosted URL)
    - `id` string — Unique identifier for the verification session
    - `account_id` string — Account ID associated with this verification
    - `status` 'pending' | 'in_progress' | 'completed' — Verification session status
    - `result` 'pending' | 'passed' | 'failed' | 'invalid' — Verification result
    - `created_at` integer — Unix timestamp when the verification session was created
    - `expired_at` integer — Unix timestamp when the verification session will expire (72 hours after creation)

## Other responses

- `400` — Bad request - invalid verification status
- `401` — Unauthorized
- `403` — Forbidden - not authorized to access this account
- `404` — Account not found
- `502` — Verification or Files service unavailable

---

[API](https://skmtc.net/paymongo/apis/paymongo-api.md) · [All operations](https://skmtc.net/paymongo/apis/paymongo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymongo/paymongo-api/revisions/c18f9a027b2c/schema)