---
title: "Return a list of interests that have been published on a register."
method: GET
path: "/api/v1/Interests"
tags: ["Interests"]
---

# Return a list of interests that have been published on a register.

`GET /api/v1/Interests`

## Query parameters

- `MemberId` integer
- `CategoryId` integer
- `PublishedFrom` string, date
- `PublishedTo` string, date
- `RegisteredFrom` string, date
- `RegisteredTo` string, date
- `UpdatedFrom` string, date
- `UpdatedTo` string, date
- `RegisterId` integer
- `ExpandChildInterests` boolean
- `Take` integer
- `SortOrder` 'PublishingDateDescending' | 'CategoryAscending' — The order in which interests endpoints should return results.
- `Skip` integer

## Response `200`

OK

- PublishedInterestApiLinkedSearchResult — Paginated search result with HATEOAS Links.
  - `skip` integer — The skip value that was used in the query.
  - `take` integer — The take value that was used in the query.
  - `totalResults` integer — The total number of results which matches the query.
  - `items` PublishedInterest[], nullable — The list of items found for the specified page (by requested skip and take).
    - `id` integer — ID of the interest.
    - `summary` string, nullable — Title Summary for the interest.
    - `parentInterestId` integer, nullable — The unique ID for the payer (parent interest) to which this payment (child interest) is associated.
    - `registrationDate` string, date, nullable — Registration Date on the published interest.
    - `publishedDate` string, date, nullable — Date when the interest was first published.
    - `updatedDates` string[], nullable — A list of dates on which the interest has been updated since it has been published.
    - `category` PublishedCategory — Category an interest can be registered with.
      - `id` integer — ID of the category.
      - `number` string, nullable — Number of the category in the code of conduct.
      - `name` string, nullable — Name of the category.
      - `parentCategoryIds` integer[], nullable — The unique ID for any parent category to which this category is associated, if the category is associated with another category.
      - `type` 'Commons' — The type of register of interests
      - `links` Link[], nullable — A list of HATEOAS Links for retrieving further information about this category.
        - `rel` string, nullable — Relationship of the link to the object requested.
        - `href` string, nullable — A complete URL that shows how the action can be performed.
        - `method` string, nullable — Request method of the link.
    - `member` Member — Member of Parliament who has registered the interest.
      - `id` integer — ID of the member.
      - `nameDisplayAs` string, nullable — Member's current full name, as it should be displayed in text.
      - `nameListAs` string, nullable — Member's current name in the format {surname}, {forename}, for use in an ordered list.
      - `house` string, nullable — The name of the House the Member is currently associated with.
      - `memberFrom` string, nullable — How they are a Member of Parliament (for MP, this is their constituency)
      - `party` string, nullable — Party the Member is currently associated with.
      - `links` Link[], nullable — A list of HATEOAS Links for retrieving further information about this member.
        - `rel` string, nullable — Relationship of the link to the object requested.
        - `href` string, nullable — A complete URL that shows how the action can be performed.
        - `method` string, nullable — Request method of the link.
    - `fields` Field[], nullable — List of fields which are available for a member to add further information about the interest.
      - `name` string, nullable
      - `description` string, nullable
      - `type` string, nullable
      - `typeInfo` FieldTypeInfo
        - `currencyCode` string, nullable
      - `value` unknown
      - `values` array[], nullable
        - Field[]
    - `childInterests` PublishedInterest[], nullable — List of Interests which are sub interests of this interest. This property is only present if `ExpandChildInterests` is true, and is not defined by default.
    - `links` Link[], nullable — A list of HATEOAS Links for retrieving related information about this interest.
      - `rel` string, nullable — Relationship of the link to the object requested.
      - `href` string, nullable — A complete URL that shows how the action can be performed.
      - `method` string, nullable — Request method of the link.
    - `rectified` boolean — Whether the interest has been rectified (e.g. when the interest was submitted late).
    - `rectifiedDetails` string, nullable — The reason that the interest was rectified, or `null` if the interest was not rectified.
  - `links` Link[], nullable — A list of HATEOAS Links for navigating through the paginated result.
    - `rel` string, nullable — Relationship of the link to the object requested.
    - `href` string, nullable — A complete URL that shows how the action can be performed.
    - `method` string, nullable — Request method of the link.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/parliament/apis/register-of-interests-api.md) · [All operations](https://skmtc.net/parliament/apis/register-of-interests-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/parliament/register-of-interests-api/versions/884839d1c6c4/schema)