Endpoint for interacting with raw event-series events (read-write).

GET

Retrieving a paginated list of events requires a GET request to a list URL:

GET /api/v4/eventseries/<eventseries__uuid>/events/

Retrieving a single event requires a GET request to a detail URL:

GET /api/v4/eventseries/<eventseries__uuid>/events/<event__id>/

POST

Creating and an event requires a POST request to a list URL:

POST /api/v4/eventseries/<eventseries__uuid>/events/

DELETE

Deleting all events requires a DELETE request on a list URL:

DELETE /api/v4/eventseries/<eventseries__uuid>/events/

Query parameters (see below) may be used to control what events get deleted, for example:

DELETE /api/v4/eventseries/<eventseries__uuid>/events/?category=riolering

Deleting a single event requires a DELETE request on a detail URL:

DELETE /api/v4/eventseries/<eventseries__uuid>/events/<event__id>/

Query parameters:

category text filter on the category field. Supports the following lookups: exact and startswith.

start temporal filter on start, expects ISO 8601 format with timezone. UTC is easiest to use. An offset from UTC is also possible, but may require URL encoding of the plus sign for positive offsets.

end temporal filter on end, expects ISO 8601 format with timezone. UTC is easiest to use. An offset from UTC is also possible, but may require URL encoding of the plus sign for positive offsets.

duration temporal filter on the duration of an event. Supports both Django (e.g. 21:02:00) and ISO 8601 (e.g. PT21H2M) formatted durations.

geometry__within spatial filter on geometry, returns all events within the given geometry. Supported textual types include WKT, HEXEWKB, WKB (in a buffer), and GeoJSON.

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

?category__istartswith=riolering

?start__gte=2014-12-31T23:00:00Z
(using UTC)

?start__gte=2015-01-01T00:00:00%2B01:00
(using CET)

?duration__gte=PT24H

?geometry__within=POLYGON((5.61 52.66,5.62 52.66,5.62 52.67,5.61 52.67,5.61 52.66))

?last_modified__lt=2018-01-01T00:00:00Z
GET /api/v4/eventseries/7c7c08d6-ccd7-4325-8acb-41d9a85d4d4c/events/?format=api
HTTP 200 OK
Allow: GET, POST, DELETE, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "count": 5950,
    "next": "https://demo.lizard.net/api/v4/eventseries/7c7c08d6-ccd7-4325-8acb-41d9a85d4d4c/events/?format=api&page=2",
    "previous": null,
    "results": [
        {
            "id": 1137809,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    11.64833263676396,
                    49.12647052232064,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37124",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137803,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    11.47207269562895,
                    49.1582600617017,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37118",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137807,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    11.98073290381414,
                    49.10137595658691,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37122",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137808,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    11.88000196386125,
                    49.19096381695215,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37123",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137805,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    12.44267511688025,
                    49.22793939250897,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37120",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137802,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    12.0011265781105,
                    49.15270215491744,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37117",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137806,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    11.24704244086291,
                    49.2880233143662,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37121",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1137804,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    11.97709075042522,
                    48.9801633639471,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_37119",
                "start": "2018-03-07T23:00:00Z",
                "end": "2018-03-07T23:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1581852,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -122.6513,
                    49.15872,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_60754",
                "start": "2017-01-13T07:00:00Z",
                "end": "2017-01-13T07:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        },
        {
            "id": 1581853,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -122.1946,
                    49.02983,
                    0.0
                ]
            },
            "properties": {
                "category": "",
                "value": "start_60755",
                "start": "2017-01-06T06:00:00Z",
                "end": "2017-01-06T06:00:00Z",
                "last_modified": "2019-06-25T07:21:09.595266Z"
            }
        }
    ]
}