Skip to main content
FVFalcon Veritas · DevelopersBack

Developer Portal

Falcon Veritas API

The FVI API is a REST-over-HTTPS interface built to OpenAPI 3.1, following industry standards (RFC 7807 problem details, RFC 6750 bearer tokens, RFC 8288 pagination links, RFC 7231 conditional requests, and the IETF API Versioning guidance). Every endpoint is tenant-scoped and enforced at the database via Postgres RLS.

Open API Reference Download OpenAPI 3.1 (YAML) Integration Guides

API Reference

Full OpenAPI 3.1 rendered with Redoc — all endpoints, schemas, examples.

Open

Integration Guides

Auth, pagination, webhooks, idempotency, error handling, SDK snippets.

Open

Changelog & Versioning

Semantic versioning, deprecation policy, migration notes.

Open

Base URLs

https://app-fvi.falconveritas.com (production)
https://fvi.lovable.app (hosted production alias)

Standards we follow

  • · OpenAPI 3.1.0
  • · RFC 7807 problem+json
  • · RFC 6750 Bearer tokens
  • · RFC 5789 PATCH / JSON Merge
  • · RFC 7232 ETag / If-Match
  • · RFC 8594 Sunset header
  • · ISO-8601 timestamps (UTC)
  • · SemVer 2.0 versioning

Authentication

Bearer JWT, session lifetime, SSO/SAML notes.

Open

Rate limits

Per-tenant token bucket. Retry-After semantics.

Open

Webhooks

HMAC signature, replay protection, event catalogue.

Open

Security

TLS 1.3, tenant isolation, BYOK, audit trail.

Open

Quick start (60 seconds)

# 1. Exchange your credentials for a bearer JWT via the sign-in flow
export FVI_TOKEN="eyJhbGciOi..."

# 2. Call the API — every request is tenant-scoped
curl -sS https://app-fvi.falconveritas.com/api/session \
  -H "Authorization: Bearer $FVI_TOKEN" \
  -H "Accept: application/json"

# 3. List reconciliation batches for your tenant
curl -sS https://app-fvi.falconveritas.com/api/reconciliation/batches \
  -H "Authorization: Bearer $FVI_TOKEN"