Quickstart
Authenticated JSON docs for taxi-card, ORS, and cached Suno endpoints. Start with /v2/cards/taxi, then continue into Reference, Examples, or raw OpenAPI.
Overview
Authenticated JSON API for the strict taxi-card contract,
OpenRouteService helpers and proxy endpoints, and cached public Suno
profile song search, lookup, stats, and sync. Public meta routes
expose the runtime index, health check, and raw OpenAPI document. For
protected routes, send an API key as either X-API-Key or Authorization: Bearer, request JSON, and start from the
canonical paths in this snapshot.
Make your first request
curl "https://api.velvari.ee/v2/cards/taxi?registration_mark=123ABC&include_vehicle=true" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Accept: application/json"/v2/cards/taxi Versioning model
Route versions define the live API contract. Spec version, release date, and stage describe this committed OpenAPI snapshot.
/v1, /v2 in paths such as /v1/* and /v2/cards/taxi.
0.8.3-beta is the release label for this OpenAPI document.
04.05.2026 and beta do not
replace route versioning.
Common responses
| Status | Meaning |
|---|---|
| 200 | Successful response. |
| 400 | Request shape or parameters are invalid. |
| 401 | Missing or invalid API credentials. |
| 403 | Authenticated, but the requested resource is not allowed. |
| 404 | The requested record or upstream resource was not found. |
| 429 | Rate limit reached locally or upstream. |
| 500 | Server-side or upstream failure. Retry carefully. |
| 503 | Server-side or upstream failure. Retry carefully. |
{
"error": {
"code": "invalid_request",
"message": "The request payload is invalid."
}
}Main resources
Start from these resource groups when you need the canonical endpoint family.
Meta
Public runtime index, health check, and raw OpenAPI delivery.
Taxi Cards v2
Search by plate, name, card id, number, VIN, or fetch a card by id.
OpenRouteService
Route summaries, autocomplete, reverse geocode, isochrones, directions, and matrix proxy calls.
Suno
Cached public Suno profile snapshots, song search, song lookup, stats, and sync.
Canonical paths
/, /healthz, and /openapi.yaml without authentication for runtime identity,
liveness, and raw contract delivery.
/v2/cards/taxi and /v2/cards/taxi/{id}
for taxi-card integrations, plus the namespaced /v1/ors/*
paths for ORS and /v1/suno/* paths for cached Suno profile,
song, and stats work.
/v2/cards/taxi.