GET Published/NoticeVersions/{id}

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

Request Information

URI Parameters

Name	Description	Type	Additional 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

Name	Description	Type	Additional 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>