---
title: "Return a list of publications"
method: GET
path: "/api/Publications"
tags: ["Publications"]
---

# Return a list of publications

`GET /api/Publications`

## Query parameters

- `PublicationTypeIds` integer[]
- `SearchTerm` string
- `StartDate` string, date-time
- `EndDate` string, date-time
- `SortOrder` 'PublicationDateDescending' | 'PublicationDateAscending' | 'ResponseDateDescending' | 'ResponseDateAscending'
- `PaperNumbers` string[]
- `CommitteeBusinessId` integer
- `CommitteeId` integer
- `ShowOnWebsiteOnly` boolean
- `Skip` integer
- `Take` integer

## Response `200`

List of publications matching the specified search parameters

- CommitteesCommonResourceCollection1CommitteesCommonResponsesPublication
  - `items` CommitteesCommonResponsesPublication[], nullable
    - `description` string, nullable — Description of publication
    - `id` integer — The id of the publication
    - `publicationStartDate` string, date-time, nullable — Date when publication can be published from
    - `governmentResponses` CommitteesCommonResponsesCommonPublicationGovernmentResponse
      - `publication` CommitteesCommonResponsesCommonPublicationPublicationSummary[], nullable — Publication for government response
        - `description` string, nullable — Description of publication
        - `id` integer — The id of the publication
        - `publicationStartDate` string, date-time, nullable — Date when publication can be published from
        - `governmentResponses` CommitteesCommonResponsesCommonPublicationGovernmentResponse — recursive
        - `publicationEndDate` string, date-time, nullable — Date when publication can be published until
        - `documents` CommitteesCommonResponsesCommonDocumentDocument[], nullable — Documents associated with the publication
          - `documentId` integer
          - `files` CommitteesCommonResponsesCommonDocumentDocumentFile[], nullable
            - `fileName` string, nullable
            - `fileSize` integer, nullable
            - `fileDataFormat` 'OriginalFormat' | 'Html' | 'Pdf'
            - `url` string, nullable
        - `hcNumber` CommitteesCommonResponsesCommonSharedHouseNumber
          - `number` string, nullable
          - `sessionId` integer
          - `sessionDescription` string, nullable
        - `hlPaper` CommitteesCommonResponsesCommonSharedHouseNumber
          - `number` string, nullable
          - `sessionId` integer
          - `sessionDescription` string, nullable
        - `type` CommitteesCommonResponsesCommonPublicationPublicationType
          - `id` integer — The id of the publication type
          - `name` string, nullable — The name of the publication type
          - `description` string, nullable — The description of the publication type
          - `governmentCanRespond` boolean — Indicates that the government can respond to this type of publication
          - `canBeResponse` boolean — Indicates that publications of this type can be responses to other publications.
          - `iconKey` string, nullable — Icon type to be rendered on the website for this type of publication
          - `pluralVersion` string, nullable — Plural form of the publication type name
        - `responseToPublicationId` integer, nullable — If publication is in response to another publication, that publication's id
        - `additionalContentUrl` string, nullable — Url to additional content related to the publication
        - `additionalContentUrl2` string, nullable — Url2 for additional content related to the publication
        - `respondingDepartment` CommitteesCommonResponsesCommonDepartment
          - `id` integer
          - `name` string, nullable
          - `address` CommitteesCommonResponsesCommonSharedAddress
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `addressLine3` string, nullable
            - `addressLine4` string, nullable
            - `addressLine5` string, nullable
            - `postcode` string, nullable
          - `otherAddress` string, nullable
          - `phone` string, nullable
          - `email` string, nullable
          - `url` string, nullable
      - `responseDeadline` string, date-time, nullable — Deadline for response
      - `responseExcepted` boolean — If the response is expected
    - `publicationEndDate` string, date-time, nullable — Date when publication can be published until
    - `documents` CommitteesCommonResponsesCommonDocumentDocument[], nullable — Documents associated with the publication
      - `documentId` integer
      - `files` CommitteesCommonResponsesCommonDocumentDocumentFile[], nullable
        - `fileName` string, nullable
        - `fileSize` integer, nullable
        - `fileDataFormat` 'OriginalFormat' | 'Html' | 'Pdf'
        - `url` string, nullable
    - `hcNumber` CommitteesCommonResponsesCommonSharedHouseNumber
      - `number` string, nullable
      - `sessionId` integer
      - `sessionDescription` string, nullable
    - `hlPaper` CommitteesCommonResponsesCommonSharedHouseNumber
      - `number` string, nullable
      - `sessionId` integer
      - `sessionDescription` string, nullable
    - `type` CommitteesCommonResponsesCommonPublicationPublicationType
      - `id` integer — The id of the publication type
      - `name` string, nullable — The name of the publication type
      - `description` string, nullable — The description of the publication type
      - `governmentCanRespond` boolean — Indicates that the government can respond to this type of publication
      - `canBeResponse` boolean — Indicates that publications of this type can be responses to other publications.
      - `iconKey` string, nullable — Icon type to be rendered on the website for this type of publication
      - `pluralVersion` string, nullable — Plural form of the publication type name
    - `responseToPublicationId` integer, nullable — If publication is in response to another publication, that publication's id
    - `additionalContentUrl` string, nullable — Url to additional content related to the publication
    - `additionalContentUrl2` string, nullable — Url2 for additional content related to the publication
    - `respondingDepartment` CommitteesCommonResponsesCommonDepartment
      - `id` integer
      - `name` string, nullable
      - `address` CommitteesCommonResponsesCommonSharedAddress
        - `addressLine1` string, nullable
        - `addressLine2` string, nullable
        - `addressLine3` string, nullable
        - `addressLine4` string, nullable
        - `addressLine5` string, nullable
        - `postcode` string, nullable
      - `otherAddress` string, nullable
      - `phone` string, nullable
      - `email` string, nullable
      - `url` string, nullable
    - `businesses` CommitteesCommonResponsesCommitteeBusinessSummary[], nullable — Committee business associated with the publication
      - `id` integer — Id of committee business
      - `title` string, nullable — Title of committee business
      - `type` CommitteesCommonResponsesCommonBusinessCommitteeBusinessType
        - `id` integer — Business type Id
        - `name` string, nullable — Name of business type
        - `isInquiry` boolean — If the business is an inquiry
        - `description` string, nullable — Description of the business
      - `openDate` string, date-time — Date the business started
      - `closeDate` string, date-time, nullable — Date the business ended
      - `latestReport` CommitteesCommonResponsesCommonPublicationPublicationSummary
        - `description` string, nullable — Description of publication
        - `id` integer — The id of the publication
        - `publicationStartDate` string, date-time, nullable — Date when publication can be published from
        - `governmentResponses` CommitteesCommonResponsesCommonPublicationGovernmentResponse
          - `publication` CommitteesCommonResponsesCommonPublicationPublicationSummary[], nullable — Publication for government response
          - `responseDeadline` string, date-time, nullable — Deadline for response
          - `responseExcepted` boolean — If the response is expected
        - `publicationEndDate` string, date-time, nullable — Date when publication can be published until
        - `documents` CommitteesCommonResponsesCommonDocumentDocument[], nullable — Documents associated with the publication
          - `documentId` integer
          - `files` CommitteesCommonResponsesCommonDocumentDocumentFile[], nullable
            - `fileName` string, nullable
            - `fileSize` integer, nullable
            - `fileDataFormat` 'OriginalFormat' | 'Html' | 'Pdf'
            - `url` string, nullable
        - `hcNumber` CommitteesCommonResponsesCommonSharedHouseNumber
          - `number` string, nullable
          - `sessionId` integer
          - `sessionDescription` string, nullable
        - `hlPaper` CommitteesCommonResponsesCommonSharedHouseNumber
          - `number` string, nullable
          - `sessionId` integer
          - `sessionDescription` string, nullable
        - `type` CommitteesCommonResponsesCommonPublicationPublicationType
          - `id` integer — The id of the publication type
          - `name` string, nullable — The name of the publication type
          - `description` string, nullable — The description of the publication type
          - `governmentCanRespond` boolean — Indicates that the government can respond to this type of publication
          - `canBeResponse` boolean — Indicates that publications of this type can be responses to other publications.
          - `iconKey` string, nullable — Icon type to be rendered on the website for this type of publication
          - `pluralVersion` string, nullable — Plural form of the publication type name
        - `responseToPublicationId` integer, nullable — If publication is in response to another publication, that publication's id
        - `additionalContentUrl` string, nullable — Url to additional content related to the publication
        - `additionalContentUrl2` string, nullable — Url2 for additional content related to the publication
        - `respondingDepartment` CommitteesCommonResponsesCommonDepartment
          - `id` integer
          - `name` string, nullable
          - `address` CommitteesCommonResponsesCommonSharedAddress
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `addressLine3` string, nullable
            - `addressLine4` string, nullable
            - `addressLine5` string, nullable
            - `postcode` string, nullable
          - `otherAddress` string, nullable
          - `phone` string, nullable
          - `email` string, nullable
          - `url` string, nullable
      - `openSubmissionPeriods` CommitteesCommonResponsesCommonSubmissionSubmissionPeriodSummary[], nullable — Currently open submission periods
        - `id` integer — Id of the submission period
        - `startDate` string, date-time — Submission period start date
        - `endDate` string, date-time, nullable — Submission period end date
        - `submissionType` 'OralEvidence' | 'WrittenEvidence' | 'Petition'
        - `isPromoted` boolean — Whether the submission period should be promoted or not.
        - `statusMessage` string, nullable — The status message of the submission period (if applicable).
        - `allowSubmissionsPastEndDate` boolean — Whether submissions are allowed past the deadline if the form is accessed via direct link.
      - `closedSubmissionPeriods` CommitteesCommonResponsesCommonSubmissionSubmissionPeriodSummary[], nullable — Closed submission periods
        - `id` integer — Id of the submission period
        - `startDate` string, date-time — Submission period start date
        - `endDate` string, date-time, nullable — Submission period end date
        - `submissionType` 'OralEvidence' | 'WrittenEvidence' | 'Petition'
        - `isPromoted` boolean — Whether the submission period should be promoted or not.
        - `statusMessage` string, nullable — The status message of the submission period (if applicable).
        - `allowSubmissionsPastEndDate` boolean — Whether submissions are allowed past the deadline if the form is accessed via direct link.
      - `nextOralEvidenceSession` CommitteesCommonResponsesCommonActivityActivitySummary
        - `id` integer — The id of the activity
        - `name` string, nullable — The name of the activity
        - `startDate` string, date-time — The datetime the activity starts
        - `endDate` string, date-time, nullable — The datetime the activity ends
        - `eventId` integer — The id of the event this activity is attached to
        - `isPrivate` boolean — Whether an activity is private or public
        - `activityType` string, nullable — Type of activity
        - `attendees` CommitteesCommonResponsesCommonPeopleActivityPerson[], nullable — A list of attendees of the activity
          - `id` integer
          - `personId` integer, nullable
          - `name` string, nullable
          - `photoUrl` string, nullable
          - `memberInfo` CommitteesCommonResponsesCommonPeopleMemberInfo
            - `memberFrom` string, nullable
            - `party` string, nullable
            - `partyColour` string, nullable
            - `mnisId` integer
            - `isChair` boolean
            - `listAs` string, nullable
            - `displayAs` string, nullable
            - `fullTitle` string, nullable
            - `addressAs` string, nullable
            - `house` 'Commons' | 'Lords' | 'Joint'
            - `isCurrent` boolean, nullable
          - `organisations` CommitteesCommonResponsesCommonSubmissionOrganisation[], nullable
            - `name` string, nullable
            - `role` string, nullable
            - `idmsId` string, nullable
            - `cisId` integer
          - `submitterType` 'Individual' | 'Organisation' | 'Proxy'
          - `additionalContext` string, nullable
          - `displayOrder` integer
      - `contact` CommitteesCommonResponsesCommonSharedContactInformation
        - `email` string, nullable — Current contact email
        - `phone` string, nullable — Telephone number
        - `address` string, nullable — Postal address
        - `contactDisclaimer` string, nullable — Disclaimer for contact information
    - `committee` CommitteesCommonResponsesCommitteeSummary
      - `contact` CommitteesCommonResponsesCommonSharedContactInformation
        - `email` string, nullable — Current contact email
        - `phone` string, nullable — Telephone number
        - `address` string, nullable — Postal address
        - `contactDisclaimer` string, nullable — Disclaimer for contact information
      - `id` integer — The id of the committee
      - `name` string, nullable — The current name of the committee
      - `parentCommittee` CommitteesCommonResponsesCommitteeSummary — recursive
      - `subCommittees` CommitteesCommonResponsesCommitteeSummary[], nullable — Sub-committees of this committee
      - `house` 'Commons' | 'Lords' | 'Joint'
      - `leadHouse` CommitteesCommonResponsesCommonCommitteeLeadHouse
        - `isCommons` boolean
        - `isLords` boolean
      - `category` CommitteesCommonResponsesCommonCommitteeCommitteeCategory
        - `id` integer — Committee category Id
        - `name` string, nullable — Committee category Name
      - `committeeTypes` CommitteesCommonResponsesCommonCommitteeCommitteeType[], nullable — List of Committee types
        - `id` integer — Committee type Id
        - `name` string, nullable — Committee type name
        - `committeeCategory` CommitteesCommonResponsesCommonCommitteeCommitteeCategory
          - `id` integer — Committee category Id
          - `name` string, nullable — Committee category Name
      - `showOnWebsite` boolean — If this committee should be shown on the website
      - `websiteLegacyUrl` string, nullable — The legacy website URL for the committee, if one exists.
      - `websiteLegacyRedirectEnabled` boolean — Whether automatic redirect to the legacy website has been enabled for the committee.
      - `startDate` string, date-time — The start date of the committee
      - `endDate` string, date-time, nullable — The end date of the committee
      - `dateCommonsAppointed` string, date-time, nullable — The date the committee was appointed by the House of Commons
      - `dateLordsAppointed` string, date-time, nullable — The date the committee was appointed by the House of Lords
      - `scrutinisingDepartments` CommitteesCommonResponsesScrutinisingDepartment[], nullable — All the departments the committee scrutinises
        - `departmentId` integer — The Id of the department which this committee scrutinises
        - `name` string, nullable — The name of the department which this committee scrutinises
      - `isLeadCommittee` boolean, nullable — Is the lead Committee, if linked to an event with multiple Committees
      - `nameHistory` CommitteesCommonResponsesCommonCommitteeCommitteeName[], nullable — Previous names of this committee
        - `id` integer
        - `committeeId` integer
        - `name` string, nullable
        - `startDate` string, date-time
        - `endDate` string, date-time, nullable
  - `totalResults` integer
  - `itemsPerPage` integer
  - `links` CommitteesCommonLink[], nullable
    - `rel` string, nullable
    - `href` string, nullable
    - `method` string, nullable

## Other responses

- `400` — There was an error with one or more of specified search parameters

---

[API](https://skmtc.dev/parliament/apis/committees-api.md) · [All operations](https://skmtc.dev/parliament/apis/committees-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/parliament/committees-api/revisions/2963ac78fed1/schema)