Variable Data

get

https://api.surfact.com/api/v1.6/variables/{variable_id}/values

Retrieves data points for a specific variable. A JSON response returns the last 100 data points by default. A format=csv request instead returns the whole retained series unless you constrain it with page_size or start/end — an unqualified CSV pull on a busy variable is an unbounded download. Supports pagination and time-range filtering.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

variable_id

string

required

Unique identifier of the variable

Query Params

token

string

Alternative authentication token (use instead of X-Auth-Token header)

page

integer

Page number for pagination. Ignored when format=csv: a CSV request always returns the first page, so pages 2..N of a CSV export are unreachable (page_size is still honoured).

page_size

integer

Number of results per page

start

int64

Start of time range as POSIX timestamp in milliseconds

end

int64

End of time range as POSIX timestamp in milliseconds

format

string

enum

Response format. Lower-case only — an unrecognised value (CSV included) returns HTTP 404 with code 404001, the identical body an unknown variable id returns, rather than a validation error. An empty format= falls back to JSON. An Accept: text/csv request header is equivalent to format=csv.

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Paginated list of data points for the variable

400A query parameter could not be parsed — for example a non-numeric start or end. Returns the bare {detail} shape with no code.

401Unauthorized

403Requested time range is older than the account's data retention window.

404Unknown variable id, or an unrecognised format value. Both return the same body, so a 404 here does not necessarily mean the variable is missing.