{"uid":"cap_4ba3fZlnsDuE-gHBYgdd3","slug":"nhs-ods-register-search-england-8d5181bb","name":"NHS ODS Register Search (England)","description":"NHS organisations in England (ODS register). One call returns one page of matching records as JSON (25 by default, per_page up to 100) with the total count and the last refresh time; the query parameters filter the records.","url":"https://gankdat.com/x402/data/nhs-ods?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string"},"name":{"type":"string"},"page":{"type":"integer","default":1,"maximum":100000,"minimum":1},"town":{"type":"string"},"status":{"type":"string"},"ods_code":{"type":"string"},"org_type":{"type":"string"},"per_page":{"type":"integer","default":25,"maximum":100,"minimum":1},"postcode":{"type":"string"},"parent_code":{"type":"string"},"outward_code":{"type":"string"},"open_date_after":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"close_date_after":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"health_geography":{"type":"string"},"open_date_before":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"close_date_before":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"national_grouping":{"type":"string"},"prescribing_setting":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","data","meta"],"properties":{"ok":{"type":"boolean","const":true},"data":{"type":"array","items":{"type":"object","required":["ods_code","name","org_type","status","national_grouping","health_geography","address","town","county","postcode","outward_code","open_date","close_date","sub_type","parent_code","parent_joined","parent_left","prescribing_setting","ord_url"],"properties":{"name":{"type":"string"},"town":{"type":["string","null"]},"county":{"type":["string","null"]},"status":{"type":"string"},"address":{"type":["string","null"]},"ord_url":{"type":"string"},"ods_code":{"type":"string"},"org_type":{"type":"string"},"postcode":{"type":["string","null"]},"sub_type":{"type":["string","null"]},"open_date":{"type":["string","null"]},"close_date":{"type":["string","null"]},"parent_code":{"type":["string","null"]},"parent_left":{"type":["string","null"]},"outward_code":{"type":["string","null"]},"parent_joined":{"type":["string","null"]},"health_geography":{"type":["string","null"]},"national_grouping":{"type":["string","null"]},"prescribing_setting":{"type":["string","null"]}},"additionalProperties":false}},"meta":{"type":"object","required":["source","page","per_page","total","last_refreshed_at"],"properties":{"page":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"total":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"source":{"type":"string"},"per_page":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"last_refreshed_at":{"type":["string","null"]}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xeWqnlxpnzWnqmUcPjS2D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated NHS organisation records from the official ODS register, filterable by name, ODS code, postcode, type, status, and more.","exampleAgentPrompt":"Can you find all active GP practices in Leeds — search by town 'Leeds', filter by org_type for GP surgeries, and show me the first 25 results?","exampleUseCases":[{"title":"Verify NHS organisation by ODS code","prompt":"I need to look up the NHS organisation with ODS code 'RJ1' — can you pull its details from the ODS register, including its name, address, and current status?"},{"title":"Find GP surgeries in a postcode area","prompt":"Can you search the NHS ODS register for all active GP practices with outward code 'SW1A' and return the first 25 results?"},{"title":"Audit recently opened NHS organisations","prompt":"Pull a list of NHS organisations in England that opened after 2023-01-01, showing 50 per page — I want to see what new ones have been registered recently."}],"resultDescription":"A JSON object containing a page of matching NHS organisation records (default 25, up to 100 per call), including ODS code, name, organisation type, address, postcode, town, status, open/close dates, parent organisation, and a total record count and last data refresh timestamp.","failureModes":["No matching records for the given filters — returns empty results array with total count of 0","Invalid date format for open_date_after/before or close_date fields — rejected by schema validation","page parameter exceeds maximum of 100,000 — validation error","per_page exceeds maximum of 100 — validation error","Unknown org_type or status value — may return empty results rather than error","Payment failure or insufficient USDC balance — HTTP 402 response"],"whenToPreferThis":"Use this endpoint when you need structured, authoritative NHS organisation data from England's official ODS register, particularly for verifying ODS codes, finding organisations by geography or type, or enumerating NHS entities within a hierarchy. Prefer this over web scraping or general search when you need machine-readable, paginated, regularly refreshed ODS data without building your own ETL pipeline from NHS Digital.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T13:42:59.255Z","isFirstParty":false,"canonicalSlug":"nhs-ods-register-search-england-8d5181bb"}