Productions

A production holds all metadata for a show: title, description, credits, duration, and links to venues, companies, and mediafiles.

Search productions

POST /entities/filter
Content-Type: application/json

The request body is a JSON array of filter objects. Filters are combined with AND.

All productions

[
  { "type": "type", "value": "production" }
]

Text search on title

Supports * as a wildcard.

[
  { "type": "type", "value": "production" },
  { "type": "text", "key": ["podiumnet:1|properties.title.value"], "value": "Hamlet*" }
]

Filter by venue

[
  { "type": "type", "value": "production" },
  { "type": "selection", "key": ["podiumnet:1|properties.ref_venues.value"], "value": "{venue_id}", "match_exact": true }
]

Combine title + venue

[
  { "type": "type", "value": "production" },
  { "type": "text", "key": ["podiumnet:1|properties.title.value"], "value": "Hamlet*" },
  { "type": "selection", "key": ["podiumnet:1|properties.ref_venues.value"], "value": "{venue_id}", "match_exact": true }
]

Pagination

POST __API_BASE_URL__/entities/filter?skip=0&limit=20

Response format

{
  "count": 42,
  "results": [
    { "id": "PR-ABC123", "type": "production", "metadata": [...], "relations": [...] }
  ],
  "skip": 0,
  "limit": 20
}

The next field only appears when more pages exist.

---

Get a single production

GET /entities/{id}

{id} can be the human-readable ID (e.g. PR-ABC123) or the UUID.

---

Response structure

{
  "id": "PR-ABC123",
  "_id": "43e99478-04db-42df-8d0e-11be73252344",
  "type": "production",
  "metadata": [
    { "key": "title", "value": "Hamlet" },
    { "key": "subtitle", "value": "A classic retold" },
    { "key": "description", "value": "<p>Full description...</p>" },
    { "key": "description_short", "value": "<p>Short description...</p>" },
    { "key": "credits", "value": "<p><strong>direction</strong> Jan Janssen</p>" },
    { "key": "status", "value": "published" },
    { "key": "duration", "value": 90 },
    { "key": "premiere_date", "value": "2026-09-01" },
    { "key": "age_category", "value": "12+" },
    { "key": "posters_status", "value": "complete" },
    { "key": "scene_images_status", "value": "partially" },
    { "key": "trailer_status", "value": "status_to_be_determined" }
  ],
  "relations": [
    { "key": "VE-XYZ789", "type": "refVenues" },
    { "key": "CO-DEF456", "type": "refCompanies" },
    { "key": "BA-GHI012", "type": "refBookingAgency" }
  ],
  "identifiers": ["43e99478-04db-42df-8d0e-11be73252344", "PR-ABC123"],
  "audit": {
    "created": { "at": "2026-05-20T16:35:24Z", "by": "user@example.com" },
    "updated": { "at": "2026-05-21T09:40:32Z", "by": "user@example.com" }
  }
}

---

Metadata fields

key	Type	Description
title	string	Title
subtitle	string	Subtitle
description	string (HTML)	Full description
description_short	string (HTML)	Short description (max. 500 chars)
credits	string (HTML)	Credits
status	enum	concept / published / archived
duration	number	Duration in minutes
premiere_date	ISO date	Premiere date
age_category	enum	Age category (e.g. 12+)
language_icon	string	Path to language icon

HTML fields

The fields description, description_short, and credits contain HTML. Strip the tags or render them directly.

---

Media availability status fields

Each media category has a status field in metadata.

key	Category
posters_status	Poster (Affiche)
scene_images_status	Scene images (Scenebeelden)
trailer_status	Trailer
review_status	Reviews (Recensies)
rider_status	Technical info (Technische info)
framing_status	Framing (Omkadering)
music_fragments_status	Music fragments (Muziekfragmenten)
social_media_status	Social media posts

Possible values:

Value	Meaning
status_to_be_determined	Not yet determined
not_applicable	Not applicable
follows_later	Will follow later
partially	Partially available
complete	Fully available

---

Relation fields

type	Description
refVenues	Linked venue(s)
refCompanies	Linked company/companies
refBookingAgency	Booking agency
refGenres	Genre(s)
refSeasons	Season(s)

The key in a relation object is the ID of the related entity (e.g. VE-XYZ789). Use GET /entities/{key} to retrieve its full details.