# The National Archives API: Search judgments > Searches UK court judgments and tribunal decisions on Find Case Law by keywords or party names. Results can be filtered by court and by judgment date. Unofficial. Not affiliated with or endorsed by The National Archives. - Page: https://fous.com/methods/caselaw.nationalarchives.gov.uk/search-judgments - Method: `caselaw.nationalarchives.gov.uk/search_judgments`, version 1 - Website: caselaw.nationalarchives.gov.uk - Returns: case name, court, date, neutral citation, snippet, judgment link, PDF link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `page` | integer | no | | Page of results, for example 2. Defaults to 1. Default 1. | | `sort` | string | no | | Result order, for example newest. Defaults to relevance. One of "relevance", "newest", "oldest". Default "relevance". | | `court` | string | no | | Court or tribunal name, for example Supreme Court, Court of Appeal or Employment Appeal Tribunal. Defaults to all. Default "all". | | `query` | string | yes | `"Uber v Aslam"` | Keywords or party names to search, for example Uber v Aslam. | | `max_results` | integer | no | | Maximum judgments to return (up to 50). Default 20. | | `decided_after` | string | no | | Include judgments on or after this date, YYYY-MM-DD. | | `decided_before` | string | no | | Include judgments on or before this date, YYYY-MM-DD. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "query": "Uber v Aslam" } ``` Its output: ```json { "judgments": [ { "court": "Court of Appeal (Civil Division)", "snippet": "UBER B.V. (“UBV”...", "pdf_link": "https://caselaw.nationalarchives.gov.uk/ewca/civ/2018/2748/data.pdf", "case_name": "Uber B.V. (\"UBV\") & Ors v Aslam & Ors", "judgment_date": "2018-12-19", "judgment_link": "https://caselaw.nationalarchives.gov.uk/ewca/civ/2018/2748", "neutral_citation": "[2018] EWCA Civ 2748" }, { "court": "United Kingdom Supreme Court", "snippet": "Uber BV and others", "pdf_link": "https://caselaw.nationalarchives.gov.uk/uksc/2021/5/data.pdf", "case_name": "Uber BV and others v Aslam and others", "judgment_date": "2021-02-19", "judgment_link": "https://caselaw.nationalarchives.gov.uk/uksc/2021/5", "neutral_citation": "[2021] UKSC 5" }, { "court": "United Kingdom Supreme Court", "snippet": "Uber Britannia Limited", "pdf_link": "https://caselaw.nationalarchives.gov.uk/uksc/2025/31/data.pdf", "case_name": "D.E.L.T.A. Merseyside Limited and another v Uber Britannia Limited", "judgment_date": "2025-07-29", "judgment_link": "https://caselaw.nationalarchives.gov.uk/uksc/2025/31", "neutral_citation": "[2025] UKSC 31" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"caselaw.nationalarchives.gov.uk/search_judgments","input":{"query":"Uber v Aslam"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find recent Supreme Court judgments mentioning unfair dismissal, newest first, max 10 results - Look up Uber v Aslam decision and its neutral citation - Search Court of Appeal rulings on tenant deposit disputes decided between 2021-01-01 and 2022-06-30 - Show me Employment Appeal Tribunal decisions about holiday pay on page 2 of results - Find judgments involving the party name Smith v Jones Ltd, oldest first, up to 25 results on nationalarchives.gov.uk ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "Page of results, for example 2. Defaults to 1." }, "sort": { "enum": [ "relevance", "newest", "oldest" ], "type": "string", "default": "relevance", "description": "Result order, for example newest. Defaults to relevance." }, "court": { "type": "string", "default": "all", "description": "Court or tribunal name, for example Supreme Court, Court of Appeal or Employment Appeal Tribunal. Defaults to all." }, "query": { "type": "string", "minLength": 1, "description": "Keywords or party names to search, for example Uber v Aslam." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum judgments to return (up to 50)." }, "decided_after": { "type": "string", "description": "Include judgments on or after this date, YYYY-MM-DD." }, "decided_before": { "type": "string", "description": "Include judgments on or before this date, YYYY-MM-DD." } } } ``` ## Output schema ```json { "type": "object", "required": [ "judgments" ], "properties": { "judgments": { "type": "array", "items": { "type": "object", "properties": { "court": { "type": [ "string", "null" ] }, "snippet": { "type": [ "string", "null" ] }, "pdf_link": { "type": [ "string", "null" ] }, "case_name": { "type": "string" }, "judgment_date": { "type": [ "string", "null" ] }, "judgment_link": { "type": "string" }, "neutral_citation": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [CourtListener API: Search case law](https://fous.com/methods/courtlistener.com/search-case-law.md): Searches CourtListener US court opinions by keywords or case name, with optional court, decision dates and sorting. - [National Archives API: Search records](https://fous.com/methods/catalog.archives.gov/search-records.md): Searches public National Archives Catalog records by keywords, year range, material type and online availability, in catalog relevance order. - [legislation.gov.uk API: Search UK legislation](https://fous.com/methods/legislation.gov.uk/search-legislation.md): Search UK legislation by topic or title, with optional type and year filters. Closest title matches appear first; broader text matches fill remaining places. - [CourtListener API: Search federal dockets by party](https://fous.com/methods/courtlistener.com/search-federal-dockets.md): Finds federal RECAP dockets involving a named person or company, newest filed first. Only dockets in the RECAP Archive appear. - [Companies House API: List company filing history](https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-filing-history.md): Lists a UK company's Companies House filings, newest first, with date, form code, type, description, page count and PDF link. Finds the company by name, company number or Companies House link; a category picks accounts, confirmation statements, officers, address, capital, charges or incorporation filings. - [CourtListener API: Get court opinion](https://fous.com/methods/courtlistener.com/get-court-opinion.md): Finds a US court opinion on CourtListener by case name, citation, or opinion link, and returns its metadata, opinions, judges, citing-case count and the lead opinion's full text from its PDF. - [Oyez API: Get Supreme Court case](https://fous.com/methods/oyez.org/get-supreme-court-case.md): Finds an Oyez Supreme Court case by name or case link and returns its summary, decision, justice votes and argument audio links. - [The Guardian API: Search news](https://fous.com/methods/theguardian.com/search-news.md): Searches Guardian articles by keyword through the public Google News feed for theguardian.com, optionally within publication dates, ordered newest first or by relevance, and returns each article's headline, summary, authors, section and publication time from its Guardian page.