1. Get the displays on a date
GET /api/museums/northlight/displays?date=2026-10-27&lang=en
The start screen, works list, label number search, floor plan, the works list from a visit and the date preview all need the displays on one date, today or in the past, in the same shape. Label number search should work offline, so the whole list is needed at once.
Display versions are never changed once published, so the display arrangement on a date is fixed. Image state depends on the time of the request. A museum has a few dozen works on display, so one response stays small.
One endpoint with a date. date selects the display arrangement; image state is decided at the time of the request. The response can be cached, but never beyond the earliest shownUntil in it.
Response format
{
"date": "2026-10-27",
"floors": [{ "level": 2, "name": "Second floor", "short": "2" }],
"displays": [
{
"type": "exhibition",
"id": "under-changing-skies",
"title": { "text": "Under Changing Skies", "lang": "en" },
"from": "2026-09-12",
"to": "2027-01-10",
"rooms": [
{
"room": 1, "section": "dawn", "sectionName": "Dawn", "level": 2,
"works": [
{
"workId": "w_monet_1897",
"labelNumber": "105",
"title": { "text": "Morning on the Seine near Giverny", "lang": "en" },
"artist": "Claude Monet",
"image": { "state": "shown", "thumbnail": "https://…", "shownUntil": "2027-01-10T23:00:00Z" }
}
]
}
]
},
{ "type": "collection", "id": "prints-and-drawings", "rooms": [] }
]
}After loading today's displays, the guide fetches the detail (2) and the reduced image of each work in the background. Offline use covers what has finished loading. Audio is not fetched in advance, and neither are the displays of past visits.
image.state is shown or not_shown. When not shown, reason is copyright, loan_period_ended or artist_wish, and the screen chooses the wording from it.
Label number search runs on this response on the device, so it works offline and needs no endpoint of its own.
A display version records the arrangement of an exhibition or collection display for a defined period: its works, room assignments, label numbers and order.
In each room entry, room is the physical room number, section is the thematic section identifier, sectionName is its display name, and level is the floor level. The name field on a floor entry remains the floor name.




