This endpoint returns the production's show types, with the custom values you fill in for each one under Show type metadata. It reads them live, so you don't need to publish first, and it leaves out archived types unless you ask for them.

Request

GET /api/v1/<production>/show-types

Parameter Type Description
archived boolean Pass true to include archived show types. 
curl https://confirmed.show/api/v1/spectrum/show-types \
  -H "Authorization: Bearer <token>"

Response

An array of show types, sorted by name.

[
  {
    "id": "friday-showcase",
    "name": "Friday Showcase",
    "emoji": "🎤",
    "description": "Four acts and a host, every Friday in the Main Room.",
    "duration": 120,
    "archived": false,
    "meta": {
      "promoVideo": "https://youtube.com/watch?v=...",
      "bannerImage": "https://.../banner.jpg"
    }
  }
]

Show type fields

Field Type Description
id string Show type id, which you can pass as type on the Shows API
name string The show type's name
emoji string Its emoji, when it has one
description string The show type's description
duration integer Run time in minutes
archived boolean true when the show type is archived
meta object Your custom field values, keyed by field name. Empty when you haven't filled any in. Meta fields lists the fields under show_type_fields.

Any field without a value comes back as null.

Errors

Status What happened
400 The request carried no API token.
401 We don't recognise that token.