Skip to main content

Get meetings for a city

GET /api/cities/{cityId}/meetings?limit=10
Returns released meetings for a specific city, ordered by date (most recent first).

Path parameters

cityId
string
required
Unique city identifier

Query parameters

limit
integer
default:"unlimited"
Maximum number of meetings to return (1-100)

Response

Returns an array of Meeting objects.
id
string
Unique meeting identifier
name
string
Meeting name in local language
name_en
string
Meeting name in English
dateTime
string
Meeting date and time (ISO 8601 format)
youtubeUrl
string
YouTube video URL
videoUrl
string | null
Direct video URL (if available)
audioUrl
string | null
Audio file URL (if available)
muxPlaybackId
string | null
Mux playback ID for video streaming
released
boolean
Whether the meeting has been released publicly
cityId
string
Associated city identifier
administrativeBody
object | null
The administrative body that held the meeting
subjects
array
Array of subjects discussed in the meeting

Error responses

400
ValidationError
Invalid query parameters
500
Error
Failed to fetch meetings

Get transcript for a meeting

GET /api/cities/{cityId}/meetings/{meetingId}
Returns the full transcript for a specific meeting, including speaker segments with timestamps and speaker information.

Path parameters

cityId
string
required
Unique city identifier
meetingId
string
required
Unique meeting identifier

Response

Returns an array of SpeakerSegment objects ordered by timestamp.
id
string
Unique segment identifier
startTimestamp
number
Start time in seconds from meeting beginning
endTimestamp
number
End time in seconds from meeting beginning
meeting
object
Basic meeting information
person
object | null
Speaker information (null if speaker is unidentified)
text
string
Transcribed speech text
summary
object | null
AI-generated summary of the segment

Error responses

404
Error
Transcript not found
500
Error
Failed to fetch transcript

Build docs developers (and LLMs) love