Annunciator content API
This API provides data from the UK Parliament's annunciator system, the information screens displayed in and around the Houses of Parliament that show details of current business, including which member is speaking and the item under debate. Published by UK Parliament, the API offers free, unauthenticated access to this live feed, allowing developers to build tools or displays that reflect the real-time status of proceedings in the chambers and committee rooms at Westminster.Get data from the annunciator system.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (41 fields)
| Field | Type | Description |
|---|---|---|
| annunciator | string | Identifier of the annunciator screen or system showing the message.Current message by annunciator |
| date | string (date-time) | Returns the first message published after this date and time.First message after date time specified |
| membershipFromHouseMembershipViewModel | string | Start date of the member's house membership period.Start date of the member's house membership period. |
| displayOrderLineViewModel | integer (int32) | Position of this line within the displayed content.Position of this line within the displayed content. |
| contentTypeLineViewModel | object | Type of content shown on this line.Type of content shown on this line. |
| contentUrlLineViewModel | string | URL pointing to the content displayed on this line.URL pointing to the content displayed on this line. |
| contentAdditionalJsonLineViewModel | string | Additional content data encoded as JSON.Additional content data encoded as JSON. |
| styleLineViewModel | object | Visual style applied to this line's content.Visual style applied to this line's content. |
| horizontalAlignmentLineViewModel | object | Horizontal alignment of the line's content.Horizontal alignment of the line's content. |
| verticalAlignmentLineViewModel | object | Vertical alignment of the line's content.Vertical alignment of the line's content. |
| contentLineViewModel | string | Text content shown on this line.Text content shown on this line. |
| memberLineViewModel | object | Member of Parliament associated with this line.Member of Parliament associated with this line. |
| forceCapitalisationLineViewModel | boolean | Whether the content is forced to display in capital letters.Whether the content is forced to display in capital letters. |
| idMemberViewModel | integer (int32) | Unique identifier of the member.Unique identifier of the member. |
| nameDisplayAsMemberViewModel | string | Member's name formatted for general display.Member's name formatted for general display. |
| nameListAsMemberViewModel | string | Member's name formatted for listing purposes.Member's name formatted for listing purposes. |
| nameFullTitleMemberViewModel | string | Member's full formal title and name.Member's full formal title and name. |
| nameAddressAsMemberViewModel | string | Name form used to address the member directly.Name form used to address the member directly. |
| thumbnailUrlMemberViewModel | string | URL of the member's thumbnail image.URL of the member's thumbnail image. |
| latestPartyMemberViewModel | object | Political party the member most recently belonged to.Political party the member most recently belonged to. |
| latestHouseMembershipMemberViewModel | object | Member's most recent house membership details.Member's most recent house membership details. |
| annunciatorDisabledMessageViewModel | boolean | Whether the annunciator display is currently disabled.Whether the annunciator display is currently disabled. |
| slidesMessageViewModel | array<object> | List of slides making up the annunciator message.List of slides making up the annunciator message. |
| scrollingMessagesMessageViewModel | array<object> | List of scrolling ticker messages shown on the annunciator.List of scrolling ticker messages shown on the annunciator. |
| annunciatorTypeMessageViewModel | object | Type of annunciator this message relates to.Type of annunciator this message relates to. |
| publishTimeMessageViewModel | string (date-time) | Date and time the message was published.Date and time the message was published. |
| isSecurityOverrideMessageViewModel | boolean | Whether the message is a security override alert.Whether the message is a security override alert. |
| showCommonsBellMessageViewModel | boolean | Whether the House of Commons division bell icon is shown.Whether the House of Commons division bell icon is shown. |
| showLordsBellMessageViewModel | boolean | Whether the House of Lords division bell icon is shown.Whether the House of Lords division bell icon is shown. |
| namePartyViewModel | string | Name of the political party.Name of the political party. |
| backgroundColourPartyViewModel | string | Background colour associated with the political party.Background colour associated with the political party. |
| displayFromScrollingMessageViewModel | string (date-time) | Date and time from which the scrolling message is shown.Date and time from which the scrolling message is shown. |
| displayToScrollingMessageViewModel | string (date-time) | Date and time until which the scrolling message is shown.Date and time until which the scrolling message is shown. |
| alertTypeScrollingMessageViewModel | object | Type of alert represented by the scrolling message.Type of alert represented by the scrolling message. |
| linesSlideViewModel | array<object> | List of lines of content making up the slide.List of lines of content making up the slide. |
| typeSlideViewModel | object | Type of the slide.Type of the slide. |
| carouselOrderSlideViewModel | integer (int32) | Position of the slide within a rotating carousel.Position of the slide within a rotating carousel. |
| carouselDisplaySecondsSlideViewModel | integer (int32) | Number of seconds the slide is displayed in the carousel.Number of seconds the slide is displayed in the carousel. |
| speakerTimeSlideViewModel | string (date-time) | Time associated with the speaker for this slide.Time associated with the speaker for this slide. |
| slideTimeSlideViewModel | string (date-time) | Timestamp associated with this slide.Timestamp associated with this slide. |
| soundToPlaySlideViewModel | object | Sound to be played alongside this slide.Sound to be played alongside this slide. |
Schema captured from openapi 23 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://now-api.parliament.uk
- Version
- v1
- Format
- openapi
- Endpoints
- 2
Try the API
/api/Message/message/{annunciator}/currentReturn the current message by annunciator type
/api/Message/message/{annunciator}/{date}Return the most recent message by annunciator after date time specified
Requests are proxied through our servers. Only GET endpoints are testable.
Endpoints (2)
/api2 endpoints
/api/Message/message/{annunciator}/currentReturn the current message by annunciator type
/api/Message/message/{annunciator}/{date}Return the most recent message by annunciator after date time specified
Query examples
curl -s 'https://now-api.parliament.uk/swagger/v1/swagger.json' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.