{"openapi":"3.1.0","info":{"title":"NAMsDB (NAMs database) open API","version":"2026.10.0","description":"Read-only, free, no key needed. Every endpoint is a static JSON file served from a CDN, so it is fast and always available. Data licensed CC BY 4.0: please credit The Alliance for Cruelty Free Science and savethedogs.uk.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://namsdb.uk"}],"paths":{"/api/v1/resources.json":{"get":{"summary":"Every resource in the catalogue","responses":{"200":{"description":"All resources","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceList"}}}}}}},"/api/v1/resources/{id}.json":{"get":{"summary":"One resource by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"uk-biobank"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"$ref":"/api/v1/schema.json"}}}}}},"404":{"description":"No resource with that id"}}}},"/api/v1/categories/{id}.json":{"get":{"summary":"Resources in one category","parameters":[{"name":"id","in":"path","required":true,"schema":{"enum":["gateways","health-records","biobanks-cohorts","registries","drug-safety-toxicology","social-admin","clinical-trials","lab-computational","directories-standards"]}}],"responses":{"200":{"description":"Resources in the category","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceList"}}}}}}},"/api/v1/countries/{code}.json":{"get":{"summary":"Resources covering a country or region","description":"ISO 3166-1 alpha-2 code (e.g. GB), ISO 3166-2 subdivision (e.g. GB-WLS) or INT for international.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"GB-WLS"}],"responses":{"200":{"description":"Resources covering the place","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceList"}}}},"404":{"description":"No resources for that code yet"}}}},"/api/v1/vocabularies.json":{"get":{"summary":"Controlled lists: categories, data types, access levels, costs, population groups","responses":{"200":{"description":"Vocabularies"}}}},"/api/v1/synonyms.json":{"get":{"summary":"The search synonym list (reuse it in your own search)","responses":{"200":{"description":"Synonym groups"}}}},"/api/v1/schema.json":{"get":{"summary":"JSON Schema for one resource entry","responses":{"200":{"description":"JSON Schema"}}}}},"components":{"schemas":{"ResourceList":{"type":"object","properties":{"release":{"type":"string"},"licence":{"type":"string"},"attribution":{"type":"string"},"count":{"type":"integer"},"resources":{"type":"array","items":{"$ref":"/api/v1/schema.json"}}}}}}}