---
title: "Timeseries Data"
method: GET
path: "/api/v1/timeseries"
---

# Timeseries Data

`GET /api/v1/timeseries`

## Request

- Base URL: `https://sibfly.com`
- URL: `https://sibfly.com/api/v1/timeseries`
- Auth: HTTP bearer

Real multi-year cumulative vertical-motion history for an address (from the cube).
A+1: pass reference_date=YYYY-MM-DD & reference_date2=YYYY-MM-DD to also get the movement between two dates.
Same agent contract as /motion: dry_run + max_age_days free gates, Idempotency-Key replay, 402 when broke.

## Query parameters

- `address` string
- `lat` number
- `lon` number
- `reference_date` string
- `reference_date2` string
- `dry_run` integer
- `max_age_days` integer
- `max_points` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Unauthorized
- `402`: Out of credits / spend cap
- `422`: Validation Error
- `429`: Rate limited (un-keyed)

---

[API](https://skmtc.dev/sibfly/apis/sibfly-api.md) · [All operations](https://skmtc.dev/sibfly/apis/sibfly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sibfly/apis/sibfly-api/revisions/90d2c9643f31?raw)