Skip to content
VERIFY

Developers

Everything you need to integrate.

Code examples, guides and a sandbox to take your integration from first request to production.

Request Sandbox Access

Built for Developers. Designed for Enterprise.

Locate faces in an image and return bounding boxes, landmarks and quality indicators.

Request · POST /v1/face/detect
curl -X POST https://sandbox.api.verify.co.id/v1/face/detect \
  -H "Authorization: Bearer $VERIFY_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "data:image/jpeg;base64,/9j/4AAQ...",
    "return_landmarks": true
  }'
Response · 200
{
  "request_id": "req_test_7f3a91c2",
  "faces": [
    {
      "bounding_box": { "x": 212, "y": 148, "width": 286, "height": 286 },
      "landmarks": { "left_eye": [298, 251], "right_eye": [412, 249], "nose_tip": [356, 318] },
      "quality": { "sharpness": "good", "illumination": "good", "occlusion": false }
    }
  ]
}

Preview reference. Endpoints, fields and availability are illustrative and may change. Examples use fictional test data only.

API Documentation

Endpoint reference, request schemas and response formats.

Sandbox Access

Test integrations with fictional data before going live. Access on request.

Authentication Guide

API keys, request signing and key rotation best practices.

Webhooks

Receive asynchronous verification results with signed callbacks.

Error Handling

Consistent error codes, retries and idempotency guidance.

Integration Architecture

Reference flows for web, mobile, device and back-office systems.

Integration architecture

Your app / device
Your backend
VERIFY API
Webhook result
VERIFY Console
  1. 01Capture a selfie, fingerprint or e-KTP image in your app or on a VERIFY device.
  2. 02Send the capture from your backend to VERIFY API using your secret key.
  3. 03Receive a synchronous response or an asynchronous signed webhook.
  4. 04Review activity, audit logs and settings in VERIFY Console.

Preview reference. Endpoints, fields and availability are illustrative and may change. Examples use fictional test data only.