Playout API

Get character details.

Media Jay Playout API (2025-08-04)

The playout API of the Media Jay application provides access to the playout data and orchestrates extended queries.

Authentication

To access the endpoints you require a X-API-Key in the header. Partners, please contact Transfermedia support@transfermedia.de to retrieve one.

Versioning

To use a specific implementation version of this API place it to the request header X-API-Version. If the header is missed the latest implementation version 2025-08-04 is used. The response header X-API-Version returns the implementation version the request was processed with.

Further documentation

For further details please visit the documentation or contact Transfermedia support@transfermedia.de.

Download OpenAPI description

openapi.json

openapi.yaml

Servers

Development Server

https://docs.jay-metadata.com/_mock/apis/playout/latest/openapi/

Session Tracking

APIs for managing user tracking sessions. These endpoints allow clients to create, retrieve, and delete tracking sessions which are used for analytics and user behavior tracking.

Operations

Formats

Access to formats metadata (aka movie collections or series).

Operations

Episodes

Access to episode metadata and general information.

Operations

Episode items

Information about episode items.

Operations

List all characters in the episode

Request

Path

playoutIdstring(playout identifier)required

The playout identifier (aka tenant identifier) addressing the correct content of the streaming platform.

episodeIdstring(episode identifier)required

The episode identifier.

Query

inlineLevelinteger(inline level)[ 0 .. 4 ]

The number of levels to expand inner object inline. The lower this number the faster the response.

Default 0

Example: inlineLevel=1

Headers

X-API-Keystring(X-Api-Key)required

Required. API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

__Secure-jay_trackingstring( Secure-Jay Tracking)

Tracking session header for user tracking and analytics. This is set by the /playouts/tracking/session endpoint.

Example: __Secure-jay_tracking=eyJzZX...

curl -i -X GET \
  'https://docs.jay-metadata.com/_mock/apis/playout/latest/openapi/playouts/{playoutId}/episodes/{episodeId}/characters?inlineLevel=1' \
  -H 'X-API-Key: string' \
  -H '__Secure-jay_tracking: __Secure-jay_tracking=eyJzZX...'

Responses

Successfully retrieved list of characters

Bodyapplication/json

dataArray of objects(The response data)

The response data.

Example: [{"id":"string","kind":"<<enum 'PlayoutKindType'>>","role":"string","name":"string","gender":"string","salutationTitle":"string","givenName":"string","linkingName":"string","familyName":"string","age":0,"yearOfBirth":"string","placeOfBirth":"string","countryOfBirth":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"locationIds":["item"],"locations":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","name":"string","title":"string","subtitle":"string","description":"string","street":"string","addition":"string","postcode":"string","city":"string","country":"string","longitude":"string","latitude":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}]}],"costumeIds":["item"],"costumes":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","type":"string","name":"string","brand":"string","subtitle":"string","description":"string","gender":"string","category":"string","fit":"string","material":"string","color":"string","colorCode":"string","country":"string","images":[{"url":"string","copyright":"string"}],"imagesLogo":"string","imagesLogoCopyright":"string","links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","variantsCompact":"string","variants":[{"title":"string","content":"string","sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","cartUrl":"string","basketProductId":"string"}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"linkedToProductIds":["item"],"linkedToProducts":["item"],"basketProductId":"string"}],"productIds":["item"],"products":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","type":"string","name":"string","brand":"string","subtitle":"string","description":"string","gender":"string","category":"string","fit":"string","material":"string","color":"string","colorCode":"string","country":"string","images":[{"url":"string","copyright":"string"}],"imagesLogo":"string","imagesLogoCopyright":"string","links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","variantsCompact":"string","variants":[{"title":"string","content":"string","sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","cartUrl":"string","basketProductId":"string"}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"linkedToProductIds":["item"],"linkedToProducts":["item"],"basketProductId":"string"}],"propIds":["item"],"props":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","type":"string","name":"string","brand":"string","subtitle":"string","description":"string","gender":"string","category":"string","fit":"string","material":"string","color":"string","colorCode":"string","country":"string","images":[{"url":"string","copyright":"string"}],"imagesLogo":"string","imagesLogoCopyright":"string","links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","variantsCompact":"string","variants":[{"title":"string","content":"string","sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","cartUrl":"string","basketProductId":"string"}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"linkedToProductIds":["item"],"linkedToProducts":["item"],"basketProductId":"string"}]}]

errorobject(The error response)

Represents a data response with a possible error.

Response

application/json

{
  "data": [
    { … }
  ]
}

Get character details.

Request

Path

playoutIdstring(playout identifier)required

The playout identifier (aka tenant identifier) addressing the correct content of the streaming platform.

episodeIdstring(episode identifier)required

The episode identifier.

characterIdstring(identifier)required

The identifier of the character

Query

inlineLevelinteger(inline level)[ 0 .. 4 ]

The number of levels to expand inner object inline. The lower this number the faster the response.

Default 0

Example: inlineLevel=1

Headers

X-API-Keystring(X-Api-Key)required

Required. API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

__Secure-jay_trackingstring( Secure-Jay Tracking)

Tracking session header for user tracking and analytics. This is set by the /playouts/tracking/session endpoint.

Example: __Secure-jay_tracking=eyJzZX...

curl -i -X GET \
  'https://docs.jay-metadata.com/_mock/apis/playout/latest/openapi/playouts/{playoutId}/episodes/{episodeId}/characters/{characterId}?inlineLevel=1' \
  -H 'X-API-Key: string' \
  -H '__Secure-jay_tracking: __Secure-jay_tracking=eyJzZX...'

Responses

Successfully retrieved character details

Bodyapplication/json

dataobject(The response data)

Represents an actor (person or character)

Example: {"id":"string","kind":"<<enum 'PlayoutKindType'>>","role":"string","name":"string","gender":"string","salutationTitle":"string","givenName":"string","linkingName":"string","familyName":"string","age":0,"yearOfBirth":"string","placeOfBirth":"string","countryOfBirth":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"locationIds":["item"],"locations":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","name":"string","title":"string","subtitle":"string","description":"string","street":"string","addition":"string","postcode":"string","city":"string","country":"string","longitude":"string","latitude":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}]}],"costumeIds":["item"],"costumes":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","type":"string","name":"string","brand":"string","subtitle":"string","description":"string","gender":"string","category":"string","fit":"string","material":"string","color":"string","colorCode":"string","country":"string","images":[{"url":"string","copyright":"string"}],"imagesLogo":"string","imagesLogoCopyright":"string","links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","variantsCompact":"string","variants":[{"title":"string","content":"string","sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","cartUrl":"string","basketProductId":"string"}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"linkedToProductIds":["item"],"linkedToProducts":["item"],"basketProductId":"string"}],"productIds":["item"],"products":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","type":"string","name":"string","brand":"string","subtitle":"string","description":"string","gender":"string","category":"string","fit":"string","material":"string","color":"string","colorCode":"string","country":"string","images":[{"url":"string","copyright":"string"}],"imagesLogo":"string","imagesLogoCopyright":"string","links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","variantsCompact":"string","variants":[{"title":"string","content":"string","sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","cartUrl":"string","basketProductId":"string"}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"linkedToProductIds":["item"],"linkedToProducts":["item"],"basketProductId":"string"}],"propIds":["item"],"props":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","type":"string","name":"string","brand":"string","subtitle":"string","description":"string","gender":"string","category":"string","fit":"string","material":"string","color":"string","colorCode":"string","country":"string","images":[{"url":"string","copyright":"string"}],"imagesLogo":"string","imagesLogoCopyright":"string","links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","variantsCompact":"string","variants":[{"title":"string","content":"string","sku":"string","price":"string","priceFloat":0,"originalPrice":"string","currency":"string","cartUrl":"string","basketProductId":"string"}],"groupIds":["item"],"groups":[{"id":"string","kind":"<<enum 'PlayoutKindType'>>","mainMenu":true,"name":"string","subtitle":"string","description":"string","images":[{"url":"string","copyright":"string"}],"links":[{"url":"string","urlLabel":"string","urlNote":"string","urlImage":{"url":"string","copyright":"string"}}],"layout":"string","groupIds":["item"],"groups":["item"],"characterIds":["item"],"characters":["item"],"actorIds":["item"],"actors":["item"],"locationIds":["item"],"locations":["item"],"costumeIds":["item"],"costumes":["item"],"productIds":["item"],"products":["item"],"propIds":["item"],"props":["item"],"ticketIds":["item"],"tickets":["item"],"themeIds":["item"],"themes":["item"],"basicIds":["item"],"basics":["item"],"musicIds":["item"],"musics":["item"]}],"linkedToProductIds":["item"],"linkedToProducts":["item"],"basketProductId":"string"}]}

errorobject(The error response)

Represents a data response with a possible error.

Response

application/json

{
  "data": {
    "id": "string",
    "kind": "<<enum 'PlayoutKindType'>>",
    "role": "string",
    "name": "string",
    "gender": "string",
    "salutationTitle": "string",
    "givenName": "string",
    "linkingName": "string",
    "familyName": "string",
    "age": 0,
    "yearOfBirth": "string",
    "placeOfBirth": "string",
    "countryOfBirth": "string",
    "description": "string",
    "images": [ … ],
    "links": [ … ],
    "groupIds": [ … ],
    "groups": [ … ],
    "locationIds": [ … ],
    "locations": [ … ],
    "costumeIds": [ … ],
    "costumes": [ … ],
    "productIds": [ … ],
    "products": [ … ],
    "propIds": [ … ],
    "props": [ … ]
  }
}

List all actors in the episode

Request

Path

playoutIdstring(playout identifier)required

The playout identifier (aka tenant identifier) addressing the correct content of the streaming platform.

episodeIdstring(episode identifier)required

The episode identifier.

Query

inlineLevelinteger(inline level)[ 0 .. 4 ]

The number of levels to expand inner object inline. The lower this number the faster the response.

Default 0

Example: inlineLevel=1

Headers

X-API-Keystring(X-Api-Key)required

Required. API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

__Secure-jay_trackingstring( Secure-Jay Tracking)

Tracking session header for user tracking and analytics. This is set by the /playouts/tracking/session endpoint.

Example: __Secure-jay_tracking=eyJzZX...

curl -i -X GET \
  'https://docs.jay-metadata.com/_mock/apis/playout/latest/openapi/playouts/{playoutId}/episodes/{episodeId}/actors?inlineLevel=1' \
  -H 'X-API-Key: string' \
  -H '__Secure-jay_tracking: __Secure-jay_tracking=eyJzZX...'

Responses

Successfully retrieved list of actors

Bodyapplication/json

dataArray of objects(The response data)

The response data.

errorobject(The error response)

Represents a data response with a possible error.

Response

application/json

{
  "data": [
    { … }
  ]
}

Episode timeline

Information about timeline events with complete timing information.

Operations

Episode groups

Information about existing groups.

Operations

Episode scenes

Information about the scenes.

Operations

Episode companies involved

Information about the involved companies.

Operations

API information

Operations

Media Jay Playout API (2025-08-04)

Authentication

Versioning

Further documentation

Session Tracking

Formats

Episodes

Episode items

List all characters in the episode

Request

Responses

Was this helpful?

Get character details.

Request

Responses

Was this helpful?

List all actors in the episode

Request

Responses

Was this helpful?

Episode timeline

Episode groups

Episode scenes

Episode companies involved

API information