GET Published/NoticeVersions/{id}

Gets historical version details for the published notice identified by the provided id.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The GUID identifying the published notice.

globally unique identifier

Required

Body Parameters

None.

Response Information

Resource Description

A collection of PublishedNoticeVersion objects; otherwise a collection of validation errors with HTTP status 400.

Collection of PublishedNoticeVersion
NameDescriptionTypeAdditional information
ChangedByUser

Gets or sets the name of the user that forced the change

string

None.

DateChanged

Gets or sets the date the record was changed on

date

None.

NoticeStatus

The status of the notice in this version.

string

None.

NoticeType

The type of the notice in this version.

string

None.

PublishedNoticeId

Gets or sets the published notice id

globally unique identifier

None.

Reason

Gets or sets the reason for the change

string

No longer used.

VersionNumber

Gets or sets the version number of the notice

integer

None.

Response Formats

HTTP response status code: 200

application/json, text/json

Sample:
[
  {
    "changedByUser": "a.buyer@dept.gov.uk",
    "dateChanged": "2015-02-01T00:00:00Z",
    "id": 1,
    "noticeStatus": "Open",
    "noticeType": "Contract",
    "publishedNoticeId": "d31c1dfb-462c-42f6-ab22-6860cc3a65b0",
    "reason": null,
    "versionNumber": 1,
    "visibleToPublic": true
  },
  {
    "changedByUser": "a.buyer@dept.gov.uk",
    "dateChanged": "2015-02-02T00:00:00Z",
    "id": 2,
    "noticeStatus": "Open",
    "noticeType": "Contract",
    "publishedNoticeId": "d31c1dfb-462c-42f6-ab22-6860cc3a65b0",
    "reason": null,
    "versionNumber": 2,
    "visibleToPublic": true
  }
]

application/xml, text/xml

Sample:
<ArrayOfPublishedNoticeVersion xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/IPL.ContractsFinder.BusinessEntities">
  <PublishedNoticeVersion>
    <ChangedByUser>a.buyer@dept.gov.uk</ChangedByUser>
    <DateChanged>2015-02-01T00:00:00Z</DateChanged>
    <Id>1</Id>
    <NoticeStatus>Open</NoticeStatus>
    <NoticeType>Contract</NoticeType>
    <PublishedNoticeId>d31c1dfb-462c-42f6-ab22-6860cc3a65b0</PublishedNoticeId>
    <Reason>null</Reason>
    <VersionNumber>1</VersionNumber>
    <VisibleToPublic>true</VisibleToPublic>
  </PublishedNoticeVersion>
  <PublishedNoticeVersion>
    <ChangedByUser>a.buyer@dept.gov.uk</ChangedByUser>
    <DateChanged>2015-02-02T00:00:00Z</DateChanged>
    <Id>2</Id>
    <NoticeStatus>Open</NoticeStatus>
    <NoticeType>Contract</NoticeType>
    <PublishedNoticeId>d31c1dfb-462c-42f6-ab22-6860cc3a65b0</PublishedNoticeId>
    <Reason>null</Reason>
    <VersionNumber>2</VersionNumber>
    <VisibleToPublic>true</VisibleToPublic>
  </PublishedNoticeVersion>
</ArrayOfPublishedNoticeVersion>

HTTP response status code: 403

When the user has submitted too many requests, no further requests should be made until after 5 minutes

text/plain

Sample:

Body:

<html><head><title>Forbidden - Contracts Finder</title></head><body><p><h1><strong>Request forbidden</strong></h1></p><p>The request rate limit may have been exceeded. If you believe this is an error <a href="https://www.contractsfinder.service.gov.uk/Home/Contact">contact us</a> quoting 0QrFmYQAAAABs5RRpp9L8RbtJ8k4jz8gwTE9OMjFFREdFMDIwOABiYTEyMjkxMi0zZWE0LTQ1NTQtYjNjNi1mNmRmZDU2MGY2ZDM=.</p></body></html>