BOIVA

BOIVA Developer Hub

Integrate identity verification with confidence

Quickstarts on boiva.id, exact endpoint contracts in the canonical ReadMe API reference.

Canonical API Reference
POST /b2b/v1/identity-verification

Choose a verification type

The endpoint stays the same. Set type to IDVB, IDVS, or IDVC and send the fields required by that product.

IDVB

Basic data verification

Use when the flow needs identity-data matching without a selfie.

Required request fields

  • type: IDVB
  • ktp
  • fullname

Optional or contract-specific

birth_date

Response signals

ktp · fullname · birth_date · normalized (when applicable)

Canonical reference
IDVS

Data verification with selfie

Use when identity-data matching must include a selfie comparison.

Required request fields

  • type: IDVS
  • ktp
  • fullname
  • selfie_photo (Base64)

Optional or contract-specific

birth_date, birth_place

Response signals

identity field matches · selfie_photo · normalized (when applicable)

Canonical reference
IDVC

Comprehensive verification

Use for a layered flow that includes identity, selfie, and liveness signals.

Required request fields

  • type: IDVC
  • ktp
  • fullname
  • selfie_photo (Base64)

Optional or contract-specific

birth_date, birth_place

Response signals

identity field matches · selfie_photo · selfie_liveness score · normalized (when applicable)

Canonical reference

IDVB request example

Birth date is optional. If omitted, BOIVA may derive it from the NIK and return normalized when applicable.

curl --request POST \
  'https://sandbox.boiva.id/b2b/v1/identity-verification' \
  --header 'Authorization: {public-access-token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "IDVB",
    "ktp": "{nik}",
    "fullname": "{full-name}",
    "birth_date": "1995-06-15"
  }'

IDVS selfie input checklist

Prepare the image before Base64 encoding it.

  • JPG, JPEG, or PNG
  • Maximum file size: 5 MB
  • Minimum dimensions: 800 × 600 px
  • Forward-facing, clear lighting, face unobstructed
Source of truth: these pages are an integration guide. For complete response examples, current validation rules, status codes, and your assigned contract, use the canonical BOIVA API reference.