Table of contents

GOV.UK Content API v1.0.0

GOV.UK Content API provides a simple and consistent way to request GOV.UK content as structured data in a predictable format. It is used within the GOV.UK website as the means for applications to lookup content in order to render it.

This API accepts HTTP requests and responds with JSON data containing the same published content as is presented on GOV.UK.

Base URL

All requests to this API should be prefixed with the following URL:

https://www.gov.uk/api/content

Content

GET /{path}

Lookup GOV.UK content by path

This is the primary interface to lookup the content required to render a page on GOV.UK

It accepts an input of the path of the page you are looking up. For example, if you were looking up travel advice for Thailand which is hosted on GOV.UK at https://www.gov.uk/foreign-travel-advice/thailand you would make a request to https://www.gov.uk/api/content/foreign-travel-advice/thailand.

If the content is available at the requested path you will receive a ContentItem containing the structured data for that page.

This request does not require authentication.

Parameters

Parameter In Type Required Description
path path string true The path to the content on GOV.UK e.g for https://www.gov.uk/vat-rates you’d use vat-rates

Example Request

curl https://www.gov.uk/api/content/vat-rates

Example Response

Examples

{
  "analytics_identifier": null,
  "base_path": "/vat-rates",
  "content_id": "f838c22a-b2aa-49be-bd95-153f593293a3",
  "document_type": "answer",
  "email_document_supertype": "other",
  "first_published_at": "2016-02-29T09:24:10.000+00:00",
  "government_document_supertype": "other",
  "locale": "en",
  "navigation_document_supertype": "guidance",
  "need_ids": [],
  "phase": "live",
  "public_updated_at": "2014-12-12T14:55:23.000+00:00",
  "publishing_app": "publisher",
  "rendering_app": "government-frontend",
  "schema_name": "answer",
  "title": "VAT rates",
  "updated_at": "2017-08-31T11:35:14.024Z",
  "user_journey_document_supertype": "thing",
  "withdrawn_notice": {},
  "publishing_request_id": "3592-1504179295.816-10.3.3.1-410",
  "links": {
    "mainstream_browse_pages": [
      {
        "api_path": "/api/content/browse/tax/vat",
        "base_path": "/browse/tax/vat",
        "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
        "description": "Includes online returns, rates, charging and record keeping",
        "document_type": "mainstream_browse_page",
        "locale": "en",
        "public_updated_at": "2015-06-24T13:56:39Z",
        "schema_name": "mainstream_browse_page",
        "title": "VAT",
        "withdrawn": false,
        "links": {},
        "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
        "web_url": "https://www.gov.uk/browse/tax/vat"
      }
    ],
    "ordered_related_items": [
      {
        "api_path": "/api/content/tax-on-shopping",
        "base_path": "/tax-on-shopping",
        "content_id": "ca839010-1a5e-4049-93b5-577a40286701",
        "description": "VAT and other taxes on shopping and services, including tax-free shopping, energy-saving equipment and mobility aids",
        "document_type": "guide",
        "locale": "en",
        "public_updated_at": "2014-12-18T14:31:58Z",
        "schema_name": "guide",
        "title": "Tax on shopping and services",
        "withdrawn": false,
        "links": {
          "mainstream_browse_pages": [
            {
              "api_path": "/api/content/browse/tax/vat",
              "base_path": "/browse/tax/vat",
              "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
              "description": "Includes online returns, rates, charging and record keeping",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2015-06-24T13:56:39Z",
              "schema_name": "mainstream_browse_page",
              "title": "VAT",
              "withdrawn": false,
              "links": {
                "parent": [
                  {
                    "api_path": "/api/content/browse/tax",
                    "base_path": "/browse/tax",
                    "content_id": "71255733-af6c-4887-9991-9b288d8d431f",
                    "description": "Includes VAT, debt and inheritance tax",
                    "document_type": "mainstream_browse_page",
                    "locale": "en",
                    "public_updated_at": "2015-04-08T10:48:40Z",
                    "schema_name": "mainstream_browse_page",
                    "title": "Money and tax",
                    "withdrawn": false,
                    "links": {},
                    "api_url": "https://www.gov.uk/api/content/browse/tax",
                    "web_url": "https://www.gov.uk/browse/tax"
                  }
                ]
              },
              "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
              "web_url": "https://www.gov.uk/browse/tax/vat"
            }
          ]
        },
        "api_url": "https://www.gov.uk/api/content/tax-on-shopping",
        "web_url": "https://www.gov.uk/tax-on-shopping"
      },
      {
        "api_path": "/api/content/vat-businesses",
        "base_path": "/vat-businesses",
        "content_id": "727e4b52-b760-4bd6-844d-48d8df888e32",
        "description": "VAT for business - VAT rates, exempt and zero-rated items, when to charge VAT, credit and debit notes, discounts and VAT on offers",
        "document_type": "guide",
        "locale": "en",
        "public_updated_at": "2014-12-19T15:27:25Z",
        "schema_name": "guide",
        "title": "Businesses and charging VAT",
        "withdrawn": false,
        "links": {
          "mainstream_browse_pages": [
            {
              "api_path": "/api/content/browse/business/business-tax",
              "base_path": "/browse/business/business-tax",
              "content_id": "b7d6588c-a056-47fc-9528-0b9ff42c3866",
              "description": "Includes Corporation Tax, Capital Gains Tax, Construction Industry Scheme (CIS) and VAT",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2016-11-18T16:02:29Z",
              "schema_name": "mainstream_browse_page",
              "title": "Business tax",
              "withdrawn": false,
              "links": {
                "parent": [
                  {
                    "api_path": "/api/content/browse/business",
                    "base_path": "/browse/business",
                    "content_id": "2e47e500-8d91-4747-b6d8-cf6524d570f1",
                    "description": "Information about starting up and running a business in the UK, including help if you're self employed or a sole trader.",
                    "document_type": "mainstream_browse_page",
                    "locale": "en",
                    "public_updated_at": "2016-11-18T16:02:29Z",
                    "schema_name": "mainstream_browse_page",
                    "title": "Business and self-employed",
                    "withdrawn": false,
                    "links": {},
                    "api_url": "https://www.gov.uk/api/content/browse/business",
                    "web_url": "https://www.gov.uk/browse/business"
                  }
                ]
              },
              "api_url": "https://www.gov.uk/api/content/browse/business/business-tax",
              "web_url": "https://www.gov.uk/browse/business/business-tax"
            },
            {
              "api_path": "/api/content/browse/tax/vat",
              "base_path": "/browse/tax/vat",
              "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
              "description": "Includes online returns, rates, charging and record keeping",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2015-06-24T13:56:39Z",
              "schema_name": "mainstream_browse_page",
              "title": "VAT",
              "withdrawn": false,
              "links": {
                "parent": [
                  {
                    "api_path": "/api/content/browse/tax",
                    "base_path": "/browse/tax",
                    "content_id": "71255733-af6c-4887-9991-9b288d8d431f",
                    "description": "Includes VAT, debt and inheritance tax",
                    "document_type": "mainstream_browse_page",
                    "locale": "en",
                    "public_updated_at": "2015-04-08T10:48:40Z",
                    "schema_name": "mainstream_browse_page",
                    "title": "Money and tax",
                    "withdrawn": false,
                    "links": {},
                    "api_url": "https://www.gov.uk/api/content/browse/tax",
                    "web_url": "https://www.gov.uk/browse/tax"
                  }
                ]
              },
              "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
              "web_url": "https://www.gov.uk/browse/tax/vat"
            }
          ]
        },
        "api_url": "https://www.gov.uk/api/content/vat-businesses",
        "web_url": "https://www.gov.uk/vat-businesses"
      }
    ],
    "organisations": [
      {
        "analytics_identifier": "D25",
        "api_path": "/api/content/government/organisations/hm-revenue-customs",
        "base_path": "/government/organisations/hm-revenue-customs",
        "content_id": "6667cce2-e809-4e21-ae09-cb0bdc1ddda3",
        "document_type": "organisation",
        "locale": "en",
        "public_updated_at": "2015-05-13T10:09:06Z",
        "schema_name": "placeholder",
        "title": "HM Revenue & Customs",
        "withdrawn": false,
        "details": {
          "brand": "hm-revenue-customs",
          "logo": {
            "formatted_title": "HM Revenue<br/>&amp; Customs",
            "crest": "hmrc"
          }
        },
        "links": {},
        "api_url": "https://www.gov.uk/api/content/government/organisations/hm-revenue-customs",
        "web_url": "https://www.gov.uk/government/organisations/hm-revenue-customs"
      }
    ],
    "parent": [
      {
        "api_path": "/api/content/browse/tax/vat",
        "base_path": "/browse/tax/vat",
        "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
        "description": "Includes online returns, rates, charging and record keeping",
        "document_type": "mainstream_browse_page",
        "locale": "en",
        "public_updated_at": "2015-06-24T13:56:39Z",
        "schema_name": "mainstream_browse_page",
        "title": "VAT",
        "withdrawn": false,
        "links": {
          "parent": [
            {
              "api_path": "/api/content/browse/tax",
              "base_path": "/browse/tax",
              "content_id": "71255733-af6c-4887-9991-9b288d8d431f",
              "description": "Includes VAT, debt and inheritance tax",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2015-04-08T10:48:40Z",
              "schema_name": "mainstream_browse_page",
              "title": "Money and tax",
              "withdrawn": false,
              "links": {},
              "api_url": "https://www.gov.uk/api/content/browse/tax",
              "web_url": "https://www.gov.uk/browse/tax"
            }
          ]
        },
        "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
        "web_url": "https://www.gov.uk/browse/tax/vat"
      }
    ],
    "topics": [
      {
        "api_path": "/api/content/topic/business-tax/vat",
        "base_path": "/topic/business-tax/vat",
        "content_id": "1ddaaacb-0981-4abc-a532-a5111f2bea6b",
        "description": "List of information about VAT.",
        "document_type": "topic",
        "locale": "en",
        "public_updated_at": "2016-11-30T14:17:03Z",
        "schema_name": "topic",
        "title": "VAT",
        "withdrawn": false,
        "links": {},
        "api_url": "https://www.gov.uk/api/content/topic/business-tax/vat",
        "web_url": "https://www.gov.uk/topic/business-tax/vat"
      }
    ],
    "available_translations": [
      {
        "title": "VAT rates",
        "public_updated_at": "2014-12-12T14:55:23Z",
        "document_type": "answer",
        "schema_name": "answer",
        "base_path": "/vat-rates",
        "description": "Current VAT rates - standard 20% and rates for reduced rate and zero-rated items",
        "api_path": "/api/content/vat-rates",
        "withdrawn": false,
        "content_id": "f838c22a-b2aa-49be-bd95-153f593293a3",
        "locale": "en",
        "api_url": "https://www.gov.uk/api/content/vat-rates",
        "web_url": "https://www.gov.uk/vat-rates",
        "links": {}
      }
    ]
  },
  "description": "Current VAT rates - standard 20% and rates for reduced rate and zero-rated items",
  "details": {
    "body": "\n<div class=\"highlight-answer\">\n<p>The standard <abbr title=\"Value Added Tax\">VAT</abbr> rate is <em>20%</em></p>\n</div>\n\n<h2 id=\"vat-rates-for-goods-and-services\">\n<abbr title=\"Value Added Tax\">VAT</abbr> rates for goods and services</h2>\n\n<table>\n  <thead>\n    <tr>\n      <th>Rate</th>\n      <th>% of <abbr title=\"Value Added Tax\">VAT</abbr>\n</th>\n      <th>What the rate applies to</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Standard</td>\n      <td>20%</td>\n      <td>Most goods and services</td>\n    </tr>\n    <tr>\n      <td>Reduced rate</td>\n      <td>5%</td>\n      <td>Some goods and services, eg children’s car seats and home energy</td>\n    </tr>\n    <tr>\n      <td>Zero rate</td>\n      <td>0%</td>\n      <td>Zero-rated goods and services, eg most food and children’s clothes</td>\n    </tr>\n  </tbody>\n</table>\n\n<p>The standard rate of <abbr title=\"Value Added Tax\">VAT</abbr> increased to 20% on 4 January 2011 (from 17.5%).</p>\n\n<p>Some things are exempt from <abbr title=\"Value Added Tax\">VAT</abbr>, eg postage stamps, financial and property transactions.</p>\n\n<p>The <a href=\"/vat-businesses/vat-rates\"><abbr title=\"Value Added Tax\">VAT</abbr> rate businesses charge</a> depends on their goods and services.</p>\n\n<p>Check the <a href=\"https://www.gov.uk/rates-of-vat-on-different-goods-and-services\">rates of <abbr title=\"Value Added Tax\">VAT</abbr></a> on different goods and services.</p>\n\n"
  }
}

Responses

Status Meaning Description Schema
200 OK A content item is available at that path. ContentItem
303 See Other A content item at a different location is responsible for the content at this path. Learn more. None
404 Not Found No content item is available at that path. None
410 Gone The content item is no longer available at that path. None

Objects

ContentItem

A resource that represents a piece of content on GOV.UK. It contains metadata that describe common attributes shared between all content, a details for the particular content and a links field to describe relationships with other content.

Sample JSON

{
  "analytics_identifier": null,
  "base_path": "/vat-rates",
  "content_id": "f838c22a-b2aa-49be-bd95-153f593293a3",
  "document_type": "answer",
  "email_document_supertype": "other",
  "first_published_at": "2016-02-29T09:24:10.000+00:00",
  "government_document_supertype": "other",
  "locale": "en",
  "navigation_document_supertype": "guidance",
  "need_ids": [],
  "phase": "live",
  "public_updated_at": "2014-12-12T14:55:23.000+00:00",
  "publishing_app": "publisher",
  "rendering_app": "government-frontend",
  "schema_name": "answer",
  "title": "VAT rates",
  "updated_at": "2017-08-31T11:35:14.024Z",
  "user_journey_document_supertype": "thing",
  "withdrawn_notice": {},
  "publishing_request_id": "3592-1504179295.816-10.3.3.1-410",
  "links": {
    "mainstream_browse_pages": [
      {
        "api_path": "/api/content/browse/tax/vat",
        "base_path": "/browse/tax/vat",
        "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
        "description": "Includes online returns, rates, charging and record keeping",
        "document_type": "mainstream_browse_page",
        "locale": "en",
        "public_updated_at": "2015-06-24T13:56:39Z",
        "schema_name": "mainstream_browse_page",
        "title": "VAT",
        "withdrawn": false,
        "links": {},
        "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
        "web_url": "https://www.gov.uk/browse/tax/vat"
      }
    ],
    "ordered_related_items": [
      {
        "api_path": "/api/content/tax-on-shopping",
        "base_path": "/tax-on-shopping",
        "content_id": "ca839010-1a5e-4049-93b5-577a40286701",
        "description": "VAT and other taxes on shopping and services, including tax-free shopping, energy-saving equipment and mobility aids",
        "document_type": "guide",
        "locale": "en",
        "public_updated_at": "2014-12-18T14:31:58Z",
        "schema_name": "guide",
        "title": "Tax on shopping and services",
        "withdrawn": false,
        "links": {
          "mainstream_browse_pages": [
            {
              "api_path": "/api/content/browse/tax/vat",
              "base_path": "/browse/tax/vat",
              "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
              "description": "Includes online returns, rates, charging and record keeping",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2015-06-24T13:56:39Z",
              "schema_name": "mainstream_browse_page",
              "title": "VAT",
              "withdrawn": false,
              "links": {
                "parent": [
                  {
                    "api_path": "/api/content/browse/tax",
                    "base_path": "/browse/tax",
                    "content_id": "71255733-af6c-4887-9991-9b288d8d431f",
                    "description": "Includes VAT, debt and inheritance tax",
                    "document_type": "mainstream_browse_page",
                    "locale": "en",
                    "public_updated_at": "2015-04-08T10:48:40Z",
                    "schema_name": "mainstream_browse_page",
                    "title": "Money and tax",
                    "withdrawn": false,
                    "links": {},
                    "api_url": "https://www.gov.uk/api/content/browse/tax",
                    "web_url": "https://www.gov.uk/browse/tax"
                  }
                ]
              },
              "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
              "web_url": "https://www.gov.uk/browse/tax/vat"
            }
          ]
        },
        "api_url": "https://www.gov.uk/api/content/tax-on-shopping",
        "web_url": "https://www.gov.uk/tax-on-shopping"
      },
      {
        "api_path": "/api/content/vat-businesses",
        "base_path": "/vat-businesses",
        "content_id": "727e4b52-b760-4bd6-844d-48d8df888e32",
        "description": "VAT for business - VAT rates, exempt and zero-rated items, when to charge VAT, credit and debit notes, discounts and VAT on offers",
        "document_type": "guide",
        "locale": "en",
        "public_updated_at": "2014-12-19T15:27:25Z",
        "schema_name": "guide",
        "title": "Businesses and charging VAT",
        "withdrawn": false,
        "links": {
          "mainstream_browse_pages": [
            {
              "api_path": "/api/content/browse/business/business-tax",
              "base_path": "/browse/business/business-tax",
              "content_id": "b7d6588c-a056-47fc-9528-0b9ff42c3866",
              "description": "Includes Corporation Tax, Capital Gains Tax, Construction Industry Scheme (CIS) and VAT",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2016-11-18T16:02:29Z",
              "schema_name": "mainstream_browse_page",
              "title": "Business tax",
              "withdrawn": false,
              "links": {
                "parent": [
                  {
                    "api_path": "/api/content/browse/business",
                    "base_path": "/browse/business",
                    "content_id": "2e47e500-8d91-4747-b6d8-cf6524d570f1",
                    "description": "Information about starting up and running a business in the UK, including help if you're self employed or a sole trader.",
                    "document_type": "mainstream_browse_page",
                    "locale": "en",
                    "public_updated_at": "2016-11-18T16:02:29Z",
                    "schema_name": "mainstream_browse_page",
                    "title": "Business and self-employed",
                    "withdrawn": false,
                    "links": {},
                    "api_url": "https://www.gov.uk/api/content/browse/business",
                    "web_url": "https://www.gov.uk/browse/business"
                  }
                ]
              },
              "api_url": "https://www.gov.uk/api/content/browse/business/business-tax",
              "web_url": "https://www.gov.uk/browse/business/business-tax"
            },
            {
              "api_path": "/api/content/browse/tax/vat",
              "base_path": "/browse/tax/vat",
              "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
              "description": "Includes online returns, rates, charging and record keeping",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2015-06-24T13:56:39Z",
              "schema_name": "mainstream_browse_page",
              "title": "VAT",
              "withdrawn": false,
              "links": {
                "parent": [
                  {
                    "api_path": "/api/content/browse/tax",
                    "base_path": "/browse/tax",
                    "content_id": "71255733-af6c-4887-9991-9b288d8d431f",
                    "description": "Includes VAT, debt and inheritance tax",
                    "document_type": "mainstream_browse_page",
                    "locale": "en",
                    "public_updated_at": "2015-04-08T10:48:40Z",
                    "schema_name": "mainstream_browse_page",
                    "title": "Money and tax",
                    "withdrawn": false,
                    "links": {},
                    "api_url": "https://www.gov.uk/api/content/browse/tax",
                    "web_url": "https://www.gov.uk/browse/tax"
                  }
                ]
              },
              "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
              "web_url": "https://www.gov.uk/browse/tax/vat"
            }
          ]
        },
        "api_url": "https://www.gov.uk/api/content/vat-businesses",
        "web_url": "https://www.gov.uk/vat-businesses"
      }
    ],
    "organisations": [
      {
        "analytics_identifier": "D25",
        "api_path": "/api/content/government/organisations/hm-revenue-customs",
        "base_path": "/government/organisations/hm-revenue-customs",
        "content_id": "6667cce2-e809-4e21-ae09-cb0bdc1ddda3",
        "document_type": "organisation",
        "locale": "en",
        "public_updated_at": "2015-05-13T10:09:06Z",
        "schema_name": "placeholder",
        "title": "HM Revenue & Customs",
        "withdrawn": false,
        "details": {
          "brand": "hm-revenue-customs",
          "logo": {
            "formatted_title": "HM Revenue<br/>&amp; Customs",
            "crest": "hmrc"
          }
        },
        "links": {},
        "api_url": "https://www.gov.uk/api/content/government/organisations/hm-revenue-customs",
        "web_url": "https://www.gov.uk/government/organisations/hm-revenue-customs"
      }
    ],
    "parent": [
      {
        "api_path": "/api/content/browse/tax/vat",
        "base_path": "/browse/tax/vat",
        "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
        "description": "Includes online returns, rates, charging and record keeping",
        "document_type": "mainstream_browse_page",
        "locale": "en",
        "public_updated_at": "2015-06-24T13:56:39Z",
        "schema_name": "mainstream_browse_page",
        "title": "VAT",
        "withdrawn": false,
        "links": {
          "parent": [
            {
              "api_path": "/api/content/browse/tax",
              "base_path": "/browse/tax",
              "content_id": "71255733-af6c-4887-9991-9b288d8d431f",
              "description": "Includes VAT, debt and inheritance tax",
              "document_type": "mainstream_browse_page",
              "locale": "en",
              "public_updated_at": "2015-04-08T10:48:40Z",
              "schema_name": "mainstream_browse_page",
              "title": "Money and tax",
              "withdrawn": false,
              "links": {},
              "api_url": "https://www.gov.uk/api/content/browse/tax",
              "web_url": "https://www.gov.uk/browse/tax"
            }
          ]
        },
        "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
        "web_url": "https://www.gov.uk/browse/tax/vat"
      }
    ],
    "topics": [
      {
        "api_path": "/api/content/topic/business-tax/vat",
        "base_path": "/topic/business-tax/vat",
        "content_id": "1ddaaacb-0981-4abc-a532-a5111f2bea6b",
        "description": "List of information about VAT.",
        "document_type": "topic",
        "locale": "en",
        "public_updated_at": "2016-11-30T14:17:03Z",
        "schema_name": "topic",
        "title": "VAT",
        "withdrawn": false,
        "links": {},
        "api_url": "https://www.gov.uk/api/content/topic/business-tax/vat",
        "web_url": "https://www.gov.uk/topic/business-tax/vat"
      }
    ],
    "available_translations": [
      {
        "title": "VAT rates",
        "public_updated_at": "2014-12-12T14:55:23Z",
        "document_type": "answer",
        "schema_name": "answer",
        "base_path": "/vat-rates",
        "description": "Current VAT rates - standard 20% and rates for reduced rate and zero-rated items",
        "api_path": "/api/content/vat-rates",
        "withdrawn": false,
        "content_id": "f838c22a-b2aa-49be-bd95-153f593293a3",
        "locale": "en",
        "api_url": "https://www.gov.uk/api/content/vat-rates",
        "web_url": "https://www.gov.uk/vat-rates",
        "links": {}
      }
    ]
  },
  "description": "Current VAT rates - standard 20% and rates for reduced rate and zero-rated items",
  "details": {
    "body": "\n<div class=\"highlight-answer\">\n<p>The standard <abbr title=\"Value Added Tax\">VAT</abbr> rate is <em>20%</em></p>\n</div>\n\n<h2 id=\"vat-rates-for-goods-and-services\">\n<abbr title=\"Value Added Tax\">VAT</abbr> rates for goods and services</h2>\n\n<table>\n  <thead>\n    <tr>\n      <th>Rate</th>\n      <th>% of <abbr title=\"Value Added Tax\">VAT</abbr>\n</th>\n      <th>What the rate applies to</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Standard</td>\n      <td>20%</td>\n      <td>Most goods and services</td>\n    </tr>\n    <tr>\n      <td>Reduced rate</td>\n      <td>5%</td>\n      <td>Some goods and services, eg children’s car seats and home energy</td>\n    </tr>\n    <tr>\n      <td>Zero rate</td>\n      <td>0%</td>\n      <td>Zero-rated goods and services, eg most food and children’s clothes</td>\n    </tr>\n  </tbody>\n</table>\n\n<p>The standard rate of <abbr title=\"Value Added Tax\">VAT</abbr> increased to 20% on 4 January 2011 (from 17.5%).</p>\n\n<p>Some things are exempt from <abbr title=\"Value Added Tax\">VAT</abbr>, eg postage stamps, financial and property transactions.</p>\n\n<p>The <a href=\"/vat-businesses/vat-rates\"><abbr title=\"Value Added Tax\">VAT</abbr> rate businesses charge</a> depends on their goods and services.</p>\n\n<p>Check the <a href=\"https://www.gov.uk/rates-of-vat-on-different-goods-and-services\">rates of <abbr title=\"Value Added Tax\">VAT</abbr></a> on different goods and services.</p>\n\n"
  }
}

Fields

Name Type Required Description
analytics_identifier integer false An identifier which clients of the Publishing API can include with an edition for later use in analytics software.
base_path string true The path of the content on GOV.UK - or the shortest one for content that spans multiple sub paths. Learn more.
content_id string(uuid) false A UUID which represents the public identifier for a piece of content, combined with locale this makes the unique identifier for an individual piece of content. Can be null for redirects / gone content.
description string false A description of the content which can then be displayed publically.
details object false An object representing data that is structured in a format defined by the schema of the edition. This holds the content for the edition, often in a field called body. Can be null for items without content - for example, a redirect. Learn more.
document_type string true A particular type of document, used to differentiate between documents that are of different types but share the same schema. Learn more.
email_document_supertype string true High level group for email subscriptions used to identify publications and announcement.
first_published_at string(date-time) true Can be set by publishing application, otherwise set automatically in Publishing API on first publish and copied on subsequent ones.
government_document_supertype string true Grouping for email subscriptions.
links object true An object that has collections of LinkedContentItems objects in arrays, which are grouped by a link type.
locale string false The language the document is written in. A fixed list of locales is allowed.
navigation_document_supertype string true Used to filter pages on the new taxonomy-based navigation pages.
phase string true The “phase” of an edition can either be alpha, beta or live.
public_updated_at string(date-time) true Can be set by publishing application, otherwise set automatically in Publishing API each time an edition is published with a major edition.
publishing_app string true The application which published the edition.
publishing_request_id string false The GOV.UK Request ID which was used when the content item was published.
rendering_app string false The application which will be used to render the content of the edition.
schema_name string true The name of the GOV.UK content schema that the request body will be validated against. Learn more.
title string false The title of the edition, displayed to the user.
updated_at string(date-time) true Current date time every time the content item changes, which could be an update to one of the dependent links.
user_journey_document_supertype string true Used to distinguish pages used mainly for navigation (finding) from content pages (thing).
withdrawn_notice object false A WithdrawnNotice is an object that can be embedded within a ContentItem and is used to explain the reason a piece of content has been withdrawn. Learn more.
need_ids [string] false An array of need IDs from Maslow.

LinkedContentItem

A LinkedContentItem is an abridged form of ContentItem which is used to represent links between ContentItems. It is embedded within the links field that is used within ContentItem and LinkedContentItem. Learn more.

Sample JSON

{
  "api_path": "/api/content/browse/tax/vat",
  "base_path": "/browse/tax/vat",
  "content_id": "895d337a-fa68-4c83-ab79-1c08016afe87",
  "description": "Includes online returns, rates, charging and record keeping",
  "document_type": "mainstream_browse_page",
  "locale": "en",
  "public_updated_at": "2015-06-24T13:56:39Z",
  "schema_name": "mainstream_browse_page",
  "title": "VAT",
  "withdrawn": false,
  "links": {},
  "api_url": "https://www.gov.uk/api/content/browse/tax/vat",
  "web_url": "https://www.gov.uk/browse/tax/vat"
}

Fields

Name Type Required Description
analytics_identifier integer true An identifier which clients of the Publishing API can include with an edition for later use in analytics software.
api_path string true The base path of the content item, available from the API.
base_path string true The path of the content on GOV.UK - or the shortest one for content that spans multiple sub paths.
content_id string(uuid) true A UUID which represents the public identifier for a piece of content, combined with locale this makes the unique identifier for an individual piece of content. Can be null for redirects / gone content.
description string true A description of the content which can then be displayed publically.
details object false An object representing data that is structured in a format defined by the schema of the edition. This holds the content for the edition, often in a field called body. Can be null for items without content - for example, a redirect.
document_type string true A particular type of document, used to differentiate between documents that are of different types but share the same schema.
links object true An object that has collections of LinkedContentItems objects in arrays, which are grouped by a link type.
locale string true The language the document is written in. A fixed list of locales is allowed.
public_updated_at string(date-time) true Can be set by publishing application, otherwise set automatically in Publishing API each time an edition is published with a major edition.
schema_name string true The name of the GOV.UK content schema that the request body will be validated against.
title string true The title of the edition, displayed to the user.
withdrawn boolean true Holds whether or not the content has been withdrawn.

WithdrawnNotice

A WithdrawnNotice is an object that can be embedded within a ContentItem and is used to explain the reason a piece of content has been withdrawn. Learn more.

Sample JSON

{
  "explanation": "<div class=\"govspeak\"><p>This guidance has been withdrawn from use because the Environment Agency no longer provides best practice guidance. See guidance on <a href=\"https://www.gov.uk/guidance/prevent-the-spread-of-harmful-invasive-and-non-native-plants\">preventing harmful weeds and invasive non-native plants spreading weeds</a> for information on controlling specific plants.</p>\n</div>",
  "withdrawn_at": "2016-07-11T15:08:02Z"
}

Fields

Name Type Required Description
explanation string true An explanation as to why the content was withdrawn.
withdrawn_at string(date-time) true The date when the content was withdrawn.