Endpoint for interacting with locations.

Query parameters

uuid: Text filter on uuid. Field filter method exact is supported.

name: Text filter on name. Field filter methods exact, startswith are supported.

code: Text filter on code. Field filter methods exact, startswith are 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.

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

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

organisation__uuid Text filter on organisation__uuid. Field filter method exact is supported.

geom_isnull: Boolean filter on geometry.

geom_within: Spatial filter on geometry. Supports WKT, HEXEWKB, and GeoJSON.

object_id: Number filter on the id attribute of an object. Field filter method exact is supported. To be used in combination with object_type.

object__id: Numerical filter on object__id. Field filter method exact is supported.

object__type: Text filter on object__type. Field filter methods exact is supported.

ordering: Offers basic ordering functionality on the name and last_modified attribute of locations. Orderings may be reversed by prefixing the attribute with '-'.

page: To prevent system overloads, list-view results are paginated. This parameter specifies which page to return.

page_size: The maximum number of results to return in list-view. The default is 10.

Examples

?name__startswith=gemaal

?name=gemaal

?code=ABC

?code__startswith=A

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

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

?organisation__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

?geom_isnull=false

?geom_within=POLYGON((4.87 52.73, 4.87 52.79, 4.98 52.79, 4.98 52.73,
4.87 52.73))

?geom_within={"type": "Polygon", "coordinates": [[[4.87, 52.73],
[4.87, 52.79], [4.98, 52.79], [4.98, 52.73], [4.87, 52.73]]]}

?object__id=1

?object__type=building

?ordering=name
GET /api/v4/locations/ef975ae1-2bc9-42f0-8c81-4d3048b379bd/?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/locations/ef975ae1-2bc9-42f0-8c81-4d3048b379bd/?format=api",
    "uuid": "ef975ae1-2bc9-42f0-8c81-4d3048b379bd",
    "name": "32HL0052001",
    "code": "32HL0052001",
    "geometry": {
        "type": "Point",
        "coordinates": [
            5.638185394412113,
            52.04062135284028,
            0.0
        ]
    },
    "organisation": {
        "url": "https://demo.lizard.net/api/v4/organisations/e7d66583-43b2-4c90-b118-f2093798885a/?format=api",
        "uuid": "e7d66583-43b2-4c90-b118-f2093798885a",
        "name": "Vitens NV"
    },
    "object": {
        "id": 62263,
        "type": "filter"
    },
    "access_modifier": "Public",
    "extra_metadata": {
        "bro": {
            "id": 17154,
            "glue": "ongespecificeerd",
            "aquifer": null,
            "tubeType": "standaardbuis",
            "tubeNumber": 1,
            "removalDate": null,
            "dateModified": "2025-06-13T15:46:48Z",
            "geoOhmCables": [],
            "sockMaterial": "geen",
            "tubeMaterial": "onbekend",
            "filterInRoute": true,
            "temporal_data": [
                {
                    "id": 39613,
                    "start": "1974-08-13T23:00:00Z",
                    "initial": true,
                    "broEvent": "None",
                    "tubeStatus": "onbekend",
                    "dateModified": "2023-01-06T02:50:43Z",
                    "referenceLevel": 12.8,
                    "instrumentDepth": null,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39614,
                    "start": "1975-09-14T23:00:00Z",
                    "initial": false,
                    "broEvent": "29795",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 12.74,
                    "instrumentDepth": null,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39615,
                    "start": "1980-11-13T23:00:00Z",
                    "initial": false,
                    "broEvent": "29796",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.4,
                    "instrumentDepth": null,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39616,
                    "start": "1994-05-01T22:00:00Z",
                    "initial": false,
                    "broEvent": "29797",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": null,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39617,
                    "start": "1994-05-02T10:00:00Z",
                    "initial": false,
                    "broEvent": "47764",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": null,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39618,
                    "start": "2002-03-31T22:00:00Z",
                    "initial": false,
                    "broEvent": "29798",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": 5.01,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39619,
                    "start": "2009-05-27T08:50:00Z",
                    "initial": false,
                    "broEvent": "47765",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": 4.5,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39620,
                    "start": "2009-08-24T09:45:00Z",
                    "initial": false,
                    "broEvent": "47766",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": 4.2,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39621,
                    "start": "2009-11-30T09:10:00Z",
                    "initial": false,
                    "broEvent": "47767",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": 3.75,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39622,
                    "start": "2010-09-30T09:55:00Z",
                    "initial": false,
                    "broEvent": "47768",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": 5.01,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 39623,
                    "start": "2013-12-18T13:55:00Z",
                    "initial": false,
                    "broEvent": "47769",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.48,
                    "instrumentDepth": 5.06,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 67210,
                    "start": "2015-11-05T23:00:00Z",
                    "initial": false,
                    "broEvent": "14854",
                    "tubeStatus": "onbekend",
                    "dateModified": "2022-12-06T11:01:33Z",
                    "referenceLevel": 13.472,
                    "instrumentDepth": 5.06,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 68725,
                    "start": "2018-12-03T09:30:00Z",
                    "initial": false,
                    "broEvent": "47770",
                    "tubeStatus": "onbekend",
                    "dateModified": "2023-01-17T12:04:19Z",
                    "referenceLevel": 13.472,
                    "instrumentDepth": 5.06,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                },
                {
                    "id": 77619,
                    "start": "2022-07-05T11:11:00Z",
                    "initial": false,
                    "broEvent": "21202",
                    "tubeStatus": "onbekend",
                    "dateModified": "2023-01-17T12:04:56Z",
                    "referenceLevel": 13.472,
                    "instrumentDepth": 5.1,
                    "tubeTopDiameter": null,
                    "insertedPartLength": null,
                    "insertedPartPresent": false,
                    "insertedPartDiameter": null,
                    "insertedPartMaterial": null,
                    "tubeTopPositioningMethod": "waterpassing0tot2cm"
                }
            ],
            "filterTopDepth": 8.7,
            "broid_gld_imbro": null,
            "tubeBottomDepth": 7.7,
            "broid_gld_imbroa": null,
            "constructionDate": "1974-08-14T00:00:00Z",
            "variableDiameter": "nee",
            "filterBottomDepth": 7.7,
            "sedimentSumpLength": null,
            "sedimentSumpPresent": false,
            "tubePackingMaterial": "filtergrind",
            "numberOfGeoOhmCables": 0,
            "artesianWellCapPresent": false
        }
    },
    "created": "2016-02-10T15:36:29.643233Z",
    "last_modified": "2025-06-13T15:46:48.945565Z",
    "last_modified_by": "vitens_api"
}