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",
  "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"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key prefixed with vntl_live_

Path Parameters

​
id
string
required

Query Parameters

​
as_of
string<date>

THE KILLER FEATURE. Returns observations as they were known on this date. Example: ?as_of=2023-10-26 returns GDP at the advance estimate value.

​
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

200 - application/json

Observations with optional point-in-time context

​
object
string
Example:

"observation_series"

​
as_of
string<date>
​
series
object
​
results
object[]
Last modified on March 29, 2026