---
title: "bulk export of point event timeseries"
method: GET
path: "/export/point-events"
tags: ["export"]
---

# bulk export of point event timeseries

`GET /export/point-events`

## Request

- Base URL: `https://api.relynk.io/v2.0.0`
- URL: `https://api.relynk.io/v2.0.0/export/point-events`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Returns up to 200 000 point events per request together with a `nextUrl` for the following page. Designed for full historical export of a customer's point event data and continuous delta export.

**Initial request** — POST with only `customerId`. The server finds the earliest observation time for the customer and returns events from that time onwards`.

**Continuation** — Follow `nextUrl` from the previous response (or pass its `cursor` query parameter manually). The `cursor` value is the cursor value from the previous response.


Repeat POST requests using each `nextUrl` until the export 0 events is returned. To get future events, store the `nextUrl` and use this at a scheduled interval to receive future events ensuring to always store and use the latest `nextUrl` from last response.

## Query parameters

- `customerId` string, uuid, required
- `cursor` string

## Response `200`

page of compact point events with continuation URL

- ExportPointEventsResponse
  - `events` ExportPointEvent[], required
    - `r` string, uuid, required: point resource id
    - `t` string, date-time, required: observation timestamp
    - `v` number, required: numeric point value
  - `nextUrl` string, uri, required: absolute URL for the next POST request. Contains customerId and cursor query parameters. Follow this URL until a page returns zero.

## Other responses

- `400`: invalid cursor (e.g. cursor in the future)
- `404`: no point events exist for the customer

---

[API](https://skmtc.dev/relynk/apis/relynk-api.md) - [All operations](https://skmtc.dev/relynk/apis/relynk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/relynk/apis/relynk-api/revisions/735d9d0efe06?raw)