Pump Station Instance – Django REST framework

List assets of type PumpStation

Query parameters:

organisation Filter by organisation. Supports lookups on uuid and name.

code Exact filter on the code field. The (case-sensitive) startswith lookup is also supported.

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.

geometry The following lookups are available: isnull, contained, contains, contains_properly, covered_by, covers, crosses, disjoint, equals, intersects, overlaps, and within. Query geometries can be supplied as WKT, EWKT or HEXEWKB.

boundary__id: Filter on geometry of the region/boundary with the id boundary__id. For a list of regions/boundaries, see the boundary endpoint /api/v4/boundaries/

boundary__code: Filter on geometry of the region/boundary with the id boundary__code. For a list of regions/boundaries, see the boundary endpoint /api/v4/boundaries/

boundary__type: Spatial filter on geometry, whereby geometry is specified by a region/boundary object (see below) and filter operator is ST_Intersects. Available types are COUNTRY, PROVINCE, WATER_BOARD, MUNICIPALITY, CATCHMENT, POLDER, FIXED_DRAINAGE_LEVEL_AREA, PUMPED_DRAINAGE_AREA, MAIN_PUMPED_DRAINAGE_AREA, DISTRICT, NEIGHBOURHOOD, CADASTRE, PLANTATION, FIELD, CITY, and CUSTOM

boundary__name: Filter on name of the region/boundary with the name boundary__name. Requires boundary__type. For a list of regions/boundaries, see the boundary endpoint /api/v4/boundaries/

simplify: Simplify the query geometries (in WGS84) using this value as tolerance. A higher value may result in a better response time for detailed geometries. Defaults to 0.00001 degrees (approx. 1 meter). NB: Returned geometries are unaffected.

page_size The number of results on a single page. Defaults to 10, maximum is 100. Note that pagination is disabled for the root endpoint: the response will be truncated to page_size.

Custom route: search

Full-text search in 'code' and 'name' fields. Results are ranked.

Examples:

?code=ABC_2123

?code__startswith=ABC

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

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

?organisation__name__startswith=Nelen

?organisation__uuid=61f5a464-c350-44c1-9bc7-d4b42d7f58cb

?organisation__name__icontains=Schuur

?geometry__intersects=POINT (5 52)

?boundary__id=198

?boundary__code=NL_GM0344

?boundary__type=PROVINCE&boundary__name=Utrecht

/search/abc/

GET /api/v4/pumpstations/23596/?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/pumpstations/23596/?format=api",
    "id": 23596,
    "code": "KW218610",
    "organisation": {
        "url": "https://demo.lizard.net/api/v4/organisations/c9c9dd63-49ac-4c7e-bd43-4906dd90f671/?format=api",
        "uuid": "c9c9dd63-49ac-4c7e-bd43-4906dd90f671",
        "name": "HDSR"
    },
    "geometry": {
        "type": "Point",
        "coordinates": [
            5.013850698546571,
            52.14644853226743,
            0.0
        ]
    },
    "last_modified": "2025-06-13T12:37:18.076795Z",
    "created": "2019-07-25T14:35:33.989143Z",
    "image_url": "",
    "timeseries": [],
    "pumps": [
        {
            "url": "https://demo.lizard.net/api/v4/pumps/3760/?format=api",
            "id": 3760,
            "timeseries": [
                "https://demo.lizard.net/api/v4/timeseries/5c29a3ac-b8d7-4b4d-a4b6-ecafa54e4430/?format=api",
                "https://demo.lizard.net/api/v4/timeseries/6529a850-a799-4f9e-82fb-8f0245ed3646/?format=api",
                "https://demo.lizard.net/api/v4/timeseries/3b32f2d9-c377-4e68-a23a-0db6c77a1ff4/?format=api",
                "https://demo.lizard.net/api/v4/timeseries/17ef3676-d0cf-4a90-9c70-48c5cd6aa090/?format=api"
            ],
            "pump_station": "https://demo.lizard.net/api/v4/pumpstations/23596/?format=api",
            "name": "HAARRIJN_2186-K_HAARRIJN-pompvijzel1_afvoer",
            "code": "KW218611",
            "type": "other",
            "serial": 1,
            "allowed_flow_direction": null,
            "capacity": null,
            "start_level": null,
            "stop_level": null,
            "start_level_delivery_side": null,
            "stop_level_delivery_side": null,
            "reduction_factor_no_levels": null,
            "reduction_factor": null,
            "characteristics": null,
            "last_modified": "2025-06-13T11:36:27.811876Z",
            "created": "2025-06-13T11:36:27.811892Z"
        },
        {
            "url": "https://demo.lizard.net/api/v4/pumps/3776/?format=api",
            "id": 3776,
            "timeseries": [
                "https://demo.lizard.net/api/v4/timeseries/31824827-110b-443b-a5f0-188646595176/?format=api",
                "https://demo.lizard.net/api/v4/timeseries/7923452b-f181-450d-ba5f-1defff2de5ac/?format=api",
                "https://demo.lizard.net/api/v4/timeseries/a608f9be-fa02-48a6-a6d7-113bfaf9533c/?format=api",
                "https://demo.lizard.net/api/v4/timeseries/b86c4461-5a3e-4da7-927c-3fe76735639a/?format=api"
            ],
            "pump_station": "https://demo.lizard.net/api/v4/pumpstations/23596/?format=api",
            "name": "HAARRIJN_2186-K_HAARRIJN-pompvijzel2_afvoer",
            "code": "KW218612",
            "type": "other",
            "serial": 2,
            "allowed_flow_direction": null,
            "capacity": null,
            "start_level": null,
            "stop_level": null,
            "start_level_delivery_side": null,
            "stop_level_delivery_side": null,
            "reduction_factor_no_levels": null,
            "reduction_factor": null,
            "characteristics": null,
            "last_modified": "2025-06-13T12:37:17.980707Z",
            "created": "2025-06-13T12:37:17.980723Z"
        }
    ],
    "type": "other",
    "name": "HAARRIJN_2186-K_HAARRIJN",
    "start_point": null,
    "end_point": null,
    "connection_serial": null,
    "allowed_flow_direction": null,
    "capacity": null,
    "start_level": null,
    "stop_level": null,
    "start_level_delivery_side": null,
    "stop_level_delivery_side": null
}