Timeseries Instance – Django REST framework

Endpoint for interacting with timeseries metadata.

Query parameters:

uuid Exact filter on uuid.

uuid__in List filter on uuid. UUIDs must be comma separated.

name Filter on name. Filter methods exact and startswith are supported.

code Filter on code. Filter methods exact and startswith are supported.

start: Temporal filter on start. Supports various lookup types (exact, lt, lte, gt, gte; start__exact by default). Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.

end: Temporal filter on end. Supports various lookup types (exact, lt, lte, gt, gte; end__exact by default). Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.

value_type Filter on value_type. Choices are integer, float, boolean, text, image, movie, file, float array.

observation_type__id Filter on observation_type__id. Filter method exact is supported.

observation_type__code Filter on observation_type__code. Filter methods exact and startswith are supported.

datasource__id Filter on datasource__id. Filter method exact is supported.

datasource__uuid Filter on datasource__uuid field. Filter method exact is supported.

location__uuid Filter on location__uuid field. Filter method exact is supported.

location__organisation__uuid (Requires also filter on code) Filter on location__organisation__uuid. Filter method exact is supported.

monitoring_network__id Filter on monitoring_network__id. Filter method exact is supported.

access_modifier Filter on access_modifier, options are 'Public', 'Private', 'Common', or 'Hidden'.

created: Temporal filter on created. Supports various lookup types (exact, lt, lte, gt, gte; created__exact by default). Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.

last_modified: Temporal filter on last_modified. Supports various lookup types (exact, lt, lte, gt, gte; last_modified__exact by default). Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.

Examples

?uuid=d08a97db-80b4-4a0b-bc5b-078f97a948e5

?uuid__in=d08a97db-80b4-4a0b-bc5b-078f97a948e5,9723f42c-820a-4c5f-96ce-9febef948f53

?name=my-timeseries

?name__startswith=my-tim

?code=abc&location__uuid=b10eaf1f-2867-4ffb-8f4a-5eb9bd37dbf1

?code__startswith=a&location__uuid=b10eaf1f-2867-4ffb-8f4a-5eb9bd37dbf1

?start__gte=2017-01-01T00:00:00Z

?end__lt=2018-01-01T00:00:00Z

?value_type=float

?observation_type=1

?observation_type__id=1

?observation_type__code=my-code

?observation_type__code__startswith=my-c

?datasource=1

?datasource__id=1

?datasource__uuid=b10eaf1f-2867-4ffb-8f4a-5eb9bd37dbf1

?location__code=MOB_MP_P_5min

?location__name__startswith=Rotterdam

?location__organisation__uuid=b10eaf1f-2867-4ffb-8f4a-5eb9bd37dbf1

?location__uuid=b10eaf1f-2867-4ffb-8f4a-5eb9bd37dbf1

?access_modifier=Private

?access_modifier=100

?created__gte=2017-01-01T00:00:00Z

?last_modified__lt=2018-01-01T00:00:00Z

GET /api/v4/timeseries/24658f6c-aa11-4204-8a20-632b130d67fe/?format=api

HTTP 200 OK
Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "url": "https://demo.lizard.net/api/v4/timeseries/24658f6c-aa11-4204-8a20-632b130d67fe/?format=api",
    "uuid": "24658f6c-aa11-4204-8a20-632b130d67fe",
    "code": "P.meting.1m::second::1::60",
    "name": "P.meting.1m",
    "description": "",
    "start": "2025-02-04T02:01:00Z",
    "end": "2025-05-03T13:09:00Z",
    "value_type": "float",
    "last_value": 0.0,
    "interval": null,
    "observation_type": {
        "url": "https://demo.lizard.net/api/v4/observationtypes/1007/?format=api",
        "id": 1007,
        "code": "P.meting.1m",
        "parameter": "Neerslag",
        "unit": "mm",
        "scale": "ratio",
        "description": "Neerslag per minuut",
        "domain_values": null,
        "reference_frame": null,
        "compartment": null,
        "created": "2019-01-08T09:51:47.657274Z",
        "last_modified": "2019-06-25T07:26:10.441021Z"
    },
    "datasource": null,
    "supplier": null,
    "supplier_code": null,
    "location": {
        "url": "https://demo.lizard.net/api/v4/locations/ce241947-0d27-4b43-a194-9f3824b015f1/?format=api",
        "uuid": "ce241947-0d27-4b43-a194-9f3824b015f1",
        "name": "RM Egboetswater",
        "code": "MPN-A-19827"
    },
    "extra_metadata": {},
    "created": "2025-02-10T09:33:01.504152Z",
    "last_modified": "2025-05-03T13:40:40.556000Z",
    "access_modifier": "Public"
}