Workspace event info - Broadcast Docs

Overview

Use this endpoint to read upcoming events across the projects in a workspace.

Endpoint: GET https://api.broadcast.events/workspace/events
Auth: Authorization: Bearer <api-key>

The feed returns upcoming events for the workspace behind the API key. By default, it merges events across venue, promoter, and festival projects. Keys configured for the promoter project feed return events linked to allowed promoter projects. Both feeds dedupe events by event id and sort results by start time. For a history of API and documentation changes, see the API changelog.

Approach

This endpoint is designed for authenticated workspace integrations that need more context than the public feed. The workspace route uses the API key itself as the boundary:

The key decides which workspace is queried.
The key can optionally restrict results to a subset of allowed projects.
Your key determines whether you receive the workspace feed or a promoter project feed.
The response includes the public event fields plus workspace-specific fields such as publishing metadata, richer ticketing details, related events, and JSON-LD.

The response meta.projects lists the distinct workspace projects represented in the returned page of results. Source of truth: Event details can change after you fetch them. We recommend linking end users to the canonical Broadcast event using links.self, and to venue pages or profile links when relevant.

Caching

Responses may be cached for about 15 seconds. Changes to events or project membership may take a short time to appear in your feed.

Access and authentication

This API is currently available on request. Contact support@broadcast.events to enable access for your workspace.

Send your workspace API key as a bearer token:

Raw HTTP

Authorization: Bearer YOUR_API_KEY

The key must include the workspace.events.read scope.

Query parameters

Name	Type	Required	Description
`limit`	Number	No	Number of events to return. Default is `50`. Maximum is `100`.
`disableUtmLinks`	Boolean	No	Set to `true` to return raw outbound links without Broadcast UTM parameters.

Notes:

Ticketmaster affiliate wrapping is disabled for this route.
UTM parameters are enabled by default unless you pass disableUtmLinks=true.
For the default workspace feed, invalid or non-positive limit values fall back to 50.
For the promoter project feed, limit must be a positive whole number. An empty or invalid value returns 400; values above 100 are capped at 100. Unsupported or duplicate query parameters also return 400.

Promoter project feed

The promoter project feed returns published upcoming and ongoing events from the promoter projects your key can access. Drafts, past events, and templates are excluded. Ask your workspace administrator to select Promoter projects as the key’s Workspace event feed and choose the projects you need. Use the same endpoint, request parameters, and response format shown below. You do not need any additional query parameters. If your key covers multiple promoter projects, their events are combined without duplicates. meta.projects lists the promoter projects represented in the response. If there are no matching events, data is an empty list.

Example request

curl --request GET \
  --url "https://api.broadcast.events/workspace/events?limit=25&disableUtmLinks=true" \
  --header "Authorization: Bearer YOUR_API_KEY"

GET /workspace/events?limit=25&disableUtmLinks=true HTTP/1.1
Host: api.broadcast.events
Authorization: Bearer YOUR_API_KEY

Example response

Use the copy control on the code block to grab the full JSON.

Example response

{
    "data": [
        {
            "id": "evt_123",
            "type": "event",
            "title": "Broadcast Showcase",
            "descriptionMD": "Long-form event description in markdown or HTML-friendly text.",
            "subtitle": "Live in Oslo",
            "summary": "An evening of live music and DJs.",
            "status": "scheduled",
            "timing": {
                "doors": "2026-05-10T18:00:00.000Z",
                "close": "2026-05-10T22:30:00.000Z",
                "timezone": "Europe/Oslo",
                "startTime": "2026-05-10T19:00:00.000Z"
            },
            "classification": {
                "tags": ["live", "indie"],
                "categories": ["concert"],
                "ageRestrictionText": "18+",
                "noAgeLimit": false
            },
            "attendance": {
                "isFree": false,
                "soldOut": false,
                "price": {
                    "text": "NOK 250"
                },
                "ticketing": "https://tickets.example.com/event-123",
                "commonTicketUrl": "https://tickets.example.com/common",
                "additionalPriceInfo": "Doors + service fee may apply",
                "callToAction": {
                    "label": "Book table",
                    "url": "https://tables.example.com/event-123"
                }
            },
            "location": {
                "type": "venue",
                "venue": {
                    "id": "venue_123",
                    "type": "venue",
                    "name": "John Dee",
                    "address": {
                        "city": "Oslo",
                        "country": "NO"
                    },
                    "links": {
                        "self": "https://www.broadcast.events/v/venue_123",
                        "entity": "https://www.broadcast.events/v/venue_123",
                        "profile": "https://www.broadcast.events/@john-dee"
                    },
                    "profile": {
                        "handle": "@john-dee",
                        "canonicalUrl": "https://www.broadcast.events/@john-dee"
                    }
                }
            },
            "media": {
                "image": {
                    "url": "https://img.broadcastapp.no/example/tr:w-375",
                    "variants": {
                        "micro": "https://img.broadcastapp.no/example/tr:w-100",
                        "small": "https://img.broadcastapp.no/example/tr:w-178",
                        "medium": "https://img.broadcastapp.no/example/tr:w-375",
                        "large": "https://img.broadcastapp.no/example/tr:w-750"
                    }
                },
                "youtube": "https://youtube.com/watch?v=abc123",
                "embeds": [
                    {
                        "type": "spotify",
                        "name": "Playlist",
                        "id": "playlist_1"
                    }
                ]
            },
            "links": {
                "self": "https://www.broadcast.events/events/broadcast-showcase/evt_123",
                "moreInfo": "https://venue.example.com/more-info"
            },
            "meta": {
                "publishedAt": "2026-05-01T09:00:00.000Z",
                "importId": "import-123",
                "importIntegrationId": "integration-123"
            },
            "relatedEvents": [
                {
                    "objectId": "evt_related_456"
                }
            ],
            "source": {
                "provider": "internal"
            },
            "createdAt": "2026-04-01T12:00:00.000Z",
            "updatedAt": "2026-04-05T09:30:00.000Z",
            "structuredData": {
                "jsonLd": "{\"@context\":\"https://schema.org\",\"@type\":\"MusicEvent\"}"
            }
        }
    ],
    "meta": {
        "projects": [
            {
                "id": "project_venue_123",
                "name": "John Dee"
            },
            {
                "id": "project_promoter_456",
                "name": "All Things Live"
            }
        ],
        "count": 1,
        "itemCount": 1,
        "generatedAt": "2026-05-04T10:00:00.000Z",
        "limit": 25
    }
}

Response fields

Empty values are omitted from the response, so some optional fields may be missing.

At a glance

Field	Type	Description
`data`	Array	List of matching workspace events
`meta`	Object	Metadata about the response

Response `meta`

Field	Type	Description
`projects`	Array of objects	Workspace projects represented in the returned events
`count`	Number	Number of events returned in this response
`itemCount`	Number	Same as `count`. Included for consistency with other APIs
`generatedAt`	String	ISO timestamp for when the response payload was generated
`limit`	Number	Effective limit used for the request

`meta.projects[]`

Field	Type	Description
`id`	String	Workspace project id
`name`	String	Current project name for that workspace project

Event object

The workspace event object starts with the public event shape and adds a few workspace-specific fields.

`timing`

Field	Type	Description
`doors`	String	Main event datetime in ISO format
`close`	String	End time in ISO format when available
`timezone`	String	Time zone for the event. Currently Europe/Oslo
`startTime`	String	Show start time in ISO format when available

`classification`

`attendance`

`attendance.price`

Field	Type	Description
`text`	String	Human-readable price label such as NOK 250 or Free Entry

`attendance.callToAction`

Field	Type	Description
`label`	String	CTA label such as Book table or Reserve
`url`	String	CTA destination URL

`location`

Field	Type	Description
`type`	String	One of venue, online, hybrid, or tba
`venue`	Object	Venue details when the event is tied to a venue

`location.venue`

`location.venue.address`

Field	Type	Description
`street`	String	Street address
`city`	String	City name
`postalCode`	String	Postal or ZIP code
`country`	String	Two-letter country code such as NO

`location.venue.geo`

Field	Type	Description
`latitude`	Number	Venue latitude
`longitude`	Number	Venue longitude

`location.venue.links`

`location.venue.profile`

Field	Type	Description
`handle`	String	Profile handle such as @john-dee
`canonicalUrl`	String	Canonical public profile URL

`media`

Image asset

Field	Type	Description
`alt`	String	Alt text when available
`url`	String	Default image URL
`variants`	Object	Responsive image URLs in multiple sizes

`image.variants`

Field	Type	Description
`micro`	String	Small preview variant
`small`	String	Small image variant
`medium`	String	Medium image variant
`large`	String	Large image variant

`media.embeds[]`

Field	Type	Description
`type`	String	Embed provider or type
`name`	String	Human-readable embed label
`id`	String	Embed identifier

`links`

Event `meta`

Field	Type	Description
`publishedAt`	String	ISO timestamp for when the event was published
`importId`	String or Number	Import id from an upstream integration
`importIntegrationId`	String	Integration instance id in Broadcast

`source`

Field	Type	Description
`provider`	String	Current source provider. At the moment this is internal

`relatedEvents`

Field	Type	Description
`relatedEvents`	Array	Related event references when available

`structuredData`

Field	Type	Description
`jsonLd`	String	Stringified JSON-LD for the event

Error responses

Status	Meaning
`400`	Invalid or unsupported query parameters
`401`	Missing, invalid, or expired API key
`403`	API key does not include the required scope
`429`	Too many requests
`500`	Internal server error

Notes

The workspace feed merges venue, promoter, and festival projects; the promoter project feed includes linked promoter events only.
Events are deduped by event id and sorted by start time before the final limit is applied.
meta.projects reflects the projects represented in the current returned slice, not every project in the workspace.
The route is workspace-scoped and intended for richer internal integrations than the public feed.

​Overview

​Approach

​Caching

​Access and authentication

​Query parameters

​Promoter project feed

​Example request

​Example response

​Response fields

​At a glance

​Response meta

​meta.projects[]

​Event object

​timing

​classification

​attendance

​attendance.price

​attendance.callToAction

​location

​location.venue

​location.venue.address

​location.venue.geo

​location.venue.links

​location.venue.profile

​media

​Image asset

​image.variants

​media.embeds[]

​links

​Event meta

​source

​relatedEvents

​structuredData

​Error responses

​Notes

Overview

Approach

Caching

Access and authentication

Query parameters

Promoter project feed

Example request

Example response

Response fields

At a glance

Response `meta`

`meta.projects[]`

Event object

`timing`

`classification`

`attendance`

`attendance.price`

`attendance.callToAction`

`location`

`location.venue`

`location.venue.address`

`location.venue.geo`

`location.venue.links`

`location.venue.profile`

`media`

Image asset

`image.variants`

`media.embeds[]`

`links`

Event `meta`

`source`

`relatedEvents`

`structuredData`

Error responses

Notes