Reference

Lightweight public text endpoint that identifies the runtime host.

Public liveness endpoint used by deployment and health-check tooling.

Returns the canonical OpenAPI specification from `docs/openapi.yaml` for humans and tooling.

Returns normalized address and place suggestions from OpenRouteService geocoding autocomplete.

Thin proxy to OpenRouteService directions v2. The request body and successful response payloads are passed through as JSON. If ORS returns an HTTP error response, that upstream JSON payload is also passed through with the upstream status code. Local auth, rate-limit, and request-validation failures still use the standard Velvari `ErrorResponse` envelope.

Thin GET wrapper over OpenRouteService isochrones. Successful responses and upstream HTTP error payloads are passed through as JSON when the request reaches ORS. Local auth, rate-limit, and validation failures use the standard Velvari `ErrorResponse` envelope.

Thin proxy to OpenRouteService matrix v2. The request body and successful response payloads are passed through as JSON. If ORS returns an HTTP error response, that upstream JSON payload is also passed through with the upstream status code. Local auth, rate-limit, and request-validation failures still use the standard Velvari `ErrorResponse` envelope.

Returns a human-readable address label for the given coordinates.

Returns a compact route summary with normalized geometry for map rendering.

Reads the local JSON snapshot for an allowed public Suno profile handle and returns the normalized Songs-section snapshot. This endpoint does not fetch Suno live. Snapshot data comes from public Suno profile metadata and anonymous public unified feed pagination.

Searches one allowed cached Suno profile snapshot by title, style, lyrics, model, and minimum play count. Results can be sorted and limited without downloading the full profile snapshot.

Aggregates counters, model/style buckets, duration, and top songs from the cached Suno profile snapshot. This endpoint does not call Suno live.

Reads allowed public Suno profile metadata, resolves the public target user ID, paginates anonymous public unified feed `user_songs` with a top-level cursor, extracts valid public song clips, then atomically writes a local JSON snapshot. The sync is bounded by configured page and timeout limits, deduplicates songs by ID, and prevents a warning-state partial result from overwriting a larger existing snapshot. No private Suno account token, Browser-Token, Device-Id, cookies, or login flow is required.

Searches allowed cached Suno profile snapshots for a public song UUID and returns the full normalized song item. This endpoint does not call Suno live.

Reads the cached snapshot for an allowed Suno profile handle passed as `artist` and returns matching normalized songs by title. This endpoint does not call Suno live; it exists so clients can request full track metadata, counters, lyrics, and style fields without downloading the whole profile song list. Exact title matching is used by default. Set `exact=false` for case-insensitive substring matching.

Strict machine-friendly taxi-card contract for new integrations. Provide zero or one of `q`, `id`, `number`, `registration_mark`, or `vin`. The endpoint also accepts documented compatibility aliases for current clients. Use `valid` to filter MTR validity status. Runtime also accepts `kehtiv` and `validity_status`.

Card-style lookup by taxi-card identifier using the v2 response contract.