GOV.UK
App · 8 actions
Search and read everything the UK government publishes on GOV.UK: news, guidance, policy papers, consultations, statistics and services, filtered by department, kind of page, country and date. Read any page as plain text with its change history, look up government organisations, check foreign travel advice for any country, and start a workflow whenever something new is published. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Count search results | Count how many GOV.UK pages match a search, broken down by document type, organisation, content purpose or country: how much HMRC published this month and of what kind, or which departments publish most about a topic. |
| Get a page | Read any page on GOV.UK from its address: its title, summary, kind of page, organisations, first published and last updated dates, every announced change, its attachments, and its words as plain text a summarizing step can use, plus the HTML. |
| Get an organisation | Get one government organisation: its name, acronym, kind of body, whether it is live or closed (and when and how it closed), its own website when it has one, what it does, the bodies it belongs to, supports, replaced or was replaced by, its ministers and its social media accounts. |
| Get travel advice | Read the UK government's travel advice for one country: whether the Foreign, Commonwealth & Development Office advises against travel to all or part of it, when the advice last changed and what changed, and every section (warnings, entry requirements, safety, health) as plain text. |
| List organisations | List the government departments, agencies and public bodies that publish on GOV.UK, with each one's slug, acronym, kind of body, status and the bodies it belongs to or supports. |
| List travel advice | List the UK government's foreign travel advice for every country, most recently updated first, with what changed in each. |
| List world locations | List the countries, territories and international delegations GOV.UK publishes about, with each one's slug (what the Countries filter takes), its two-letter ISO code and its page of UK help and services. |
| Search GOV.UK | Search everything the UK government publishes on GOV.UK: news, guidance, policy papers, consultations, statistics, services and more. |
Count search results
Count how many GOV.UK pages match a search, broken down by document type, organisation, content purpose or country: how much HMRC published this month and of what kind, or which departments publish most about a topic. Takes the same filters as 'Search GOV.UK'.
Inputs
- Group by
group_bytextRequired - What to count the matching pages by.One of:
document_type(Document type),organisation,content_purpose(Content purpose),content_purpose_subgroup(Narrower purpose),world_location(World location). - Keywords
querytext - Words to look for in a page's title, summary and text. Leave empty to match everything the other filters allow.
- Organisations
organisationslist - Only pages from these government organisations. Pick from the list, or type a name or acronym such as HMRC. A page counts if any of them published it.
- Content purpose
content_purposeslist - Only pages with these purposes. News and communications covers news, speeches and announcements; policy and engagement covers policy papers and consultations; services are the things you can do online.One or more of:
news_and_communications(News and communications),guidance_and_regulation(Guidance and regulation),policy_and_engagement(Policy and engagement),transparency,research_and_statistics(Research and statistics),services,other(Other pages). - Document types
document_typeslist - Only these kinds of page, such as press releases, consultations or official statistics. Narrower than content purpose. Pick from the list of every type GOV.UK publishes.
- Countries
world_locationslist - Only pages about these countries, territories or international delegations, such as embassy news or trade announcements.
- Published on or after
published_fromdate - Only pages published or last changed in a major way on or after this date (UK time).
- Published on or before
published_todate - Only pages published or last changed in a major way on or before this date. Give both dates for a window such as last week.
- How many groups
limitnumber - How many values to return, largest first. GOV.UK has about 140 document types and 1,300 organisations.From 1 to 1500. Default:
50.
Outputs
countnumber- How many groups came back.
documents_without_valuenumber- How many matching pages have no value for the grouping, such as pages about no particular country.
group_bytext- What the pages were grouped by.
groupslist- One row per value, largest first.
querytext- The keywords searched for.
total_groupsnumber- How many different values the matching pages have; more than count when the limit left some out.
total_matchingnumber- How many pages match the search altogether.
Example output
{
"count": 3,
"documents_without_value": 0,
"group_by": "content_purpose",
"groups": [
{
"acronym": null,
"documents": 86276,
"name": "Other pages",
"value": "other"
},
{
"acronym": null,
"documents": 5397,
"name": "Guidance and regulation",
"value": "guidance_and_regulation"
},
{
"acronym": null,
"documents": 2637,
"name": "Research and statistics",
"value": "research_and_statistics"
}
],
"query": null,
"total_groups": 7,
"total_matching": 100236
}Get a page
Read any page on GOV.UK from its address: its title, summary, kind of page, organisations, first published and last updated dates, every announced change, its attachments, and its words as plain text a summarizing step can use, plus the HTML. Guides and travel advice come back part by part.
Inputs
- Page
pagetextRequired - The page's address or path. A search result's url or path works as it is.
Outputs
attachmentslist- The documents published with the page.
change_historylist- Every announced change, newest first.
content_idtext- GOV.UK's permanent ID for the page.
descriptiontext- The page's one-paragraph summary.
document_typetext- The kind of page as a code, such as guidance.
document_type_nametext- The kind of page in words, such as Guidance.
first_published_attext- When the page was first published, in UTC.
first_published_datetext- The date it was first published in the UK.
htmltext- The page's body as GOV.UK renders it, in HTML.
html_truncatedtrue/false- Whether the HTML was cut short (past 300,000 characters).
last_updated_attext- When the page last changed in a way GOV.UK announces (its 'Last updated' date), in UTC.
last_updated_datetext- That date in the UK, as YYYY-MM-DD.
latest_change_notetext- What changed most recently, in the publisher's words.
localetext- The page's language, such as en or cy (Welsh).
organisation_namestext- The organisations' names on one line.
organisationslist- The organisations the page belongs to.
partslist- For a guide or travel advice, each part with its own address and text. Empty for a single page.
pathtext- The page's path, such as /vat-rates.
redirected_fromtext- The path asked for, when GOV.UK has moved it or it is one part of a longer page. Empty when the page asked for was read.
schema_nametext- GOV.UK's name for the page's layout, such as publication.
start_urltext- For a service's start page, the address of the online service itself.
texttext- The page's words as plain text, with headings, lists and table rows kept. Guides and travel advice have every part in order.
text_charactersnumber- How long that text is.
text_truncatedtrue/false- Whether the text was cut short (past 100,000 characters).
titletext- The page's title.
urltext- The page's full address.
withdrawntrue/false- True when the page has been withdrawn.
withdrawn_attext- When it was withdrawn, in UTC.
withdrawn_explanationtext- Why it was withdrawn, as plain text.
Example output
{
"attachments": [
{
"content_type": null,
"file_size": null,
"kind": "html",
"title": "The Civil Society Resilience Infrastructure Fund: application guidance",
"url": "https://www.gov.uk/government/publications/the-civil-society-resilience-infrastructure-fund/the-civil-society-resilience-infrastructure-fund-application-guidance"
}
],
"change_history": [
{
"at": "2026-10-19T15:47:01Z",
"date": "2026-10-19",
"note": "Update added about the outcome of the grant competition."
},
{
"at": "2026-05-01T09:00:05Z",
"date": "2026-05-01",
"note": "Published clarification questions and answers."
},
{
"at": "2026-04-10T15:58:00Z",
"date": "2026-04-10",
"note": "First published."
}
],
"content_id": "aec3ff72-491e-47d4-8558-2f377f2d7b3c",
"description": "Information about the Civil Society Resilience Infrastructure Fund",
"document_type": "guidance",
"document_type_name": "Guidance",
"first_published_at": "2026-04-10T15:58:00Z",
"first_published_date": "2026-04-10",
"html": "<div class=\"govspeak\"><p>The Civil Society Resilience Infrastructure Fund (the CSRI Fund) is a package of funding to better integrate the perspectives and participation of civil society organisations in national and local emergency planning and response activity.</p></div>",
"html_truncated": false,
"last_updated_at": "2026-10-19T15:47:01Z",
"last_updated_date": "2026-10-19",
"latest_change_note": "Update added about the outcome of the grant competition.",
"locale": "en",
"organisation_names": "Department for Culture, Media and Sport",
"organisations": [
{
"acronym": null,
"name": "Department for Culture, Media and Sport",
"slug": "department-for-culture-media-and-sport"
}
],
"parts": [],
"path": "/government/publications/the-civil-society-resilience-infrastructure-fund",
"redirected_from": null,
"schema_name": "publication",
"start_url": null,
"text": "The Civil Society Resilience Infrastructure Fund (the CSRI Fund) is a package of funding to better integrate the perspectives and participation of civil society organisations in national and local emergency planning and response activity.",
"text_characters": 238,
"text_truncated": false,
"title": "The Civil Society Resilience Infrastructure Fund",
"url": "https://www.gov.uk/government/publications/the-civil-society-resilience-infrastructure-fund",
"withdrawn": false,
"withdrawn_at": null,
"withdrawn_explanation": null
}Get an organisation
Get one government organisation: its name, acronym, kind of body, whether it is live or closed (and when and how it closed), its own website when it has one, what it does, the bodies it belongs to, supports, replaced or was replaced by, its ministers and its social media accounts.
Inputs
- Organisation
organisationtextRequired - Pick from the list, or type a slug, a GOV.UK address, a name or an acronym such as HMRC.
Outputs
acronymtext- Its acronym, such as HMRC, when it has one.
analytics_identifiertext- GOV.UK's short code for it, such as D25.
child_organisationslist- The bodies it supports or sponsors.
closed_ontext- For a closed organisation, the date it closed.
closed_statustext- For a closed organisation, how it closed: replaced, merged, split, changed_name, no_longer_exists, left_gov or devolved.
content_idtext- GOV.UK's permanent ID for its page.
descriptiontext- What the organisation does, in its own words.
ministerslist- Its ministers, with their current roles.
nametext- The organisation's name.
parent_organisationslist- The bodies it is part of.
slugtext- The organisation's slug, such as hm-revenue-customs, which search filters and 'Get an organisation' take.
social_medialist- Its social media accounts and blogs.
statustext- Its state on GOV.UK as a code: live, closed, exempt (it has its own website), joining or transitioning.
status_nametext- That state in words.
superseded_organisationslist- The bodies it replaced.
superseding_organisationslist- The bodies that replaced it, for a closed one.
typetext- The kind of body as a code, such as ministerial_department.
type_nametext- The kind of body in words, such as Ministerial department.
updated_attext- When its record last changed, in UTC.
urltext- The organisation's page on GOV.UK.
websitetext- The organisation's own website, for one that is not (or no longer) on GOV.UK.
Example output
{
"acronym": "HMRC",
"analytics_identifier": "D25",
"child_organisations": [
{
"acronym": "VOA",
"name": "Valuation Office Agency",
"slug": "valuation-office-agency",
"url": "https://www.gov.uk/government/organisations/valuation-office-agency"
},
{
"acronym": "DVS",
"name": "District Valuer Services",
"slug": "district-valuer-services-dvs",
"url": "https://www.gov.uk/government/organisations/district-valuer-services-dvs"
}
],
"closed_on": null,
"closed_status": null,
"content_id": "6667cce2-e809-4e21-ae09-cb0bdc1ddda3",
"description": "HMRC is the UK\u2019s tax, payments and customs authority, and we have a vital purpose: we collect the money that pays for the UK\u2019s public services.",
"ministers": [
{
"name": "The Rt Hon James Murray MP",
"roles": [
"Paymaster General",
"Financial Secretary to the Treasury"
],
"url": "https://www.gov.uk/government/people/james-murray"
}
],
"name": "HM Revenue & Customs",
"parent_organisations": [],
"slug": "hm-revenue-customs",
"social_media": [
{
"service": "x",
"title": "@HMRCgovuk",
"url": "https://x.com/hmrcgovuk"
},
{
"service": "facebook",
"title": "Facebook",
"url": "https://www.facebook.com/HMRC"
}
],
"status": "live",
"status_name": "Live on GOV.UK",
"superseded_organisations": [
{
"acronym": null,
"name": "Department of Inland Revenue",
"slug": "department-of-inland-revenue",
"url": "https://www.gov.uk/government/organisations/department-of-inland-revenue"
}
],
"superseding_organisations": [],
"type": "non_ministerial_department",
"type_name": "Non-ministerial department",
"updated_at": "2025-10-06T08:10:25Z",
"url": "https://www.gov.uk/government/organisations/hm-revenue-customs",
"website": null
}Get travel advice
Read the UK government's travel advice for one country: whether the Foreign, Commonwealth & Development Office advises against travel to all or part of it, when the advice last changed and what changed, and every section (warnings, entry requirements, safety, health) as plain text.
Inputs
- Country
countrytextRequired - Pick a country, or type its name.
Outputs
advises_against_traveltrue/false- True when the FCDO advises against all or all but essential travel to any part of the country.
alert_statuslist- The FCDO's alerts as codes, such as avoid_all_but_essential_travel_to_parts. Empty when it advises against no travel there.
alertslist- The same alerts in the FCDO's words.
change_historylist- Every announced change, newest first.
countrytext- The country's name.
last_updated_attext- When the advice last changed, in UTC.
last_updated_datetext- That date in the UK, as YYYY-MM-DD.
latest_changetext- What changed most recently, in the FCDO's words.
partslist- Each section of the advice: warnings and insurance, entry requirements, safety and security, health and the rest.
pdf_urltext- A printable PDF of the whole advice, when there is one.
reviewed_attext- When the FCDO last confirmed the advice is current, in UTC.
slugtext- The country's slug.
texttext- Every section as one plain text, under its heading.
text_truncatedtrue/false- Whether that text was cut short.
titletext- The page's title.
urltext- The travel advice page.
Example output
{
"advises_against_travel": true,
"alert_status": [
"avoid_all_but_essential_travel_to_parts"
],
"alerts": [
"FCDO advises against all but essential travel to parts of the country"
],
"change_history": [
{
"at": "2026-10-12T09:20:34Z",
"date": "2026-10-12",
"note": "Updated information about visa requirements for travellers entering Thailand by land or air (\u2018Entry requirements\u2019 page)."
}
],
"country": "Thailand",
"last_updated_at": "2026-10-12T09:20:34Z",
"last_updated_date": "2026-10-12",
"latest_change": "Updated information about visa requirements for travellers entering Thailand by land or air (\u2018Entry requirements\u2019 page).",
"parts": [
{
"slug": "warnings-and-insurance",
"text": "Your travel insurance could be invalidated if you travel against advice from the Foreign, Commonwealth & Development Office (FCDO).",
"title": "Warnings and insurance",
"truncated": false,
"url": "https://www.gov.uk/foreign-travel-advice/thailand"
},
{
"slug": "entry-requirements",
"text": "This information is for people travelling on a full \u2018British citizen\u2019 passport from the UK.",
"title": "Entry requirements",
"truncated": false,
"url": "https://www.gov.uk/foreign-travel-advice/thailand/entry-requirements"
}
],
"pdf_url": "https://assets.publishing.service.gov.uk/media/6980b43884f2153b11245356/FCDO__TA__040_-_Thailand_Travel_Advice_Ed8.pdf",
"reviewed_at": "2026-10-12T09:20:34Z",
"slug": "thailand",
"text": "Warnings and insurance\nYour travel insurance could be invalidated if you travel against advice from the Foreign, Commonwealth & Development Office (FCDO).",
"text_truncated": false,
"title": "Thailand travel advice",
"url": "https://www.gov.uk/foreign-travel-advice/thailand"
}List organisations
List the government departments, agencies and public bodies that publish on GOV.UK, with each one's slug, acronym, kind of body, status and the bodies it belongs to or supports. Narrow by name, status (live or closed) and kind (ministerial department, executive agency and so on).
Inputs
- Name
nametext - Words in the organisation's name or acronym. Leave empty to list them A to Z.
- Status
statuseslist - Only organisations in these states. Closed bodies are listed too unless this says otherwise.One or more of:
live(Live on GOV.UK),closed,exempt(Has its own website (exempt)),joining(Joining GOV.UK),transitioning(Moving to GOV.UK). - Kind of body
typeslist - Only organisations of these kinds.One or more of:
ministerial_department(Ministerial department),non_ministerial_department(Non-ministerial department),executive_agency(Executive agency),executive_ndpb(Executive non-departmental public body),advisory_ndpb(Advisory non-departmental public body),tribunal,public_corporation(Public corporation),independent_monitoring_body(Independent monitoring body),devolved_administration(Devolved administration),sub_organisation(Sub-organisation), and 6 more. - How many
countnumber - How many organisations to return, up to 1,500, which is all of them.From 1 to 1500. Default:
100. - Skip the first
startnumber - How many organisations to skip, for reading the next page of results: pass the next_start an earlier step returned. Starts at 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- How many came back.
more_availabletrue/false- Whether more follow these.
next_startnumber- The 'Skip the first' value for the next page.
organisationslist- The organisations, A to Z, or best match first.
startnumber- How many were skipped before these.
totalnumber- How many organisations match altogether.
Example output
{
"count": 2,
"more_available": true,
"next_start": 2,
"organisations": [
{
"acronym": "HMRC",
"child_organisations": [
"valuation-office-agency",
"the-adjudicator-s-office",
"district-valuer-services-dvs"
],
"closed_on": null,
"closed_status": null,
"content_id": "6667cce2-e809-4e21-ae09-cb0bdc1ddda3",
"description": "HMRC is the UK\u2019s tax, payments and customs authority, and we have a vital purpose: we collect the money that pays for the UK\u2019s public services.",
"name": "HM Revenue & Customs",
"parent_organisations": [],
"slug": "hm-revenue-customs",
"status": "live",
"status_name": "Live on GOV.UK",
"superseded_organisations": [
"department-of-inland-revenue",
"valuation-office-agency"
],
"superseding_organisations": [],
"type": "non_ministerial_department",
"type_name": "Non-ministerial department",
"url": "https://www.gov.uk/government/organisations/hm-revenue-customs"
},
{
"acronym": null,
"child_organisations": [],
"closed_on": null,
"closed_status": null,
"content_id": "d2779acd-602b-42cb-b6d5-57a9844b8fa6",
"description": "We deal with claims involving major points of principle relating to taxation where HMRC is a party.",
"name": "The Revenue List",
"parent_organisations": [
"hm-courts-and-tribunals-service"
],
"slug": "the-revenue-list",
"status": "live",
"status_name": "Live on GOV.UK",
"superseded_organisations": [],
"superseding_organisations": [],
"type": "court",
"type_name": "Court",
"url": "https://www.gov.uk/courts-tribunals/the-revenue-list"
}
],
"start": 0,
"total": 13
}List travel advice
List the UK government's foreign travel advice for every country, most recently updated first, with what changed in each. Give a date to see only the countries whose advice changed since then, for a daily or weekly digest.
Inputs
- Updated on or after
updated_sincedate - Only countries whose advice changed on or after this date. Leave empty for all of them.
Outputs
countnumber- How many came back.
countrieslist- The countries, most recently updated first.
total_countriesnumber- How many countries have travel advice altogether.
updated_sincetext- The date the list was narrowed to, if any.
Example output
{
"count": 2,
"countries": [
{
"country": "Malawi",
"last_updated_at": "2026-10-20T14:35:09Z",
"last_updated_date": "2026-10-20",
"latest_change": "New information about foreign currency rules (\u2018Entry requirements\u2019 page).",
"slug": "malawi",
"url": "https://www.gov.uk/foreign-travel-advice/malawi"
},
{
"country": "France",
"last_updated_at": "2026-10-19T10:12:41Z",
"last_updated_date": "2026-10-19",
"latest_change": "Updated information on local curfews (\u2018Warnings and insurance\u2019 page)",
"slug": "france",
"url": "https://www.gov.uk/foreign-travel-advice/france"
}
],
"total_countries": 226,
"updated_since": "2026-10-19"
}List world locations
List the countries, territories and international delegations GOV.UK publishes about, with each one's slug (what the Countries filter takes), its two-letter ISO code and its page of UK help and services.
Inputs
- Kind of location
location_typetext - Only countries and territories, or only delegations.One of:
world_location(Countries and territories),international_delegation(International delegations). - Name contains
nametext - Only locations whose name contains these words.
Outputs
countnumber- How many came back.
world_locationslist- The locations, A to Z.
Example output
{
"count": 2,
"world_locations": [
{
"active": true,
"iso2": "FR",
"kind": "world_location",
"name": "France",
"slug": "france",
"url": "https://www.gov.uk/world/france"
},
{
"active": true,
"iso2": "PF",
"kind": "world_location",
"name": "French Polynesia",
"slug": "french-polynesia",
"url": "https://www.gov.uk/world/french-polynesia"
}
]
}Search GOV.UK
Search everything the UK government publishes on GOV.UK: news, guidance, policy papers, consultations, statistics, services and more. Narrow by keywords, organisation, content purpose, document type, country and publication date, and sort by best match, newest, oldest or most viewed. Every result comes back with its full address, its organisations and its publication date, and the path 'Get a page' reads.
Inputs
- Keywords
querytext - Words to look for in a page's title, summary and text. Leave empty to match everything the other filters allow.
- Organisations
organisationslist - Only pages from these government organisations. Pick from the list, or type a name or acronym such as HMRC. A page counts if any of them published it.
- Content purpose
content_purposeslist - Only pages with these purposes. News and communications covers news, speeches and announcements; policy and engagement covers policy papers and consultations; services are the things you can do online.One or more of:
news_and_communications(News and communications),guidance_and_regulation(Guidance and regulation),policy_and_engagement(Policy and engagement),transparency,research_and_statistics(Research and statistics),services,other(Other pages). - Document types
document_typeslist - Only these kinds of page, such as press releases, consultations or official statistics. Narrower than content purpose. Pick from the list of every type GOV.UK publishes.
- Countries
world_locationslist - Only pages about these countries, territories or international delegations, such as embassy news or trade announcements.
- Published on or after
published_fromdate - Only pages published or last changed in a major way on or after this date (UK time).
- Published on or before
published_todate - Only pages published or last changed in a major way on or before this date. Give both dates for a window such as last week.
- Order
ordertext - Best match by default, which is most viewed when no keywords are given. Newest first is what a workflow watching for new publications wants.One of:
relevance(Best match),newest(Newest first),oldest(Oldest first),most_viewed(Most viewed). Default:relevance. - How many results
countnumber - How many pages to return, up to 1,500.From 1 to 1500. Default:
20. - Skip the first
startnumber - How many matching pages to skip, for reading the next page of results: pass the next_start an earlier step returned. Starts at 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- How many pages came back.
more_availabletrue/false- Whether more matches follow these.
next_startnumber- The 'Skip the first' value for the next page of results. Empty on the last page.
ordertext- The order used: relevance, newest, oldest or most_viewed.
querytext- The keywords searched for.
resultslist- The matching pages, in the order asked for.
startnumber- How many matches were skipped before these.
totalnumber- How many pages match altogether.
Example output
{
"count": 2,
"more_available": true,
"next_start": 2,
"order": "newest",
"query": "vat",
"results": [
{
"content_id": "5e96f72b-7631-11e4-a3cb-005056011aef",
"content_purpose": "research_and_statistics",
"content_purpose_subgroup": "statistics",
"description": "Summary of HM Revenue and Customs' tax receipts, National Insurance contributions (NICs), and expenditure for the UK.",
"document_type": "national_statistics",
"document_type_name": "Accredited official statistics",
"image_url": null,
"organisation_names": "HM Revenue & Customs",
"organisations": [
{
"acronym": "HMRC",
"name": "HM Revenue & Customs",
"slug": "hm-revenue-customs"
}
],
"path": "/government/statistics/hmrc-tax-and-nics-receipts-for-the-uk",
"published_at": "2026-10-21T06:00:02Z",
"published_date": "2026-10-21",
"title": "HMRC tax receipts and National Insurance contributions for the UK",
"url": "https://www.gov.uk/government/statistics/hmrc-tax-and-nics-receipts-for-the-uk",
"withdrawn": false,
"world_locations": []
},
{
"content_id": "e6a27bfb-4aed-4c7b-9db9-971128e7163a",
"content_purpose": "guidance_and_regulation",
"content_purpose_subgroup": "guidance",
"description": "How to use the customs value to calculate VAT for imported goods if you\u2019re an importer or clearing agent.",
"document_type": "detailed_guide",
"document_type_name": "Detailed guide",
"image_url": null,
"organisation_names": "HM Revenue & Customs",
"organisations": [
{
"acronym": "HMRC",
"name": "HM Revenue & Customs",
"slug": "hm-revenue-customs"
}
],
"path": "/guidance/working-out-the-vat-value-using-the-customs-value-of-the-imported-goods",
"published_at": "2026-10-20T23:15:02Z",
"published_date": "2026-10-21",
"title": "Working out the VAT value using the customs value of the imported goods",
"url": "https://www.gov.uk/guidance/working-out-the-vat-value-using-the-customs-value-of-the-imported-goods",
"withdrawn": false,
"world_locations": []
}
],
"start": 0,
"total": 9318
}