Example use case

A user of your application wants to listen to public value services from a specific district.

First, your application can request from the API which districts to choose from. The endpoint /districts is intended for this.

For example, the user might see:

Example of displaying the list of districts in an application

The user now has the option of selecting a district. Your application can then query the list of matching services using the /services?district={DESIRED_DISTRICT} endpoint.

For example, the list of services in your application could look like this:

Example for the list of services of a district

Services by postcode or coordinates

Services can also be requested based on postcode or coordinates. See endpoints.