An official site of the British Prime Minister's Office

Business Plans API

The UK Government releases data on progress with Structural Reform Plan commitments via an Application Programming Interface (API), so developers and other interested parties can interact in a programmatic way with the underlying data. This document is the official reference for that functionality; from time to time it may be updated with new functionality methods, updated instructions, examples and terms and conditions of use.

Rate Limit

We do not limit the number of requests but we do monitor all requests. We may impede requests from certain IPs if they impact the availability of the core services. We strongly advise users to cache as much as possible to help maintain a healthy system.

Cache

API underlying data is cached for up to 30 minutes and it is therefore unnecessary to carry out requests at shorter intervals.

HTTP response code

All JSON and XML format will carry an HTTP Response Status Code. This follows the W3C HTTP Status Code Definition. Response Status Codes 403, 500 and 503 are used to denote errors, a problem with the request format or invalid function, or an unknown error. Almost all status codes other than 200 are returned with a descriptive text.

Attribution

Please do not include any Cabinet Office or No 10 branding in your application or give the impression that the resulting application is an official product.

Service and Support

No support or SLA is provided with the API.

API Technical overview

The Business Plan API is controlled via GET HTTP requests only and with varying parameters.

The API is based on JSON by default but an XML version is available by providing a format request.

A basic example of a request would be:

http://transparency.number10.gov.uk/api/{objects}

or

http://transparency.number10.gov.uk/api/{functions}/[param]/[id]/[format/xml]

Methods

The API structures data as follows::

  • A Government Department's Coalition Priorities
  • The mid-level groupings of actions and the bottom-level, specific actions under each priority

 

Departments - list all departments

Resource Url

http://transparency.number10.gov.uk/api/departments

Parameters

None

Example

JSON

http://transparency.number10.gov.uk/api/departments

JSONP

http://transparency.number10.gov.uk/api/departments/format/jsonp/?callback=callback

XML

http://transparency.number10.gov.uk/api/departments/format/xml


Departments - get a department

Resource Url

http://transparency.number10.gov.uk/api/department/id/{id}

Parameters

Parameters Info
id (required) Identifier of the Department

 

Example - with XML output

http://transparency.number10.gov.uk/api/department/id/1/format/xml

Priorities - get a Departmental Priorities

Resource Url

http://transparency.number10.gov.uk/api/priorities/department_id/{department_id}

Parameters

Parameters Info
department_id (required) Identifier of the department

Example

http://transparency.number10.gov.uk/api/priorities/department_id/1

Actions - get mid-level groupings of actions and specific actions within a Coalition Priority

Resource Url

http://transparency.number10.gov.uk/api/actions/priority_id/{priority_id}

Parameters

Parameters Info
priority_id (required) Identifier of the Priority Id (which can be found by listing Departmental Priorities)

Example

http://transparency.number10.gov.uk/api/actions/priority_id/76