Public event info - Broadcast Docs

Overview

Use this endpoint to read upcoming public events from Broadcast.

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

The feed returns published, non-cancelled upcoming events and sorts results by start time. For a history of API and documentation changes, see the API changelog.

Approach

We intentionally keep this endpoint simple: it is a heavily cached feed that returns a larger slice of events per request (see limit below) instead of offering rich querying and server-side filtering. That makes it a good fit for prototyping and experiments: pull a batch of data, then filter, sort, and search in your own code or database. Only light parameters (limit and optional region) are supported on the API. Source of truth: Event details can change after you fetch them. We recommend linking end users to the canonical event on Broadcast using links.self (and venue pages when relevant) so people always see the latest information.

Caching and plans

Responses are cached on our side to keep the feed fast and affordable.

Tier	Typical cache lifetime	Notes
Free	About 5 minutes	Best for experiments and low-frequency use
Paid	Much shorter	Fresher data for production-style use
Realtime	On request	Contact us; pricing is not fixed yet

Exact TTLs can depend on your agreement—email support@broadcast.events if you need a specific freshness target.

Access and pricing

This API is currently available on request. Contact support@broadcast.events to enable access for your workspace. We currently offer both free and paid options depending on your use case and volume.

Query parameters

Name	Type	Required	Description
`limit`	Number	No	Number of events to return. Default is `50`. Maximum is `250`.
`region`	String	No	Filter events by venue region. Example: `Oslo`.

Only limit and region are supported. Any other query parameter returns a 400 response.

Example request

curl --request GET \
  --url "https://api.broadcast.events/public/events?limit=25&region=Oslo" \
  --header "Authorization: Bearer YOUR_API_KEY"

GET /public/events?limit=25&region=Oslo 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",
            "subtitle": "Live in Oslo",
            "summary": "An evening of live music and DJs.",
            "status": "scheduled",
            "timing": {
                "doors": "2026-04-10T18:00:00.000Z",
                "close": "2026-04-10T22:30:00.000Z",
                "timezone": "Europe/Oslo",
                "startTime": "2026-04-10T19:00:00.000Z"
            },
            "classification": {
                "tags": ["live", "indie"],
                "categories": ["concert"],
                "ageRestrictionText": "18+"
            },
            "attendance": {
                "isFree": false,
                "soldOut": false,
                "price": {
                    "text": "NOK 250"
                }
            },
            "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"
                    }
                }
            },
            "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"
                    }
                }
            },
            "links": {
                "self": "https://www.broadcast.events/events/broadcast-showcase/evt_123"
            },
            "source": {
                "provider": "internal"
            },
            "createdAt": "2026-03-01T12:00:00.000Z",
            "updatedAt": "2026-03-05T09:30:00.000Z"
        }
    ],
    "meta": {
        "count": 1,
        "itemCount": 1,
        "generatedAt": "2026-03-20T10:00:00.000Z",
        "limit": 25,
        "region": "Oslo"
    }
}

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 public events
`meta`	Object	Metadata about the response

`meta`

Field	Type	Description
`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
`region`	String or `null`	Region filter applied to the request

Event object

`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

`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 and images

Field	Type	Description
`media.image`	Object	Event image asset
`location.venue.media.image`	Object	Venue image asset

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

Links and source

`source`

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

Error responses

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

​Overview

​Approach

​Caching and plans

​Access and pricing

​Query parameters

​Example request

​Example response

​Response fields

​At a glance

​meta

​Event object

​timing

​classification

​attendance

​attendance.price

​location

​location.venue

​location.venue.address

​location.venue.geo

​location.venue.links

​location.venue.profile

​Media and images

​Image asset

​image.variants

​Links and source

​source

​Error responses

Overview

Approach

Caching and plans

Access and pricing

Query parameters

Example request

Example response

Response fields

At a glance

`meta`

Event object

`timing`

`classification`

`attendance`

`attendance.price`

`location`

`location.venue`

`location.venue.address`

`location.venue.geo`

`location.venue.links`

`location.venue.profile`

Media and images

Image asset

`image.variants`

Links and source

`source`

Error responses