Skip to main content

26 August 2026

Resource items: locationId is replaced by a locations collection​

On GET /api/v1/resource-items and GET /api/v1/resource-items/{id}, the single locationId field is gone. A resource item now returns locations, a list of the locations it is available at, each with an id, a name and a link. This is a breaking change to the resource item response.

A resource can be shared across locations, which the single field could not express. Read resourceItem.locations and match on the entry you need instead of comparing locationId. The locationId filter on the list endpoint is unchanged and now matches an item at any of its locations.

Before:

"locationId": 3

After:

"locations": [
{
"id": 3,
"name": "Coburg",
"links": [{ "href": "/api/v1/locations/3", "rel": "self", "method": "GET" }]
},
{
"id": 7,
"name": "Fitzroy",
"links": [{ "href": "/api/v1/locations/7", "rel": "self", "method": "GET" }]
}
]