API Overview

The Podiumnet API is a REST API for retrieving production metadata and mediafiles. It is built on the Elody platform.

Base URL

Base URL	…

Protocol

• HTTPS
• JSON request and response bodies
• UTF-8 encoding

Required headers

Every request requires:

Header	Value
Authorization	Bearer {token}
X-tenant-id	podiumnet

See Authentication for how to obtain a token.

Pagination

List endpoints support pagination via query parameters:

Parameter	Default	Description
skip	0	Number of results to skip
limit	20	Number of results per page

Example:

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

Response envelope:

{
  "count": 42,
  "results": [ ... ],
  "skip": 20,
  "limit": 20,
  "next": "/..."
}

Field	Description
count	Total number of matching results
results	Array of objects for this page
skip	Applied skip value
limit	Applied limit value
next	Present only when more pages exist

Entity structure

Entities (productions, mediafiles) use a consistent format:

{
  "id": "PR-ABC123",
  "_id": "uuid",
  "type": "production",
  "metadata": [
    { "key": "title", "value": "Show title" }
  ],
  "relations": [
    { "key": "VE-XYZ789", "type": "refVenues" }
  ],
  "identifiers": ["uuid", "PR-ABC123"],
  "audit": {
    "created": { "at": "2026-01-01T00:00:00Z", "by": "user@example.com" },
    "updated": { "at": "2026-01-02T00:00:00Z", "by": "user@example.com" }
  }
}

• metadata: array of { key, value } pairs holding content fields
• relations: links to other entities (venues, companies, ...)
• id: human-readable ID (e.g. PR-ABC123)
• _id: internal UUID