API Overview

Valydar is a REST API. All requests use JSON and require an API key.

Base URLs

Environment	Base URL
Sandbox (dev)	`https://api.dev.valydar.com`
Production	coming soon

All requests require an API key in the Authorization: Bearer header:

-H "Authorization: Bearer YOUR_API_KEY"

Method	Endpoint	Description
`POST`	`/verifications/{id}/documents`	Upload a document

Method	Endpoint	Description
`POST`	`/verifications/{id}/selfie`	Upload a selfie
`POST`	`/verifications/{id}/face-match`	Run face match
`POST`	`/verifications/{id}/documents/{doc_id}/liveness`	Run document liveness
`POST`	`/verifications/{id}/selfie-liveness`	Passive selfie liveness
`POST`	`/verifications/{id}/deepfake`	Detect deepfake / AI-generated selfie
`POST`	`/verifications/{id}/active-liveness/challenge`	Generate active liveness challenge
`POST`	`/verifications/{id}/active-liveness/verify`	Verify active liveness

Method	Endpoint	Description
`POST`	`/verifications/{id}/nfc`	Verify ePassport chip (passive/active/chip auth)

Method	Endpoint	Description
`POST`	`/demo/verify`	Public no-auth demo (document, face match, AML, NFC, liveness)

All responses are JSON:

{
  "id": "vry_a1b2c3d4e5f6",
  "status": "pending",
  "client_reference": "user_123",
  "redirect_url": ""
}

{
  "error": {
    "code": "unauthorized",
    "message": "The provided API key is invalid"
  }
}