v1.0 · Stable

Vivela API.

A REST API for partners and internal services. All endpoints require a bearer token, enforce rate limits, and emit signed audit events.

Base URL
https://api.vivela.app
Auth
Authorization: Bearer ‹token›
Rate limit
120 req / min
POST/v1/auth/verify
Auth required

Submit ID + selfie for verification.

Request
{
  "idDocUrl": "string",
  "selfieUrl": "string"
}
Response
{
  "status": "pending",
  "verificationId": "ver_8x21"
}
GET/v1/auth/session
Auth required

Return current session.

Response
{
  "user": {
    "id": "u_a8",
    "role": "seeker",
    "verified": true
  }
}