API Reference
The production contract for Veyrly Evidence Packs.
Request
POST
https://api.veyrly.com/v1/evidence| Field | Type | Rules |
|---|---|---|
query | string | Required, 1–400 characters |
freshness_seconds | integer | Optional, 60–31,536,000 |
max_sources | integer | Optional, 3–10; default 5 |
Fulfilled response
status | fulfilled |
|---|---|
query | Normalized request query |
answer | Evidence-backed answer text |
sources | title, url, snippet, published_at, updated_at |
freshness | required, satisfied, newest_timestamp |
evidence | source_count, distinct_source_count, validated |
fulfilled_at | ISO 8601 timestamp |
request_id | Request UUID |
Idempotency
Send a unique Idempotency-Key for each logical purchase. A successful replay returns the stored response and cannot trigger a second provider execution or settlement. Reusing a key with different input returns HTTP 409.
Errors
| 400 | Invalid request or missing idempotency key |
|---|---|
| 402 | Payment authorization required |
| 409 | Idempotency conflict |
| 422 | Economic guard or validation rejection |
| 429 | Rate limit exceeded |
| 502 | Provider or settlement failure |
Rate limits
Requests are rate limited. Capacity and economic safeguards may reject requests; clients should handle HTTP 429 and 422 without assuming fulfillment.