Skip to main content
POST
/
verifications
curl --request POST \ --url https://api.anycheck.ai/verifications \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "service_id": "3fc8b757-57d3-4607-998c-9bfbc4efa6cf", "folder_id": "your-folder-uuid", "configuration": { "verification_type": "KTP_PEP", "fraud_detection": false, "files": { "ktp_file": [ "<path from POST /upload>" ] } } } '
{ "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "service": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": "KTP & PEP" }, "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "api_key": null, "folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "result_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "execution_time": 2.284, "status": "COMPLETED", "start_date": "2023-11-07T05:31:56Z", "end_date": "2023-11-07T05:31:56Z", "input_config": { "verification_type": "KTP_SELFIE", "files": { "ktp_file": [ "/uploads/ktp.jpg" ], "selfie_file": [ "/uploads/selfie.jpg" ] }, "fraud_detection": false }, "input_file_url": { "ktp_file": [ "https://example.com/files/ktp.jpg" ], "selfie_file": [ "https://example.com/files/selfie.jpg" ] }, "output": { "face_match_confidence_level": "LOW", "face_match_confidence_score": 2.284846674563825, "is_match_face": false }, "output_file_url": "https://example.com/output.json", "external_job_id": { "ocr_job_id": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "fraud_job_id": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ] }, "webhook_url": "https://your-app.com/webhook", "webhook_metadata": {}, "export_file_url": "https://example.com/export.xlsx", "credit_used": 10, "total_files": 2, "total_pages": 5, "created_at": "2023-11-07T05:31:56Z", "updated_at": "2023-11-07T05:31:56Z" }

Authorizations

X-API-Key
string
header
required

API key for service-to-service authentication

Body

application/json
service_id
string<uuid>
required

Service ID obtained from GET /services

folder_id
string<uuid>
required

Folder to organize verification

configuration
object
required

Service-specific input configuration. Keys and required fields differ per service.

For fields that require a file, first upload via POST /uploads and pass the returned path inside a files object keyed by the field name:

"files": { "ktp_file": ["<path from POST /upload>"] }

See the Verification Services guide for complete per-service field reference, validation rules, and output schemas.

result_id
string<uuid>

Optional result ID to group verifications

webhook_url
string<uri> | null

Your endpoint URL to receive real-time status updates when the verification progresses. AnyCheck will POST a signed payload to this URL on each status change. See the Webhooks guide for payload format and signature verification.

Example:

"https://your-app.com/webhooks/anycheck"

webhook_metadata
object

Optional metadata attached to the webhook. Use the webhook_secret key to set a per-verification HMAC signing secret. If omitted, the payload is still sent but without HMAC signing.

Example:
{ "webhook_secret": "your-signing-secret" }

Response

Verification created

id
string<uuid>

Unique verification identifier

service
object
user_id
string<uuid> | null

User who created the verification

api_key
string | null

API key used for this verification

Example:

null

folder_id
string<uuid>

Folder containing this verification

result_id
string<uuid>

Result group identifier

execution_time
number<float>

Processing time in seconds

Example:

2.284

status
enum<string>

Current verification status

Available options:
DRAFT,
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELLED,
NEED_REVIEW,
FRAUD_DETECTED,
PARTIALLY_COMPLETED,
PARTIALLY_FAILED
Example:

"COMPLETED"

start_date
string<date-time> | null

Processing start time

end_date
string<date-time> | null

Processing end time

input_config
object

Service-specific input configuration

Example:
{
  "verification_type": "KTP_SELFIE",
  "files": {
    "ktp_file": ["/uploads/ktp.jpg"],
    "selfie_file": ["/uploads/selfie.jpg"]
  },
  "fraud_detection": false
}
input_file_url
object

URLs of input files organized by file type

Example:
{
  "ktp_file": ["https://example.com/files/ktp.jpg"],
  "selfie_file": ["https://example.com/files/selfie.jpg"]
}
output
object

Verification results and extracted data

Example:
{
  "face_match_confidence_level": "LOW",
  "face_match_confidence_score": 2.284846674563825,
  "is_match_face": false
}
output_file_url
string<uri> | null

URL to download detailed results

Example:

"https://example.com/output.json"

output_status
enum<string> | null

Overall verification result status

Available options:
VERIFIED,
NOT_VERIFIED,
PARTIALLY_NOT_VERIFIED
external_job_id
object

External processing job identifiers

webhook_url
string<uri> | null

Webhook URL for notifications

Example:

"https://your-app.com/webhook"

webhook_metadata
object

Custom metadata for webhook

export_file_url
string<uri> | null

URL to download exported results

Example:

"https://example.com/export.xlsx"

credit_used
integer

Credits consumed by this verification

Example:

10

total_files
integer

Number of files processed

Example:

2

total_pages
integer

Number of pages processed

Example:

5

created_at
string<date-time>

Verification creation timestamp

updated_at
string<date-time>

Last update timestamp