Skip to main content
GET
/
v1
/
series
/
{id}
/
observations
Get observations for a series
curl --request GET \
  --url https://api.vintl.io/v1/series/{id}/observations \
  --header 'X-API-Key: <api-key>'
{
  "object": "observation_series",
  "request_id": "<string>",
  "status": "<string>",
  "as_of": "2023-12-25",
  "series": {
    "id": "<string>",
    "title": "<string>",
    "frequency": "<string>"
  },
  "results": [
    {
      "date": "2023-07-01T00:00:00Z",
      "value": "22491.567",
      "as_of_date": "2023-10-26T00:00:00Z",
      "series_id": "GDPC1",
      "unit": "lin",
      "frequency": "Q",
      "source": "FRED"
    }
  ],
  "results_count": 123,
  "has_more": true,
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.vintl.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

API key prefixed with mda_live_sk_

Path Parameters

id
string
required

Query Parameters

as_of
string<date>

Point-in-time query. Returns observations as they were known on this date. Example: ?as_of=2023-10-26 returns GDP at the advance estimate value ($22,491.567B), not today's revised value ($22,840.989B). Requires Pro plan or higher.

from
string<date>

Start date (YYYY-MM-DD)

to
string<date>

End date (YYYY-MM-DD)

limit
integer
default:100
Required range: 1 <= x <= 1000
cursor
string

Opaque pagination cursor from previous response

Response

Observations. When as_of is provided, includes series metadata and as_of field.

object
string
Example:

"observation_series"

request_id
string
status
string
as_of
string<date>

Present only when ?as_of= was used

series
object

Present only when ?as_of= was used

results
object[]
results_count
integer
has_more
boolean
next_cursor
string
Last modified on April 2, 2026