---
type: "firecrawl-provider"
description: "GOV.UK (www.gov.uk), the UK government's website: site-wide search with document type, supergroup, organisation, person, location, topic and date filters (or a pasted GOV.UK finder URL), any page as Markdown with its dates, change notes, organisations, guide parts, attachments, collection documents, manual sections and travel advice status, HMRC internal manuals and other manuals with their sections and update notes, the OPSS product safety alerts, reports and recalls, and the list of government organisations. From the public GOV.UK Search, Content and Organisations APIs; content under the Open Government Licence v3.0."
use_when: "GOV.UK (www.gov.uk), the UK government's website: site-wide search with document type, supergroup, organisation, person, location, topic and date filters (or a pasted GOV.UK finder URL), any page as Markdown with its dates, change notes, organisations, guide parts, attachments, collection documents, manual sections and travel advice status, HMRC internal manuals and other manuals with their sections and update notes, the OPSS product safety alerts, reports and recalls, and the list of government organisations. From the public GOV.UK Search, Content and Organisations APIs; content under the Open Government Licence v3.0."
categories: "Public records"
capabilities: 5
credits_per_call: 5
---
# GOV.UK on Firecrawl Alexandria

GOV.UK (www.gov.uk), the UK government's website: site-wide search with document type, supergroup, organisation, person, location, topic and date filters (or a pasted GOV.UK finder URL), any page as Markdown with its dates, change notes, organisations, guide parts, attachments, collection documents, manual sections and travel advice status, HMRC internal manuals and other manuals with their sections and update notes, the OPSS product safety alerts, reports and recalls, and the list of government organisations. From the public GOV.UK Search, Content and Organisations APIs; content under the Open Government Licence v3.0.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `gov-uk`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/gov-uk)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/gov-uk/openapi.json)

## Capabilities

- [Get manual](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/get_manual): One GOV.UK manual from the Content API (GET /api/content/{manual}): HMRC internal manuals (/hmrc-internal-manuals/<slug>, e.g. inheritance-tax-manual, capital-gains-manual) and other manuals (/guidance/<slug>, e.g. tax-agents-handbook, immigration-rules). Returns title, summary, dates, organisations, body (for guidance manuals), the section groups with every child section (section id, title, path) and the manual's update notes (the /updates page: section, change note, date), newest first, paged through next_cursor. Accepts the manual, any of its section paths or its /updates URL.
- [Get page](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/get_page): One www.gov.uk page from the GOV.UK Content API (GET /api/content/{path}): title, description, document type, schema, first published and last updated dates, the latest change note and change history, withdrawal notice, organisations, the full body as clean Markdown (tables, lists, links, collapsed details sections and transcripts included, since the API serves the complete HTML), its links, attachments (title, URL, content type, size, pages; consultation documents and final outcome PDFs marked), consultation dates, specialist metadata, product information rows for product safety notices, a collection's groups and documents, a manual section's breadcrumbs and child sections, and foreign travel advice alert status and latest update. Multi-part guides and travel advice list their parts and return one. Redirected paths are followed; removed and unknown pages are not_found.
- [List organisations](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/list_organisations): Every organisation on GOV.UK (ministerial departments, agencies, public bodies, courts, including closed ones) from the GOV.UK Organisations API (GET /api/organisations?page=N), 20 per page: slug, title, acronym, format, status (live, closed, exempt, ...), closed status, URL, content id, updated date and the slugs of parent, child and superseding organisations. Page through with next_cursor.
- [List product safety alerts](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/list_product_safety_alerts): Product safety alerts, reports and recalls from the Office for Product Safety and Standards (OPSS) on GOV.UK, newest first: the GOV.UK Search API filtered to document type product_safety_alert_report_recall (the finder at www.gov.uk/product-safety-alerts-reports-recalls). Each notice: title, reference (the PSD notification number such as 2609-0213, or PSA9, from the title), path, url, description, alert type (product-recall, product-safety-report, product-safety-alert), risk level (serious, high, medium, low, not-provided), product category, corrective measures, the alert date and the publication timestamp. Filter by words, alert type, risk level, category and alert date range. get_page on a path returns the full notice with its product information table (brand, model, barcodes, batch numbers), hazard, corrective action and the product image PDF.
- [Search](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/search): Full-text search over www.gov.uk with the official GOV.UK Search API (GET /api/search.json): guidance, consultations and their outcomes, publications, news, speeches, statistics, product safety notices and every other GOV.UK format. Filters: document type (content_store_document_type), content purpose supergroup (the finder groupings), organisation, person, world location, topical event and topic taxon slugs, and a public timestamp range. Accepts a pasted GOV.UK finder URL (search/all, news-and-communications, guidance-and-regulation, policy-papers-and-consultations, research-and-statistics, transparency-and-freedom-of-information-releases, services, .atom feeds too) and maps its query to the same filters. Order by relevance (needs q), newest, oldest or most viewed. Each result: title, path, url, description, document type, public timestamp and organisations. Offset pagination through next_cursor replaces finder paging and scrolling. For monitoring, order newest with a from date lists everything changed since then.

## 1. Choose this provider when

GOV.UK (www.gov.uk), the UK government's website: site-wide search with document type, supergroup, organisation, person, location, topic and date filters (or a pasted GOV.UK finder URL), any page as Markdown with its dates, change notes, organisations, guide parts, attachments, collection documents, manual sections and travel advice status, HMRC internal manuals and other manuals with their sections and update notes, the OPSS product safety alerts, reports and recalls, and the list of government organisations. From the public GOV.UK Search, Content and Organisations APIs; content under the Open Government Licence v3.0.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "gov-uk",
  "capability": "government-publications/get_manual",
  "options": {
    "limit": 5,
    "path": "/hmrc-internal-manuals/inheritance-tax-manual"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `cursor` (string): next_cursor from an earlier call (a result offset). Pattern: ^[0-9]+$. Example: `<cursor>`
- `limit` (number): Change notes per page, 1 to 100 (default 20). Example: `10`
- `path` (string): Manual path or slug, e.g. /hmrc-internal-manuals/inheritance-tax-manual, inheritance-tax-manual (an HMRC manual slug) or /guidance/tax-agents-handbook; a section path selects its manual. Pattern: ^/?[A-Za-z0-9]. Example: `<path>`
- `url` (string): Alternatively a www.gov.uk manual, section or /updates URL. Pattern: ^https?://. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "gov-uk",
    capability: "government-publications/get_manual",
    options: {
      limit: 5,
      path: "/hmrc-internal-manuals/inheritance-tax-manual",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "gov-uk",
  "capability": "government-publications/get_manual",
  "options": {
    "limit": 5,
    "path": "/hmrc-internal-manuals/inheritance-tax-manual"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "gov-uk",
    "capability": "government-publications/get_manual",
    "options": {
      "limit": 5,
      "path": "/hmrc-internal-manuals/inheritance-tax-manual"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'gov-uk/government-publications/get_manual' \
  --options '{"limit":5,"path":"/hmrc-internal-manuals/inheritance-tax-manual"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "gov-uk",
  "capability": "government-publications/get_manual",
  "options": {
    "limit": 5,
    "path": "/hmrc-internal-manuals/inheritance-tax-manual"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "gov-uk",
  "capability": "government-publications/get_manual",
  "options": {
    "limit": 5,
    "path": "/hmrc-internal-manuals/inheritance-tax-manual"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "api_url": "https://www.gov.uk/api/content/hmrc-internal-manuals/inheritance-tax-manual",
  "body_markdown": null,
  "change_notes": [
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04313",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM04313",
      "title": "Para 3 & 4/Schedule A1/IHTA84 relevant loan examples",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04313"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04314",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM04314",
      "title": "Finance (No 2) Act 2017: disposals of company interests, partnership interests, relevant loans and repayments of relevant loans",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04314"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04317",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM04317",
      "title": "Para 20/Schedule 12/Finance Bill 2026: commencement provisions",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04317"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of charities changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm11141",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM11141",
      "title": "Community Amateur Sports Clubs: the location condition",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm11141"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm14626",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM14626",
      "title": "Lifetime transfers: specific lifetime reliefs: fall in value relief: what is market value?",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm14626"
    }
  ],
  "description": "Guidance on the assessment, collection and accounting of Inheritance Tax.",
  "document_type": "hmrc_manual",
  "first_published_at": "2016-03-20T09:11:30+00:00",
  "licence": "Open Government Licence v3.0 (most GOV.UK content; a page names any exception): https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
  "next_cursor": "5",
  "observed_at_ms": 1792696055013,
  "organisations": [
    {
      "acronym": "HMRC",
      "slug": "hm-revenue-customs",
      "title": "HM Revenue & Customs",
      "url": "https://www.gov.uk/government/organisations/hm-revenue-customs"
    }
  ],
  "path": "/hmrc-internal-manuals/inheritance-tax-manual",
  "public_updated_at": "2026-04-07T01:00:00+01:00",
  "section_groups": [
    {
      "sections": [
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm01000",
          "section_id": "IHTM01000",
          "title": "Inheritance Tax in HMRC: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm01000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm02000",
          "section_id": "IHTM02000",
          "title": "Communications: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm02000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm03000",
          "section_id": "IHTM03000",
          "title": "Files: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm03000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04000",
          "section_id": "IHTM04000",
          "title": "How Inheritance Tax is charged: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm05000",
          "section_id": "IHTM05000",
          "title": "What happens when someone dies?: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm05000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm06000",
          "section_id": "IHTM06000",
          "title": "Delivery of accounts - excepted estates, transfers and settlements: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm06000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm09000",
          "section_id": "IHTM09000",
          "title": "Investigating accounts and principles of valuation: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm09000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm10000",
          "section_id": "IHTM10000",
          "title": "IHT accounts and accountability: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm10000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm11000",
          "section_id": "IHTM11000",
          "title": "Exemptions: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm11000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm12000",
          "section_id": "IHTM12000",
          "title": "Succession: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm12000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm13000",
          "section_id": "IHTM13000",
          "title": "Domicile: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm13000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm14000",
          "section_id": "IHTM14000",
          "title": "Lifetime transfers: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm14000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm15000",
          "section_id": "IHTM15000",
          "title": "Joint property and nominated property: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm15000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm16000",
          "section_id": "IHTM16000",
          "title": "Settled property: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm16000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm17000",
          "section_id": "IHTM17000",
          "title": "Pensions: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm17000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm18000",
          "section_id": "IHTM18000",
          "title": "Stocks and shares: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm18000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm19000",
          "section_id": "IHTM19000",
          "title": "Capital debts due to the estate: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm19000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm20000",
          "section_id": "IHTM20000",
          "title": "Life Policies: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm20000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm21000",
          "section_id": "IHTM21000",
          "title": "Household goods and personal effects: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm21000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm22000",
          "section_id": "IHTM22000",
          "title": "Interest in unadministered estates and QSR: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm22000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm23000",
          "section_id": "IHTM23000",
          "title": "Land and Buildings: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm23000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm24000",
          "section_id": "IHTM24000",
          "title": "Agricultural relief: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm24000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm25000",
          "section_id": "IHTM25000",
          "title": "Business relief and businesses: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm25000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm26000",
          "section_id": "IHTM26000",
          "title": "Calculating the chargeable estate: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm26000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm27000",
          "section_id": "IHTM27000",
          "title": "Foreign property: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm27000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm28000",
          "section_id": "IHTM28000",
          "title": "Liabilities: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm28000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm29000",
          "section_id": "IHTM29000",
          "title": "Enquiry procedures and yield: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm29000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm30000",
          "section_id": "IHTM30000",
          "title": "Liability and payment of tax: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm30000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm31000",
          "section_id": "IHTM31000",
          "title": "Assessing: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm31000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm32000",
          "section_id": "IHTM32000",
          "title": "Progressing files: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm32000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm33000",
          "section_id": "IHTM33000",
          "title": "Loss on sale of land: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm33000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm34000",
          "section_id": "IHTM34000",
          "title": "Loss on sale of shares: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm34000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm35000",
          "section_id": "IHTM35000",
          "title": "Alterations to the devolution of an estate: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm35000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm36000",
          "section_id": "IHTM36000",
          "title": "Penalties: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm36000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm37000",
          "section_id": "IHTM37000",
          "title": "Notices of determination: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm37000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm40000",
          "section_id": "IHTM40000",
          "title": "Clearance certificates: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm40000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm42000",
          "section_id": "IHTM42000",
          "title": "Relevant property trusts: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm42000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm43000",
          "section_id": "IHTM43000",
          "title": "Transferable nil rate band: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm43000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm44000",
          "section_id": "IHTM44000",
          "title": "Pre-owned assets: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm44000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm45000",
          "section_id": "IHTM45000",
          "title": "Reduced rate for charitable gifts: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm45000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm46000",
          "section_id": "IHTM46000",
          "title": "Residence nil rate band: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm46000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm47000",
          "section_id": "IHTM47000",
          "title": "Long-term UK residence: Contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm47000"
        }
      ],
      "title": null
    },
    {
      "sections": [],
      "title": "Updates"
    },
    {
      "sections": [],
      "title": null
    }
  ],
  "title": "Inheritance Tax Manual",
  "total_change_notes": 1460,
  "updates_url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/updates",
  "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get manual

- Capability: `government-publications/get_manual`
- Description: One GOV.UK manual from the Content API (GET /api/content/{manual}): HMRC internal manuals (/hmrc-internal-manuals/<slug>, e.g. inheritance-tax-manual, capital-gains-manual) and other manuals (/guidance/<slug>, e.g. tax-agents-handbook, immigration-rules). Returns title, summary, dates, organisations, body (for guidance manuals), the section groups with every child section (section id, title, path) and the manual's update notes (the /updates page: section, change note, date), newest first, paged through next_cursor. Accepts the manual, any of its section paths or its /updates URL.
- Instructions: To browse an HMRC internal manual or a guidance manual's contents, find the section to read with get_page, or see what changed in a manual recently.
- Cost: 5 credits per call
- Capability file: [Get manual](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/get_manual)

Accepted options:
- `cursor` (string): next_cursor from an earlier call (a result offset). Pattern: ^[0-9]+$. Example: `<cursor>`
- `limit` (number): Change notes per page, 1 to 100 (default 20). Example: `10`
- `path` (string): Manual path or slug, e.g. /hmrc-internal-manuals/inheritance-tax-manual, inheritance-tax-manual (an HMRC manual slug) or /guidance/tax-agents-handbook; a section path selects its manual. Pattern: ^/?[A-Za-z0-9]. Example: `<path>`
- `url` (string): Alternatively a www.gov.uk manual, section or /updates URL. Pattern: ^https?://. Example: `<url>`

Response schema example:
```json
{
  "api_url": "https://www.gov.uk/api/content/hmrc-internal-manuals/inheritance-tax-manual",
  "body_markdown": null,
  "change_notes": [
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04313",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM04313",
      "title": "Para 3 & 4/Schedule A1/IHTA84 relevant loan examples",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04313"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04314",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM04314",
      "title": "Finance (No 2) Act 2017: disposals of company interests, partnership interests, relevant loans and repayments of relevant loans",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04314"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04317",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM04317",
      "title": "Para 20/Schedule 12/Finance Bill 2026: commencement provisions",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04317"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of charities changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm11141",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM11141",
      "title": "Community Amateur Sports Clubs: the location condition",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm11141"
    },
    {
      "change_note": "Revising guidance within the IHT manual in advance of APR/BPR changes after 7th April 2026",
      "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm14626",
      "published_at": "2026-04-07T00:00:00Z",
      "section_id": "IHTM14626",
      "title": "Lifetime transfers: specific lifetime reliefs: fall in value relief: what is market value?",
      "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm14626"
    }
  ],
  "description": "Guidance on the assessment, collection and accounting of Inheritance Tax.",
  "document_type": "hmrc_manual",
  "first_published_at": "2016-03-20T09:11:30+00:00",
  "licence": "Open Government Licence v3.0 (most GOV.UK content; a page names any exception): https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
  "next_cursor": "5",
  "observed_at_ms": 1792696055013,
  "organisations": [
    {
      "acronym": "HMRC",
      "slug": "hm-revenue-customs",
      "title": "HM Revenue & Customs",
      "url": "https://www.gov.uk/government/organisations/hm-revenue-customs"
    }
  ],
  "path": "/hmrc-internal-manuals/inheritance-tax-manual",
  "public_updated_at": "2026-04-07T01:00:00+01:00",
  "section_groups": [
    {
      "sections": [
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm01000",
          "section_id": "IHTM01000",
          "title": "Inheritance Tax in HMRC: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm01000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm02000",
          "section_id": "IHTM02000",
          "title": "Communications: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm02000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm03000",
          "section_id": "IHTM03000",
          "title": "Files: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm03000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm04000",
          "section_id": "IHTM04000",
          "title": "How Inheritance Tax is charged: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm04000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm05000",
          "section_id": "IHTM05000",
          "title": "What happens when someone dies?: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm05000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm06000",
          "section_id": "IHTM06000",
          "title": "Delivery of accounts - excepted estates, transfers and settlements: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm06000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm09000",
          "section_id": "IHTM09000",
          "title": "Investigating accounts and principles of valuation: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm09000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm10000",
          "section_id": "IHTM10000",
          "title": "IHT accounts and accountability: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm10000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm11000",
          "section_id": "IHTM11000",
          "title": "Exemptions: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm11000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm12000",
          "section_id": "IHTM12000",
          "title": "Succession: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm12000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm13000",
          "section_id": "IHTM13000",
          "title": "Domicile: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm13000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm14000",
          "section_id": "IHTM14000",
          "title": "Lifetime transfers: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm14000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm15000",
          "section_id": "IHTM15000",
          "title": "Joint property and nominated property: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm15000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm16000",
          "section_id": "IHTM16000",
          "title": "Settled property: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm16000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm17000",
          "section_id": "IHTM17000",
          "title": "Pensions: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm17000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm18000",
          "section_id": "IHTM18000",
          "title": "Stocks and shares: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm18000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm19000",
          "section_id": "IHTM19000",
          "title": "Capital debts due to the estate: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm19000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm20000",
          "section_id": "IHTM20000",
          "title": "Life Policies: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm20000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm21000",
          "section_id": "IHTM21000",
          "title": "Household goods and personal effects: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm21000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm22000",
          "section_id": "IHTM22000",
          "title": "Interest in unadministered estates and QSR: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm22000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm23000",
          "section_id": "IHTM23000",
          "title": "Land and Buildings: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm23000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm24000",
          "section_id": "IHTM24000",
          "title": "Agricultural relief: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm24000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm25000",
          "section_id": "IHTM25000",
          "title": "Business relief and businesses: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm25000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm26000",
          "section_id": "IHTM26000",
          "title": "Calculating the chargeable estate: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm26000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm27000",
          "section_id": "IHTM27000",
          "title": "Foreign property: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm27000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm28000",
          "section_id": "IHTM28000",
          "title": "Liabilities: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm28000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm29000",
          "section_id": "IHTM29000",
          "title": "Enquiry procedures and yield: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm29000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm30000",
          "section_id": "IHTM30000",
          "title": "Liability and payment of tax: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm30000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm31000",
          "section_id": "IHTM31000",
          "title": "Assessing: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm31000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm32000",
          "section_id": "IHTM32000",
          "title": "Progressing files: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm32000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm33000",
          "section_id": "IHTM33000",
          "title": "Loss on sale of land: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm33000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm34000",
          "section_id": "IHTM34000",
          "title": "Loss on sale of shares: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm34000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm35000",
          "section_id": "IHTM35000",
          "title": "Alterations to the devolution of an estate: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm35000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm36000",
          "section_id": "IHTM36000",
          "title": "Penalties: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm36000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm37000",
          "section_id": "IHTM37000",
          "title": "Notices of determination: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm37000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm40000",
          "section_id": "IHTM40000",
          "title": "Clearance certificates: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm40000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm42000",
          "section_id": "IHTM42000",
          "title": "Relevant property trusts: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm42000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm43000",
          "section_id": "IHTM43000",
          "title": "Transferable nil rate band: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm43000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm44000",
          "section_id": "IHTM44000",
          "title": "Pre-owned assets: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm44000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm45000",
          "section_id": "IHTM45000",
          "title": "Reduced rate for charitable gifts: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm45000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm46000",
          "section_id": "IHTM46000",
          "title": "Residence nil rate band: contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm46000"
        },
        {
          "description": null,
          "path": "/hmrc-internal-manuals/inheritance-tax-manual/ihtm47000",
          "section_id": "IHTM47000",
          "title": "Long-term UK residence: Contents",
          "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/ihtm47000"
        }
      ],
      "title": null
    },
    {
      "sections": [],
      "title": "Updates"
    },
    {
      "sections": [],
      "title": null
    }
  ],
  "title": "Inheritance Tax Manual",
  "total_change_notes": 1460,
  "updates_url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual/updates",
  "url": "https://www.gov.uk/hmrc-internal-manuals/inheritance-tax-manual"
}
```

### Get page

- Capability: `government-publications/get_page`
- Description: One www.gov.uk page from the GOV.UK Content API (GET /api/content/{path}): title, description, document type, schema, first published and last updated dates, the latest change note and change history, withdrawal notice, organisations, the full body as clean Markdown (tables, lists, links, collapsed details sections and transcripts included, since the API serves the complete HTML), its links, attachments (title, URL, content type, size, pages; consultation documents and final outcome PDFs marked), consultation dates, specialist metadata, product information rows for product safety notices, a collection's groups and documents, a manual section's breadcrumbs and child sections, and foreign travel advice alert status and latest update. Multi-part guides and travel advice list their parts and return one. Redirected paths are followed; removed and unknown pages are not_found.
- Instructions: To read an official GOV.UK page verbatim with its dates and documents: a publication or consultation and its PDFs, a collection's document list, an HMRC manual section, foreign travel advice for a country, a recall notice, a guide part such as Universal Credit eligibility, a news story or speech; or to check public_updated_at and the latest change note when monitoring a page.
- Cost: 5 credits per call
- Capability file: [Get page](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/get_page)

Accepted options:
- `max_chars` (number): Truncate body_markdown to this many characters (default 20000). Example: `500`
- `part` (string): Guide part slug, e.g. eligibility. Overrides a part in the path. Unknown parts are not_found. Example: `<part>`
- `path` (string): GOV.UK path, e.g. /government/consultations/gas-system-in-transition-security-of-supply or /universal-credit/eligibility (a guide part). search and list_product_safety_alerts return paths. Pattern: ^/?[A-Za-z0-9]. Example: `<path>`
- `url` (string): Alternatively a www.gov.uk page URL; a guide part URL selects that part. Pattern: ^https?://. Example: `<url>`

Response schema example:
```json
{
  "api_url": "https://www.gov.uk/api/content/government/consultations/gas-system-in-transition-security-of-supply",
  "attachments": [
    {
      "attachment_type": "file",
      "command_paper_number": null,
      "content_type": "application/pdf",
      "file_size": 1517845,
      "filename": "gas-security-of-supply-consultation-document.pdf",
      "id": "9456617",
      "isbn": null,
      "number_of_pages": 64,
      "role": "featured",
      "title": "Gas system in transition: security of supply - consultation document",
      "url": "https://assets.publishing.service.gov.uk/media/69440cf49273c48f554cf5ed/gas-security-of-supply-consultation-document.pdf"
    },
    {
      "attachment_type": "file",
      "command_paper_number": null,
      "content_type": "application/pdf",
      "file_size": 187495,
      "filename": "gas-security-of-supply-technical-annex.pdf",
      "id": "9456618",
      "isbn": null,
      "number_of_pages": 4,
      "role": "featured",
      "title": "Gas system in transition: security of supply - technical annex",
      "url": "https://assets.publishing.service.gov.uk/media/692597a933d088f6d5da2cdf/gas-security-of-supply-technical-annex.pdf"
    },
    {
      "attachment_type": "file",
      "command_paper_number": null,
      "content_type": "application/pdf",
      "file_size": 361078,
      "filename": "gas-system-in-transition-security-of-supply-interim-response.pdf",
      "id": "9456621",
      "isbn": null,
      "number_of_pages": 18,
      "role": "final_outcome",
      "title": "Gas system in transition: security of supply - interim response",
      "url": "https://assets.publishing.service.gov.uk/media/6a83250792ec93e1e0329ab1/gas-system-in-transition-security-of-supply-interim-response.pdf"
    }
  ],
  "body_chars": 2869,
  "body_markdown": "This consultation is inviting views and supporting evidence on our assessment of the priorities for gas security of supply during the transition, and the associated challenges facing the gas sector. It sets out a range of proposed policy actions that we are considering in order to protect our gas security in the years ahead.\n\nWe committed to a programme of public engagement on the gas system’s transition in the [June 2025 update to market](https://www.gov.uk/government/publications/midstream-gas-system-update-to-the-market/midstream-gas-system-update-to-the-market). This consultation is the first step in this programme of work.\n\nThis represents a significant milestone in our commitment to shape a gas system that provides energy security for decades to come. It covers:\n\n- our understanding of the changing patterns of gas supply and demand and how we expect these to evolve during the energy transition, including the continuing need for peak-day capacity\n- our three-point plan for gas security of supply, which includes:\n  1. accelerating decarbonisation to secure energy for the long term\n  2. taking the necessary steps to ensure the gas system and market can adapt to continue providing baseload gas supply and insurance for low probability, high stress events\n  3. continuing to work with National Gas and NESO to monitor our security of supply and utilising the range of tools available to continue to match supply and demand, to balance the system on a daily basis now and for years to come\n- our three priorities to ensure the gas system and market can adapt to provide supply in a range of scenarios:\n  1. maintaining sufficient infrastructure capacity\n  2. maintaining sufficient infrastructure resilience\n  3. a commercial model that supports effective infrastructure operation\n- the current picture of our midstream gas infrastructure (LNG, interconnectors, storage) and a range of government policy actions that could be taken to ensure we have sufficient infrastructure to provide gas whenever and wherever it is needed\n- further government policy actions designed to ensure a commercial model that works, both in terms of ensuring the commercial viability of existing infrastructure operators and exploring how regulatory and market-based changes could support the UK’s continued attractiveness to land gas imports\n\nThe territorial extent of this consultation is Great Britain only given energy policy is devolved to Northern Ireland and they have an independently operated gas system. However, given Northern Ireland’s reliance on gas supplies from Great Britain, we are committed to working closely with them on the issues outlined in this consultation.\n\nRead our [consultation privacy notice](https://www.gov.uk/government/publications/desnz-consultations-privacy-notice/privacy-notice-relating-to-consultation-responses-received-by-desnz).",
  "body_truncated": false,
  "change_history": [
    {
      "at": "2026-08-18T09:00:01Z",
      "note": "Published the interim response to this consultation."
    },
    {
      "at": "2025-11-26T13:40:00Z",
      "note": "First published."
    }
  ],
  "collection_groups": null,
  "consultation": {
    "closing_date": "2026-02-18T23:59:00.000+00:00",
    "opening_date": "2025-11-26T13:30:00.000+00:00",
    "outcome_published_at": "2026-08-18T00:00:00+00:00"
  },
  "content_id": "c068588e-7b73-4f60-997a-2841a0fc3d1d",
  "description": "We are seeking views on our assessment of GB’s long-term supply of gas, and proposed policy actions to protect our gas and energy security during the transition.",
  "document_type": "consultation_outcome",
  "first_published_at": "2025-11-26T13:40:46+00:00",
  "latest_change_note": {
    "at": "2026-08-18T09:00:01Z",
    "note": "Published the interim response to this consultation."
  },
  "licence": "Open Government Licence v3.0 (most GOV.UK content; a page names any exception): https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
  "links": [
    {
      "text": "June 2025 update to market",
      "url": "https://www.gov.uk/government/publications/midstream-gas-system-update-to-the-market/midstream-gas-system-update-to-the-market"
    },
    {
      "text": "consultation privacy notice",
      "url": "https://www.gov.uk/government/publications/desnz-consultations-privacy-notice/privacy-notice-relating-to-consultation-responses-received-by-desnz"
    }
  ],
  "locale": "en",
  "manual": null,
  "metadata": null,
  "observed_at_ms": 1792696043838,
  "organisations": [
    {
      "acronym": "DESNZ",
      "slug": "department-for-energy-security-and-net-zero",
      "title": "Department for Energy Security and Net Zero",
      "url": "https://www.gov.uk/government/organisations/department-for-energy-security-and-net-zero"
    }
  ],
  "part": null,
  "parts": [],
  "path": "/government/consultations/gas-system-in-transition-security-of-supply",
  "product_information": null,
  "public_updated_at": "2026-08-18T10:00:01+01:00",
  "redirected_from": null,
  "requested_path": "/government/consultations/gas-system-in-transition-security-of-supply",
  "schema_name": "consultation",
  "section_groups": [],
  "title": "Gas system in transition: security of supply",
  "travel_advice": null,
  "url": "https://www.gov.uk/government/consultations/gas-system-in-transition-security-of-supply",
  "withdrawn": null
}
```

### List organisations

- Capability: `government-publications/list_organisations`
- Description: Every organisation on GOV.UK (ministerial departments, agencies, public bodies, courts, including closed ones) from the GOV.UK Organisations API (GET /api/organisations?page=N), 20 per page: slug, title, acronym, format, status (live, closed, exempt, ...), closed status, URL, content id, updated date and the slugs of parent, child and superseding organisations. Page through with next_cursor.
- Instructions: To find an organisation's slug for search's organisation filter, or to see which body superseded a closed one.
- Cost: 5 credits per call
- Capability file: [List organisations](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/list_organisations)

Accepted options:
- `cursor` (string): Page number (next_cursor from an earlier call); default 1. Pattern: ^[1-9][0-9]{0,4}$. Example: `<cursor>`

Response schema example:
```json
{
  "count": 20,
  "licence": "Open Government Licence v3.0 (most GOV.UK content; a page names any exception): https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
  "next_cursor": "2",
  "observed_at_ms": 1792696063692,
  "organisations": [
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": "changed_name",
      "content_id": "4dfe21ee-acfa-4fc1-9513-cc764e814205",
      "format": "Other",
      "parent_slugs": [],
      "slug": "academy-for-justice-commissioning",
      "status": "closed",
      "superseding_slugs": [
        "academy-for-social-justice-commissioning"
      ],
      "title": "Academy for Justice Commissioning",
      "updated_at": "2025-07-30T14:24:11Z",
      "url": "https://www.gov.uk/government/organisations/academy-for-justice-commissioning"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": null,
      "content_id": "b854f170-53c8-4098-bf77-e8ef42f93107",
      "format": "Other",
      "parent_slugs": [
        "ministry-of-justice"
      ],
      "slug": "academy-for-social-justice",
      "status": "live",
      "superseding_slugs": [],
      "title": "Academy for Social Justice",
      "updated_at": "2024-08-29T13:57:07Z",
      "url": "https://www.gov.uk/government/organisations/academy-for-social-justice"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": "changed_name",
      "content_id": "ce357bdb-6396-426a-9f1f-8cbfb444cffd",
      "format": "Other",
      "parent_slugs": [],
      "slug": "academy-for-social-justice-commissioning",
      "status": "closed",
      "superseding_slugs": [
        "academy-for-social-justice"
      ],
      "title": "Academy for Social Justice Commissioning",
      "updated_at": "2025-07-30T14:24:11Z",
      "url": "https://www.gov.uk/government/organisations/academy-for-social-justice-commissioning"
    },
    {
      "acronym": "AAR",
      "child_slugs": [],
      "closed_status": "no_longer_exists",
      "content_id": "a0f338c5-e94c-42f8-9c26-b9c2eb6850d3",
      "format": "Other",
      "parent_slugs": [
        "department-of-health-and-social-care"
      ],
      "slug": "accelerated-access-review",
      "status": "closed",
      "superseding_slugs": [],
      "title": "Accelerated Access Review",
      "updated_at": "2022-03-08T13:31:13Z",
      "url": "https://www.gov.uk/government/organisations/accelerated-access-review"
    },
    {
      "acronym": "ACE",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "92bbe2da-8d5f-480b-8da1-50b18e317654",
      "format": "Sub organisation",
      "parent_slugs": [
        "home-office"
      ],
      "slug": "accelerated-capability-environment",
      "status": "live",
      "superseding_slugs": [],
      "title": "Accelerated Capability Environment",
      "updated_at": "2026-08-20T12:27:40Z",
      "url": "https://www.gov.uk/government/organisations/accelerated-capability-environment"
    },
    {
      "acronym": "ATE",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "c963b443-e0b1-4730-8c7e-526441fcd205",
      "format": "Executive agency",
      "parent_slugs": [
        "department-for-transport"
      ],
      "slug": "active-travel-england",
      "status": "exempt",
      "superseding_slugs": [],
      "title": "Active Travel England",
      "updated_at": "2024-10-03T12:15:30Z",
      "url": "https://www.gov.uk/government/organisations/active-travel-england"
    },
    {
      "acronym": "ARSAC",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "b5bd9a64-4315-492e-9679-3e2f6799c769",
      "format": "Other",
      "parent_slugs": [
        "department-of-health-and-social-care"
      ],
      "slug": "administration-of-radioactive-substances-advisory-committee",
      "status": "live",
      "superseding_slugs": [],
      "title": "Administration of Radioactive Substances Advisory Committee",
      "updated_at": "2021-09-15T11:03:46Z",
      "url": "https://www.gov.uk/government/organisations/administration-of-radioactive-substances-advisory-committee"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": null,
      "content_id": "b0bdfcf3-2763-4002-961e-a0b2d7825038",
      "format": "Court",
      "parent_slugs": [
        "hm-courts-and-tribunals-service"
      ],
      "slug": "administrative-court",
      "status": "live",
      "superseding_slugs": [],
      "title": "Administrative Court",
      "updated_at": "2022-12-16T18:54:50Z",
      "url": "https://www.gov.uk/government/organisations/administrative-court"
    },
    {
      "acronym": "AJTC",
      "child_slugs": [],
      "closed_status": "no_longer_exists",
      "content_id": "1248e572-5f97-4c70-bba8-b8e2da8b45bf",
      "format": "Advisory non-departmental public body",
      "parent_slugs": [
        "ministry-of-justice"
      ],
      "slug": "administrative-justice-and-tribunals-council",
      "status": "closed",
      "superseding_slugs": [],
      "title": "Administrative Justice and Tribunals Council",
      "updated_at": "2021-04-15T09:00:42Z",
      "url": "https://www.gov.uk/government/organisations/administrative-justice-and-tribunals-council"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": "no_longer_exists",
      "content_id": "d2244c73-ad80-4d70-a992-1ae2d0a1d288",
      "format": "Other",
      "parent_slugs": [],
      "slug": "administrative-justice-and-tribunals-council-welsh-committee",
      "status": "closed",
      "superseding_slugs": [],
      "title": "Administrative Justice and Tribunals Council Welsh Committee",
      "updated_at": "2021-04-15T09:03:23Z",
      "url": "https://www.gov.uk/government/organisations/administrative-justice-and-tribunals-council-welsh-committee"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": null,
      "content_id": "2585bb7b-6134-4176-8309-db184573a4c1",
      "format": "Court",
      "parent_slugs": [
        "hm-courts-and-tribunals-service"
      ],
      "slug": "admiralty-court",
      "status": "live",
      "superseding_slugs": [],
      "title": "Admiralty Court",
      "updated_at": "2021-04-15T09:04:09Z",
      "url": "https://www.gov.uk/government/organisations/admiralty-court"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": "no_longer_exists",
      "content_id": "801c815e-bb05-4f49-88e8-2d3fa0c3a250",
      "format": "Other",
      "parent_slugs": [],
      "slug": "adult-learning-inspectorate",
      "status": "closed",
      "superseding_slugs": [],
      "title": "Adult Learning Inspectorate",
      "updated_at": "2021-04-15T09:02:23Z",
      "url": "https://www.gov.uk/government/organisations/adult-learning-inspectorate"
    },
    {
      "acronym": "ARIA",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "330bdc96-a584-450e-9536-5932691e5cd7",
      "format": "Executive non-departmental public body",
      "parent_slugs": [
        "department-for-business-innovation-science-and-trade"
      ],
      "slug": "advanced-research-and-invention-agency",
      "status": "exempt",
      "superseding_slugs": [],
      "title": "Advanced Research and Invention Agency",
      "updated_at": "2026-10-14T10:06:34Z",
      "url": "https://www.gov.uk/government/organisations/advanced-research-and-invention-agency"
    },
    {
      "acronym": null,
      "child_slugs": [],
      "closed_status": "no_longer_exists",
      "content_id": "f66dd076-cee8-4d43-a122-fe087848b10d",
      "format": "Executive agency",
      "parent_slugs": [],
      "slug": "advantage-west-midlands",
      "status": "closed",
      "superseding_slugs": [],
      "title": "Advantage West Midlands",
      "updated_at": "2021-04-15T09:03:00Z",
      "url": "https://www.gov.uk/government/organisations/advantage-west-midlands"
    },
    {
      "acronym": "ACSS",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "84a579e2-e8d3-4b21-8f59-6df3a3b90767",
      "format": "Other",
      "parent_slugs": [
        "food-standards-agency"
      ],
      "slug": "advisory-committee-for-social-science",
      "status": "live",
      "superseding_slugs": [],
      "title": "Advisory Committee for Social Science",
      "updated_at": "2026-10-13T12:08:46Z",
      "url": "https://www.gov.uk/government/organisations/advisory-committee-for-social-science"
    },
    {
      "acronym": "ACAF",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "b02a8db0-6bbb-4010-9584-1a6623dc7012",
      "format": "Other",
      "parent_slugs": [
        "food-standards-agency"
      ],
      "slug": "advisory-committee-on-animal-feedingstuffs",
      "status": "live",
      "superseding_slugs": [],
      "title": "Advisory Committee on Animal Feedingstuffs",
      "updated_at": "2026-10-13T12:08:10Z",
      "url": "https://www.gov.uk/government/organisations/advisory-committee-on-animal-feedingstuffs"
    },
    {
      "acronym": "ACOBA",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "6e414d7c-61af-4113-b039-435e461ddaf2",
      "format": "Advisory non-departmental public body",
      "parent_slugs": [
        "cabinet-office"
      ],
      "slug": "advisory-committee-on-business-appointments",
      "status": "live",
      "superseding_slugs": [],
      "title": "Advisory Committee on Business Appointments",
      "updated_at": "2023-06-08T20:45:56Z",
      "url": "https://www.gov.uk/government/organisations/advisory-committee-on-business-appointments"
    },
    {
      "acronym": "ACCEA",
      "child_slugs": [],
      "closed_status": "replaced",
      "content_id": "aee6b528-c1f5-404c-bc69-d584e63e20a5",
      "format": "Advisory non-departmental public body",
      "parent_slugs": [
        "department-of-health-and-social-care"
      ],
      "slug": "advisory-committee-on-clinical-excellence-awards",
      "status": "closed",
      "superseding_slugs": [
        "advisory-committee-on-clinical-impact-awards"
      ],
      "title": "Advisory Committee on Clinical Excellence Awards",
      "updated_at": "2022-04-13T14:35:11Z",
      "url": "https://www.gov.uk/government/organisations/advisory-committee-on-clinical-excellence-awards"
    },
    {
      "acronym": "ACCIA",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "d3eb23ce-23ad-4d26-88b2-b088c525dbb0",
      "format": "Advisory non-departmental public body",
      "parent_slugs": [
        "department-of-health-and-social-care"
      ],
      "slug": "advisory-committee-on-clinical-impact-awards",
      "status": "live",
      "superseding_slugs": [],
      "title": "Advisory Committee on Clinical Impact Awards",
      "updated_at": "2024-02-09T13:41:24Z",
      "url": "https://www.gov.uk/government/organisations/advisory-committee-on-clinical-impact-awards"
    },
    {
      "acronym": "ACCO",
      "child_slugs": [],
      "closed_status": null,
      "content_id": "a090e915-247a-4a63-a283-f22f948f27b3",
      "format": "Advisory non-departmental public body",
      "parent_slugs": [
        "ministry-of-defence"
      ],
      "slug": "advisory-committee-on-conscientious-objectors",
      "status": "live",
      "superseding_slugs": [],
      "title": "Advisory Committee on Conscientious Objectors",
      "updated_at": "2021-04-15T09:00:32Z",
      "url": "https://www.gov.uk/government/organisations/advisory-committee-on-conscientious-objectors"
    }
  ],
  "page": 1,
  "pages": 64,
  "source_url": "https://www.gov.uk/api/organisations?page=1",
  "total": 1268
}
```

### List product safety alerts

- Capability: `government-publications/list_product_safety_alerts`
- Description: Product safety alerts, reports and recalls from the Office for Product Safety and Standards (OPSS) on GOV.UK, newest first: the GOV.UK Search API filtered to document type product_safety_alert_report_recall (the finder at www.gov.uk/product-safety-alerts-reports-recalls). Each notice: title, reference (the PSD notification number such as 2609-0213, or PSA9, from the title), path, url, description, alert type (product-recall, product-safety-report, product-safety-alert), risk level (serious, high, medium, low, not-provided), product category, corrective measures, the alert date and the publication timestamp. Filter by words, alert type, risk level, category and alert date range. get_page on a path returns the full notice with its product information table (brand, model, barcodes, batch numbers), hazard, corrective action and the product image PDF.
- Instructions: To answer which consumer products were recalled or reported unsafe in the UK and when (e.g. recalls since 2026-10-01, serious-risk toys, a brand's recalls), with official dates and references.
- Cost: 5 credits per call
- Capability file: [List product safety alerts](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/list_product_safety_alerts)

Accepted options:
- `alert_type` (string): Notice type. Example: `product-recall`
- `category` (string): Product category slug, e.g. toys, electrical-appliances-equipment, childcare-articles-childrens-equipment, cosmetics, lighting-products, machinery. Pattern: ^[a-z0-9-]+$. Example: `<category>`
- `cursor` (string): next_cursor from an earlier call (a result offset). Pattern: ^[0-9]+$. Example: `<cursor>`
- `from` (string): Earliest alert date, YYYY-MM-DD (inclusive). Pattern: ^\d{4}-\d{2}-\d{2}$. Example: `<from>`
- `limit` (number): Results per page, 1 to 50 (default 10). Example: `10`
- `q` (string): Words to match, e.g. a brand, product or hazard. Example: `<q>`
- `risk_level` (string): Risk level the notice states. Example: `serious`
- `to` (string): Latest alert date, YYYY-MM-DD (inclusive). Pattern: ^\d{4}-\d{2}-\d{2}$. Example: `<to>`

Response schema example:
```json
{
  "alerts": [
    {
      "alert_date": "2026-10-22",
      "alert_type": "product-recall",
      "category": "childcare-articles-childrens-equipment",
      "description": "Product Recall for Axkid MiniKid Core Car Seats.",
      "measure_types": [
        "recall-of-product-from-end-users"
      ],
      "path": "/product-safety-alerts-reports-recalls/product-recall-axkid-minikid-core-car-seats-2609-0213",
      "published_at": "2026-10-22T14:59:39Z",
      "rank": 1,
      "reference": "2609-0213",
      "risk_level": "not-provided",
      "title": "Product Recall: Axkid MiniKid Core Car Seats (2609-0213)",
      "url": "https://www.gov.uk/product-safety-alerts-reports-recalls/product-recall-axkid-minikid-core-car-seats-2609-0213"
    },
    {
      "alert_date": "2026-09-28",
      "alert_type": "product-recall",
      "category": "electrical-appliances-equipment",
      "description": "Product Recall for Zebra Prescription Printer Power Supply Units presenting a high risk of fire.",
      "measure_types": [
        "recall-of-product-from-end-users"
      ],
      "path": "/product-safety-alerts-reports-recalls/product-recall-zebra-prescription-printer-power-supply-units-2607-0208",
      "published_at": "2026-09-28T16:01:17Z",
      "rank": 2,
      "reference": "2607-0208",
      "risk_level": "high",
      "title": "Product Recall: Zebra Prescription Printer Power Supply Units (2607-0208)",
      "url": "https://www.gov.uk/product-safety-alerts-reports-recalls/product-recall-zebra-prescription-printer-power-supply-units-2607-0208"
    },
    {
      "alert_date": "2026-09-28",
      "alert_type": "product-recall",
      "category": "clothing-textiles-fashion",
      "description": "Product Recall for TU Tote Shopper Bags presenting a serious chemical risk.",
      "measure_types": [
        "recall-of-product-from-end-users"
      ],
      "path": "/product-safety-alerts-reports-recalls/product-recall-tu-tote-shopper-bags-2609-0173",
      "published_at": "2026-09-28T15:57:50Z",
      "rank": 3,
      "reference": "2609-0173",
      "risk_level": "serious",
      "title": "Product Recall: TU Tote Shopper Bags (2609-0173)",
      "url": "https://www.gov.uk/product-safety-alerts-reports-recalls/product-recall-tu-tote-shopper-bags-2609-0173"
    },
    {
      "alert_date": "2025-12-24",
      "alert_type": "product-recall",
      "category": "lighting-products",
      "description": "Product Recall for Next Core 5LT Flush Ceiling Light presenting a risk of injuries.",
      "measure_types": [
        "recall-of-product-from-end-users"
      ],
      "path": "/product-safety-alerts-reports-recalls/product-recall-next-cora-5lt-flush-ceiling-light-2512-0232",
      "published_at": "2025-12-24T09:36:08Z",
      "rank": 4,
      "reference": "2512-0232",
      "risk_level": "not-provided",
      "title": "Product Recall: Next Cora 5LT Flush Ceiling Light (2512-0232)",
      "url": "https://www.gov.uk/product-safety-alerts-reports-recalls/product-recall-next-cora-5lt-flush-ceiling-light-2512-0232"
    },
    {
      "alert_date": "2025-02-17",
      "alert_type": "product-recall",
      "category": "kitchen-cooking-accessories",
      "description": "Product Recall for Stanley 1913 Trigger Action and Switchback Travel Mugs presenting a risk of burns.",
      "measure_types": [
        "recall-of-product-from-end-users"
      ],
      "path": "/product-safety-alerts-reports-recalls/product-recall-stanley-1913-trigger-action-and-switchback-travel-mugs-2501-0097",
      "published_at": "2025-02-17T15:52:45Z",
      "rank": 5,
      "reference": "2501-0097",
      "risk_level": "low",
      "title": "Product Recall: Stanley 1913 Trigger Action and Switchback Travel Mugs (2501-0097)",
      "url": "https://www.gov.uk/product-safety-alerts-reports-recalls/product-recall-stanley-1913-trigger-action-and-switchback-travel-mugs-2501-0097"
    }
  ],
  "count": 5,
  "licence": "Open Government Licence v3.0 (most GOV.UK content; a page names any exception): https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
  "next_cursor": "5",
  "observed_at_ms": 1792696059625,
  "query": {
    "alert_type": "product-recall",
    "category": null,
    "from": null,
    "limit": 5,
    "offset": 0,
    "q": "Axkid MiniKid Core",
    "risk_level": null,
    "to": null
  },
  "source_url": "https://www.gov.uk/api/search.json",
  "total": 7
}
```

### Search

- Capability: `government-publications/search`
- Description: Full-text search over www.gov.uk with the official GOV.UK Search API (GET /api/search.json): guidance, consultations and their outcomes, publications, news, speeches, statistics, product safety notices and every other GOV.UK format. Filters: document type (content_store_document_type), content purpose supergroup (the finder groupings), organisation, person, world location, topical event and topic taxon slugs, and a public timestamp range. Accepts a pasted GOV.UK finder URL (search/all, news-and-communications, guidance-and-regulation, policy-papers-and-consultations, research-and-statistics, transparency-and-freedom-of-information-releases, services, .atom feeds too) and maps its query to the same filters. Order by relevance (needs q), newest, oldest or most viewed. Each result: title, path, url, description, document type, public timestamp and organisations. Offset pagination through next_cursor replaces finder paging and scrolling. For monitoring, order newest with a from date lists everything changed since then.
- Instructions: To find GOV.UK pages on a topic or from a department (e.g. DESNZ consultation outcomes since August 2026, HMRC guidance on VAT, the latest news and communications), to page a GOV.UK finder URL without scrolling, or to list what changed since a date; then read one with get_page.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/gov-uk/government-publications/search)

Accepted options:
- `cursor` (string): next_cursor from an earlier call (a result offset). Pattern: ^[0-9]+$. Example: `<cursor>`
- `document_type` (string[]): GOV.UK document types to include (any of them), e.g. consultation_outcome, closed_consultation, open_consultation, guidance, detailed_guide, policy_paper, news_story, press_release, official_statistics, research, product_safety_alert_report_recall. An unknown type matches nothing. Example: `[]`
- `from` (string): Earliest public timestamp, YYYY-MM-DD (inclusive). Pattern: ^\d{4}-\d{2}-\d{2}$. Example: `<from>`
- `limit` (number): Results per page, 1 to 50 (default 10). Example: `10`
- `order` (string): relevance (default with q; needs q), newest (default without q), oldest (by public timestamp, the last public change) or most_viewed. Example: `relevance`
- `organisation` (string[]): Organisation slugs (any of them), e.g. department-for-energy-security-and-net-zero, hm-revenue-customs, office-for-product-safety-and-standards. list_organisations returns slugs. Example: `[]`
- `person` (string[]): Person slugs, e.g. keir-starmer (the people[] finder filter). Example: `[]`
- `q` (string): Search words. Optional: without q the filters list documents newest first. Example: `<q>`
- `supergroup` (string[]): Content purpose supergroups (any of them), the groupings behind the GOV.UK finders: news_and_communications, guidance_and_regulation, policy_and_engagement (policy papers and consultations), research_and_statistics, transparency (transparency and FOI releases), services. Example: `[]`
- `taxon` (string[]): GOV.UK topic taxonomy content ids (the finder's level_one_taxon / level_two_taxon); matches the taxon and everything below it. Example: `[]`
- `to` (string): Latest public timestamp, YYYY-MM-DD (inclusive). Pattern: ^\d{4}-\d{2}-\d{2}$. Example: `<to>`
- `topical_event` (string[]): Topical event slugs. Example: `[]`
- `url` (string): A pasted GOV.UK finder URL instead of filters: https://www.gov.uk/search/all, /search/news-and-communications, /search/guidance-and-regulation, /search/policy-papers-and-consultations, /search/research-and-statistics, /search/transparency-and-freedom-of-information-releases or /search/services, with or without .atom. Its keywords, organisations[], people[], world_locations[], topical_events[], level_one_taxon, content_store_document_type, public_timestamp[from]/[to] (dd/mm/yyyy or yyyy-mm-dd) and order are mapped to the Search API; combine only with limit and cursor. Pattern: ^https?://. Example: `<url>`
- `world_location` (string[]): World location slugs, e.g. ukraine. Example: `[]`

Response schema example:
```json
{
  "count": 5,
  "licence": "Open Government Licence v3.0 (most GOV.UK content; a page names any exception): https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
  "next_cursor": "5",
  "observed_at_ms": 1792696035233,
  "query": {
    "document_type": [
      "consultation_outcome"
    ],
    "finder": null,
    "from": null,
    "limit": 5,
    "offset": 0,
    "order": "relevance",
    "organisation": [
      "department-for-energy-security-and-net-zero"
    ],
    "person": [],
    "q": "gas system in transition security of supply",
    "subgroup": [],
    "supergroup": [],
    "taxon": [],
    "to": null,
    "topical_event": [],
    "world_location": []
  },
  "results": [
    {
      "description": "We are seeking views on our assessment of GB’s long-term supply of gas, and proposed policy actions to protect our gas and energy security during the transition.",
      "document_type": "consultation_outcome",
      "organisations": [
        {
          "acronym": "DESNZ",
          "slug": "department-for-energy-security-and-net-zero",
          "title": "Department for Energy Security and Net Zero"
        }
      ],
      "path": "/government/consultations/gas-system-in-transition-security-of-supply",
      "public_timestamp": "2026-08-18T09:00:01Z",
      "rank": 1,
      "title": "Gas system in transition: security of supply",
      "url": "https://www.gov.uk/government/consultations/gas-system-in-transition-security-of-supply"
    },
    {
      "description": "We're seeking views on potential transitional support arrangements to facilitate the transition of large-scale biomass electricity generation to power BECCS.",
      "document_type": "consultation_outcome",
      "organisations": [
        {
          "acronym": "DESNZ",
          "slug": "department-for-energy-security-and-net-zero",
          "title": "Department for Energy Security and Net Zero"
        }
      ],
      "path": "/government/consultations/transitional-support-mechanism-for-large-scale-biomass-electricity-generators",
      "public_timestamp": "2025-02-10T14:14:07Z",
      "rank": 2,
      "title": "Transitional support mechanism for large-scale biomass electricity generators",
      "url": "https://www.gov.uk/government/consultations/transitional-support-mechanism-for-large-scale-biomass-electricity-generators"
    },
    {
      "description": "We're seeking views on the proposed regulations, including the licence conditions designed to protect consumers and the electricity system.",
      "document_type": "consultation_outcome",
      "organisations": [
        {
          "acronym": "DESNZ",
          "slug": "department-for-energy-security-and-net-zero",
          "title": "Department for Energy Security and Net Zero"
        }
      ],
      "path": "/government/consultations/smart-secure-electricity-systems-sses-programme-draft-load-control-licence-regulations-and-conditions",
      "public_timestamp": "2026-08-07T09:55:05Z",
      "rank": 3,
      "title": "Smart Secure Electricity Systems (SSES) Programme: draft load control licence regulations and conditions",
      "url": "https://www.gov.uk/government/consultations/smart-secure-electricity-systems-sses-programme-draft-load-control-licence-regulations-and-conditions"
    },
    {
      "description": "We're seeking views on draft social and environmental guidance for the Gas and Electricity Markets Authority.",
      "document_type": "consultation_outcome",
      "organisations": [
        {
          "acronym": "DESNZ",
          "slug": "department-for-energy-security-and-net-zero",
          "title": "Department for Energy Security and Net Zero"
        }
      ],
      "path": "/government/consultations/draft-strategic-policy-guidance-for-electricity-networks-growth",
      "public_timestamp": "2026-09-14T13:30:28Z",
      "rank": 4,
      "title": "Draft strategic policy guidance for electricity networks growth",
      "url": "https://www.gov.uk/government/consultations/draft-strategic-policy-guidance-for-electricity-networks-growth"
    },
    {
      "description": "We're seeking views on new energy supplier obligations to drive non-domestic smart meter uptake post-2025 and protect consumers in the transition to smart-contingent contracts.",
      "document_type": "consultation_outcome",
      "organisations": [
        {
          "acronym": "DESNZ",
          "slug": "department-for-energy-security-and-net-zero",
          "title": "Department for Energy Security and Net Zero"
        }
      ],
      "path": "/government/consultations/non-domestic-smart-meter-rollout-post-2025",
      "public_timestamp": "2026-09-01T08:30:02Z",
      "rank": 5,
      "title": "Non-domestic smart meter rollout post-2025",
      "url": "https://www.gov.uk/government/consultations/non-domestic-smart-meter-rollout-post-2025"
    }
  ],
  "source_url": "https://www.gov.uk/api/search.json",
  "total": 114
}
```
