pensions-ombudsman.org.uk APIpensions-ombudsman.org.uk ↗
Access UK Pensions Ombudsman decisions, news, FAQs, and publications via API. Search by keyword, outcome, topic, or date. 10 endpoints, structured JSON.
curl -X GET 'https://api.parse.bot/scraper/ea1bf717-2a7b-480b-9319-2f1016cf587e/search_decisions?keys=pension&page=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search and list previous decisions from the Pensions Ombudsman. Returns paginated results with decision metadata including title, URL, complainant, respondent, outcome, complaint topic, reference, and date. Supports keyword search, sorting, and filtering by outcome, topic, or type.
| Param | Type | Description |
|---|---|---|
| keys | string | Search keyword to filter decisions. |
| page | integer | Page number (0-based). |
| sort | string | Sort order. Accepted values: 'field_decision_date_value_DESC', 'field_decision_date_value_ASC'. |
| topic | string | Complaint topic filter as comma-separated numeric IDs from the site's taxonomy. |
| outcome | string | Outcome filter as comma-separated numeric IDs from the site's taxonomy. Valid IDs are not fully enumerated; results may be empty for unrecognized values. |
| type_id | string | Decision type filter as comma-separated numeric IDs from the site's taxonomy. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"decisions": "array of decision objects with title, url, complainant, respondent, outcome, complaint_topic, ref, and date"
},
"sample": {
"data": {
"page": 0,
"decisions": [
{
"ref": "CAS-82907-M1J5",
"url": "https://www.pensions-ombudsman.org.uk/decision/2026/cas-82907-m1j5/nhs-pension-scheme-cas-82907-m1j5",
"date": "Tue 21 April 2026",
"title": "NHS Pension Scheme (CAS-82907-M1J5)",
"outcome": "Upheld",
"respondent": "NHS Business Services Authority",
"complainant": "Mrs T",
"complaint_topic": "Ill Health"
}
]
},
"status": "success"
}
}About the pensions-ombudsman.org.uk API
The Pensions Ombudsman API provides structured access to the UK Pensions Ombudsman website across 10 endpoints, covering decisions, news, FAQs, and publications. Use search_decisions to query the full decisions database by keyword, outcome, complaint topic, or date order, and retrieve per-case details including complainant, respondent, determination text, and PDF link via get_decision_detail. Static informational pages — complaints guidance, about us — are also accessible as structured text.
Decisions Database
The search_decisions endpoint accepts keyword search via keys, paginated results via zero-based page, and sort via sort (ascending or descending by decision date). Taxonomy-based filters topic, outcome, and type_id accept comma-separated numeric IDs drawn from the site's own taxonomy. Each result in the decisions array includes title, url, complainant, respondent, outcome, complaint_topic, ref, and date. Pass any returned url to get_decision_detail for the full record, which adds determination_text and pdf_url when a PDF is available.
News, FAQs, and Publications
get_news_listing returns paginated news articles and press releases with title, url, date, and summary. Individual articles fetched via get_news_article return the full body text alongside date and title. get_faqs supports an optional keys keyword filter and returns question/answer pairs. get_publications lists governance documents, factsheets, expenditure reports, and leaflets, each with title, url, date, type, and summary.
Site-Wide Search and Static Pages
search_site runs a global keyword search across all site content and returns title, url, and snippet per result — useful for surfacing relevant decisions or guidance without knowing which section to search. Three static-page endpoints — get_making_a_complaint_info, get_being_complained_about_info, and get_about_us — each return title, url, and full body text, making it straightforward to pull procedural guidance into external tools without maintaining separate content copies.
Taxonomy Filters
The topic, outcome, and type_id parameters in search_decisions use numeric IDs from the Pensions Ombudsman's internal taxonomy. These IDs are not fully enumerated in the API spec, so developers typically run initial searches without filters to discover representative outcome and topic strings from results, then use search_site or inspect listing data to map strings to usable IDs.
- Building a searchable archive of UK pension dispute decisions filtered by complaint topic or outcome for legal research
- Monitoring new Pensions Ombudsman decisions by polling
search_decisionssorted by date descending - Extracting full determination text via
get_decision_detailfor NLP classification of decision reasoning and outcomes - Aggregating Pensions Ombudsman news and press releases into a compliance alert feed using
get_news_listing - Embedding complaints procedure guidance from
get_making_a_complaint_infointo a pension member support portal - Analysing publication metadata from
get_publicationsto track governance document releases over time - Surfacing relevant FAQ answers from
get_faqsin a pension scheme member chatbot or helpdesk tool
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Pensions Ombudsman provide an official developer API?+
How do the outcome and topic filters work in `search_decisions`?+
outcome, topic, and type_id parameters accept comma-separated numeric IDs from the Pensions Ombudsman's taxonomy. The full list of valid IDs is not pre-enumerated in the API. You can discover applicable values by inspecting outcome and complaint_topic strings returned in unfiltered search_decisions results, then map those strings to IDs through trial or by cross-referencing the site's filter UI.Is the full determination text available for every decision?+
get_decision_detail returns determination_text and pdf_url where the decision page includes them. Some older or early-stage decisions may have limited text or no associated PDF. The pdf_url field will be absent or empty in those cases.Can I filter decisions by the pension scheme name or pension provider?+
keys parameter in search_decisions can surface decisions where the scheme or provider name appears in the title or metadata. For structured filtering by respondent, you would need to retrieve and process result sets programmatically. You can fork this API on Parse and revise it to add a dedicated respondent-filter endpoint if that field is exposed in an accessible form.Does the API cover Pensions Ombudsman Early Resolution Service (ERS) cases separately?+
type_id filter in search_decisions may allow filtering by decision type if ERS decisions are assigned a distinct taxonomy ID, but this is not enumerated in the current spec. You can fork this API on Parse and revise it to add explicit ERS filtering once the relevant taxonomy IDs are mapped.