Scenario List
Endpoint for interacting with 3Di scenarios.
Subendpoints
Scenario results are available via /api/v4/scenarios/{uuid}/results/. Here, {uuid} should be replaced with the scenario's uuid.
Basic result processing can be started for a raw 3Di result via /api/v4/scenarios/{uuid}/process.
These subendpoints, as well as more detailed documentation about the endpoints, are also available via the "Extra Actions" button in the top-right corner when viewing a scenario instance on /api/v4/scenarios/{uuid}/.
Query parameters
name
Text filter on the name field. Supports the following lookups:
exact, startswith, icontains, and isnull.
uuid
Filter on the uuid field, supports exact lookups only.
organisation
Filter on organisation.
project
Filter on the project's name, code, or uuid. The name and code support
all text field filter methods: startswith, endswith, icontains, etc.
The uuid field only supports exact lookups.
extra_metadata
Filter on extra_metadata. Filter statements are given as a json
dictionary whose keys are filter statements, and the values
of the dictionary are the values to filter on.
All filter methods are supported, also on nested elements of the field.
model_name
Text filter on the model_name field. Supports the following lookups:
exact, startswith, icontains, and isnull.
supplier
Related field text filter on the username and email fields of
supplier. For these fields, the following lookups are supported:
exact, startswith, icontains, and isnull.
Additionally, the isnull filter is supported on the supplier field
itself.
access_modifier
Filter on access_modifier, options are
'Public', 'Private', 'Common', or 'Hidden'.
ordering
Show the results in a specific order.
You can order them by created, last_modified, name,
organisation__name, username, model_name or total_size.
Add a - in front to reverse the order.
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:
?name=What
?name__icontains=wha
?name__startswith=wha
?extra_metadata={"comment__icontains": "water", "number__gte": "5", "nested_field__number__lte": "5"}
?uuid=e7a8
?uuid=10415ccb-ec31-4d43-bdb3-db597061527b
?uuid=88F7-4C9F-8F28,15EA-4B7F-B2ED
?organisation__name__startswith=Nelen
?organisation__name=DDSC
?organisation__name__startswith=Nelen
?organisation__name__icontains=Schuur
?organisation__uuid=61f5a464c35044c19bc7d4b42d7f58cb
?project__name=project_name
?project__name__icontains=PROJECT_name
?project__code=project_code_1234
?project__code__icontains=CODE_1234
?project__uuid=e1518dd0-254a-414f-a69e-8434a8a89e0a
?model_revision__icontains=em
?model_name__endswith=em
?supplier__username__icontains=em
?supplier__email=user@nelen-schuurmans.com
?supplier__isnull=true
?access_modifier=Private
?access_modifier=100
?ordering=name
?ordering=-created
?created__gte=2017-01-01T00:00:00Z
?last_modified__lt=2018-01-01T00:00:00Z
GET /api/v4/scenarios/?format=api
{ "count": 167, "next": "https://demo.lizard.net/api/v4/scenarios/?format=api&page=2", "previous": null, "results": [ { "url": "https://demo.lizard.net/api/v4/scenarios/5ce1ebf1-59f5-4adf-8673-8c9cdd0dcc88/?format=api", "uuid": "5ce1ebf1-59f5-4adf-8673-8c9cdd0dcc88", "name": "tw_forecast2025_v1_op", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/74983d5a-0fd8-4c22-bb09-e7656d570fb6/?format=api", "uuid": "74983d5a-0fd8-4c22-bb09-e7656d570fb6", "name": "Frogtech" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2025-04-15T05:06:29.285340Z", "last_modified": "2025-04-18T04:34:51.728617Z", "simulation_identifier": "292118", "simulation_start": "2025-04-18T00:00:00Z", "simulation_end": "2025-04-19T01:00:00Z", "supplier": "kuan-wei.chen", "source": "3Di", "model_identifier": "70993", "model_revision": "63781", "model_name": "tw_forecast2025-1", "has_raw_results": true, "total_size": 3856656105, "spatial_bounds": { "west": 120.0152421004418, "east": 122.01112880802167, "north": 25.336054593451987, "south": 21.89397982206044 }, "projection": "EPSG:3826", "origin_x": 150867.5, "origin_y": 2422145.0, "pixelsize_x": 10.0, "pixelsize_y": 10.0, "upper_bound_x": 351787.5, "upper_bound_y": 2803365.0 }, { "url": "https://demo.lizard.net/api/v4/scenarios/c95b08f5-4c8b-4638-aafe-5b134aaf9e77/?format=api", "uuid": "c95b08f5-4c8b-4638-aafe-5b134aaf9e77", "name": "tw_fst2025_v3_op", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/74983d5a-0fd8-4c22-bb09-e7656d570fb6/?format=api", "uuid": "74983d5a-0fd8-4c22-bb09-e7656d570fb6", "name": "Frogtech" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2025-03-30T09:16:11.246438Z", "last_modified": "2025-04-16T06:47:55.062964Z", "simulation_identifier": "291460", "simulation_start": "2025-04-15T22:00:00Z", "simulation_end": "2025-04-16T23:00:00Z", "supplier": "kuan-wei.chen", "source": "3Di", "model_identifier": "70536", "model_revision": "63263", "model_name": "tw_fst2025-3", "has_raw_results": true, "total_size": 8774170996, "spatial_bounds": { "west": 120.0152421004418, "east": 122.01112880802167, "north": 25.336054593451987, "south": 21.89397982206044 }, "projection": "EPSG:3826", "origin_x": 150867.5, "origin_y": 2422145.0, "pixelsize_x": 10.0, "pixelsize_y": 10.0, "upper_bound_x": 351787.5, "upper_bound_y": 2803365.0 }, { "url": "https://demo.lizard.net/api/v4/scenarios/90ee6870-18da-47ec-aa04-fbc6e5f7e038/?format=api", "uuid": "90ee6870-18da-47ec-aa04-fbc6e5f7e038", "name": "10 feb validation event2", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/568a4d88-c1b3-4566-8759-dd9b305f619d/?format=api", "uuid": "568a4d88-c1b3-4566-8759-dd9b305f619d", "name": "RHDHV unlimited" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2025-03-27T09:33:25.051848Z", "last_modified": "2025-03-27T13:40:54.996626Z", "simulation_identifier": "285334", "simulation_start": "2025-02-09T00:00:00Z", "simulation_end": "2025-02-12T00:00:00Z", "supplier": null, "source": "3Di", "model_identifier": "62919", "model_revision": "55275", "model_name": "parramatta-3-1", "has_raw_results": true, "total_size": 386124962, "spatial_bounds": { "west": 150.8949116786102, "east": 151.10926491003679, "north": -33.73005003509316, "south": -33.84380842604828 }, "projection": "EPSG:32756", "origin_x": 305220.0, "origin_y": 6253550.0, "pixelsize_x": 1.0, "pixelsize_y": 1.0, "upper_bound_x": 324839.0, "upper_bound_y": 6265790.0 }, { "url": "https://demo.lizard.net/api/v4/scenarios/a01d8369-5288-4e5e-aa14-1934671bfe9c/?format=api", "uuid": "a01d8369-5288-4e5e-aa14-1934671bfe9c", "name": "tw_fst2025_v2_op", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/74983d5a-0fd8-4c22-bb09-e7656d570fb6/?format=api", "uuid": "74983d5a-0fd8-4c22-bb09-e7656d570fb6", "name": "Frogtech" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2025-03-21T03:13:01.660959Z", "last_modified": "2025-03-28T03:47:50.719025Z", "simulation_identifier": "285548", "simulation_start": "2025-03-28T02:00:00Z", "simulation_end": "2025-03-29T03:00:00Z", "supplier": "kuan-wei.chen", "source": "3Di", "model_identifier": "70113", "model_revision": "62792", "model_name": "tw_fst2025-2", "has_raw_results": true, "total_size": 3916301583, "spatial_bounds": { "west": 120.0152421004418, "east": 122.01112880802167, "north": 25.336054593451987, "south": 21.89397982206044 }, "projection": "EPSG:3826", "origin_x": 150867.5, "origin_y": 2422145.0, "pixelsize_x": 10.0, "pixelsize_y": 10.0, "upper_bound_x": 351787.5, "upper_bound_y": 2803365.0 }, { "url": "https://demo.lizard.net/api/v4/scenarios/4452e49a-f37d-4d7f-8f18-fce463172051/?format=api", "uuid": "4452e49a-f37d-4d7f-8f18-fce463172051", "name": "Voor digital twin Utrecht_7 2025-02-12 15-04-19 #1 - T100", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2025-02-12T15:11:09.842984Z", "last_modified": "2025-02-12T15:36:47.429757Z", "simulation_identifier": "273932", "simulation_start": "2024-01-01T01:00:00Z", "simulation_end": "2024-01-01T05:00:00Z", "supplier": "sa_tools", "source": "3Di", "model_identifier": "69196", "model_revision": "61779", "model_name": "voor-digital-twin-utrecht_7-2025-02-12-15-04-19-1", "has_raw_results": true, "total_size": 127018171, "spatial_bounds": { "west": 5.104352283130329, "east": 5.133644629836107, "north": 52.10251586403496, "south": 52.084473605859806 }, "projection": "EPSG:28992", "origin_x": 135620.49093675, "origin_y": 455171.781979614, "pixelsize_x": 0.5, "pixelsize_y": 0.5, "upper_bound_x": 137620.49093675, "upper_bound_y": 457171.781979614 }, { "url": "https://demo.lizard.net/api/v4/scenarios/aee370db-d66d-4864-bcf2-b83149c71f8a/?format=api", "uuid": "aee370db-d66d-4864-bcf2-b83149c71f8a", "name": "Z0075 - IPDC - Aruba #9 - '1 126mmh 15min - '2- 59mmh_2h - '3 320mm_2.5h_3", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "project": "https://demo.lizard.net/api/v4/projects/eed183ea-d1aa-4a70-9cde-deb66fb3dc32/?format=api", "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2024-12-23T09:44:12.014609Z", "last_modified": "2025-01-15T09:56:06.078276Z", "simulation_identifier": "262225", "simulation_start": "2000-01-01T12:00:00Z", "simulation_end": "2000-01-01T20:00:00Z", "supplier": "remo.vantilburg", "source": "3Di", "model_identifier": "67895", "model_revision": "60397", "model_name": "z0075-ipdc-aruba-9", "has_raw_results": true, "total_size": 1717230043, "spatial_bounds": { "west": -70.11004367934356, "east": -69.81926862605599, "north": 12.670056964850435, "south": 12.366301404603485 }, "projection": "EPSG:32619", "origin_x": 379460.9643, "origin_y": 1367308.8597, "pixelsize_x": 2.0, "pixelsize_y": 2.0, "upper_bound_x": 410934.9643, "upper_bound_y": 1400788.8597 }, { "url": "https://demo.lizard.net/api/v4/scenarios/1d895334-6aca-4445-9fc4-00d500ff4a03/?format=api", "uuid": "1d895334-6aca-4445-9fc4-00d500ff4a03", "name": "BODIS_Testcase_v4_Rotterdam_Bloemhof_future #2 - bui09", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2024-08-19T09:00:49.140964Z", "last_modified": "2024-08-20T10:00:23.898751Z", "simulation_identifier": "213458", "simulation_start": "2024-01-01T01:00:00Z", "simulation_end": "2024-01-01T02:00:00Z", "supplier": "stijn.overmeen", "source": "3Di", "model_identifier": "65948", "model_revision": "58452", "model_name": "bodis_testcase_v4_rotterdam_bloemhof_future-2", "has_raw_results": true, "total_size": 48121831, "spatial_bounds": { "west": 4.49344880290635, "east": 4.509765834762842, "north": 51.89840413549082, "south": 51.889591611381135 }, "projection": "EPSG:28992", "origin_x": 93486.0, "origin_y": 433830.0, "pixelsize_x": 0.5, "pixelsize_y": 0.5, "upper_bound_x": 94597.5, "upper_bound_y": 434797.0 }, { "url": "https://demo.lizard.net/api/v4/scenarios/83dbe61b-c32b-4e32-b543-02fcdc913d97/?format=api", "uuid": "83dbe61b-c32b-4e32-b543-02fcdc913d97", "name": "BODIS_Testcase_v4_Rotterdam_Bloemhof #2 - bui09", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2024-08-16T12:50:59.480153Z", "last_modified": "2024-08-20T10:01:07.004291Z", "simulation_identifier": "212851", "simulation_start": "2024-01-01T01:00:00Z", "simulation_end": "2024-01-01T02:00:00Z", "supplier": "stijn.overmeen", "source": "3Di", "model_identifier": "65834", "model_revision": "58330", "model_name": "bodis_testcase_v4_rotterdam_bloemhof-2", "has_raw_results": true, "total_size": 48467098, "spatial_bounds": { "west": 4.49344880290635, "east": 4.509765834762842, "north": 51.89840413549082, "south": 51.889591611381135 }, "projection": "EPSG:28992", "origin_x": 93486.0, "origin_y": 433830.0, "pixelsize_x": 0.5, "pixelsize_y": 0.5, "upper_bound_x": 94597.5, "upper_bound_y": 434797.0 }, { "url": "https://demo.lizard.net/api/v4/scenarios/db7cd681-24fd-4a8c-a98e-0bf6eb5bed7b/?format=api", "uuid": "db7cd681-24fd-4a8c-a98e-0bf6eb5bed7b", "name": "T3D-live-demo-rotterdam-origineel #1_2024-06-10T115929", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/42eec8b6-604c-49c5-9b9e-9fe821510314/?format=api", "uuid": "42eec8b6-604c-49c5-9b9e-9fe821510314", "name": "Virtual City Systems" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2024-06-10T11:42:41.320931Z", "last_modified": "2024-06-24T09:19:56.086559Z", "simulation_identifier": "196644", "simulation_start": "2024-06-10T09:59:29Z", "simulation_end": "2124-05-17T09:59:29Z", "supplier": null, "source": "3Di", "model_identifier": "64929", "model_revision": "44724", "model_name": "t3d-live-demo-rotterdam-origineel-1", "has_raw_results": true, "total_size": 132918296, "spatial_bounds": { "west": 4.454747612294874, "east": 4.4669925418717495, "north": 51.92841295323644, "south": 51.90829060661301 }, "projection": "EPSG:28992", "origin_x": 90865.3, "origin_y": 435943.50000000006, "pixelsize_x": 0.1, "pixelsize_y": 0.1, "upper_bound_x": 91679.40000000001, "upper_bound_y": 438172.10000000003 }, { "url": "https://demo.lizard.net/api/v4/scenarios/78d58488-6b84-496b-aee0-f302c21cd95b/?format=api", "uuid": "78d58488-6b84-496b-aee0-f302c21cd95b", "name": "Mats Pullen 2 15-3-24", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/2bf14037-3e6a-413b-8407-0d40347080b0/?format=api", "uuid": "2bf14037-3e6a-413b-8407-0d40347080b0", "name": "Hogeschool Rotterdam" }, "project": null, "description": "", "extra_metadata": {}, "access_modifier": "Public", "created": "2024-03-15T11:51:59.688151Z", "last_modified": "2024-03-15T11:54:49.210427Z", "simulation_identifier": "180247", "simulation_start": "2024-03-15T11:42:41Z", "simulation_end": "2124-02-20T11:42:41Z", "supplier": "hrstudent1", "source": "3Di", "model_identifier": "62441", "model_revision": "26246", "model_name": "schouwen-duiveland-2d-hr-schouwenduiveland_schouwenduiveland-1-0", "has_raw_results": true, "total_size": 541190888, "spatial_bounds": { "west": 3.655264525622011, "east": 4.120402343289105, "north": 51.765518958027435, "south": 51.59707727595284 }, "projection": "EPSG:28992", "origin_x": 35435.0, "origin_y": 402325.0, "pixelsize_x": 5.0, "pixelsize_y": 5.0, "upper_bound_x": 67240.0, "upper_bound_y": 420415.0 } ] }