GET Published/Notices/OCDS/Search

Searches for published notice OCDS releases package with optional search criteria.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
publishedFrom

Lower limit on publication date (latest edit and first publication in current stage).

String

Optional. ISO 8601 format.
publishedTo

Upper limit on publication date (latest edit and first publication in current stage).

String

Optional. ISO 8601 format.
stages

Procurement stages to return.

String

Optional. Multiple values can be specified, comma-separated. Values: planning, tender, award, implementation.
limit

Maximum number of releases returned.

Integer

Default: 100. Values: 1 to 100.
cursor

Property to get the next set of results

String

Optional. [A-Za-z0-9=]{0,300}

Body Parameters

None.

Response Information

Resource Description

An OCDS release package is returned containing releases matching the search criteria.

Response Formats

HTTP response status code: 200

application/json, text/json

Sample: 
{
  "uri": "https://www.contractsfinder.service.gov.uk/Published/Notices/OCDS/Search?publishedFrom=2021-10-28T00:00:00&publishedTo=2021-10-28T23:00:00&stages=planning,tender",
  "version": "1.1",
  "extensions": [
      "https://standard.open-contracting.org/profiles/eu/master/en/extension.json",
	  "https://raw.githubusercontent.com/open-contracting-extensions/ocds_budget_breakdown_extension/master/extension.json"  
  ],
  "publishedDate": "2016-11-29T11:04:09Z",
  "publisher": {
	  "name": "Cabinet Office",
	  "scheme": "GB-GOVUK",
	  "uid": "D2",
	  "uri": "https://www.gov.uk/government/organisations/cabinet-office"
  },
  "license": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"
  "publicationPolicy": "https://www.gov.uk/government/publications/open-contracting",
  "releases": [
  {
	  "ocid": "ocds-b5fd17-09bd4f79-fce6-47eb-9505-49c9822d7486",
	  "id": "ocds-b5fd17-09bd4f79-fce6-47eb-9505-49c9822d7486-ra155102",
	  "language": "en-GB",
	  ...
  }],
  ...
}

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>