Skip to main content
All errors return RFC 9457 Problem Details with content type application/problem+json.

​
Format

{
  "type": "https://vintl.io/errors/validation-error",
  "title": "Validation Error",
  "status": 400,
  "detail": "invalid 'from' date: use YYYY-MM-DD format",
  "instance": "/v1/treasury/yields",
  "request_id": "req_19d22fd0193a..."
}
FieldDescription
typeURI identifying the error category
titleShort summary
statusHTTP status code
detailWhat went wrong in this specific request
instanceRequest path
request_idInclude this in support requests

​
Error types

StatusType suffixCause
400validation-errorBad parameter value or format
401unauthorizedMissing or invalid API key
404not-foundSeries or resource doesn’t exist
429rate-limit-exceededDaily quota exceeded
500internal-errorServer error (rare — if persistent, contact support)

​
Common mistakes

​
Wrong date format

{ "status": 400, "detail": "invalid 'from' date: use YYYY-MM-DD format" }
Dates must be YYYY-MM-DD. The API rejects MM/DD/YYYY, 2023-1-5, and ISO timestamps in query parameters.

​
Unknown series

{ "status": 404, "detail": "series 'INVALID' not found" }
Series IDs are uppercase: GDPC1, not gdpc1. Use GET /v1/series?q=GDP to search.

​
Missing API key

{ "status": 401, "detail": "missing X-API-Key header" }
See Authentication. The header name is X-API-Key, not Authorization.

​
Rate limit exceeded

{ "status": 429, "detail": "daily limit of 10000 requests exceeded" }
Read the Retry-After header for seconds until reset. See Rate limits for retry strategy.
Last modified on March 29, 2026