API Reference

CVAI Analysis API

Use the REST API to create analysis jobs, manage your USD balance, and retrieve structured insights programmatically. All responses follow a standard envelope with data and meta fields.

Analysis

5 endpoints

Response Format

Success Response

{
  "data": { ... },
  "meta": {
    "timestamp": "ISO-8601",
    "version": "v1"
  }
}

Error Response

{
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Insufficient balance",
    "details": "Balance: $0.00, required: $1.00"
  },
  "meta": {
    "timestamp": "ISO-8601",
    "version": "v1"
  }
}

Error Codes

401

UNAUTHORIZED

Not logged in

403

FORBIDDEN

Insufficient permissions

402

PAYMENT_REQUIRED

Not enough balance

400

VALIDATION_ERROR

Invalid request body

404

NOT_FOUND

Resource not found

429

RATE_LIMIT_EXCEEDED

Too many requests

Analysis Job Lifecycle

PENDING

PROCESSING

DELIVERED

FAILED

Funds are reserved from your USD balance when a job is created (PENDING).

On DELIVERED, the reserved amount is spent (permanent deduction).

On FAILED, the reserved amount is released back to your balance.