{"openapi":"3.1.0","info":{"title":"Patientary API","version":"1.0.0","description":"Patientary is the fast, clean reference layer for US healthcare data — look up any provider by NPI, search the ICD-10-CM code set, and validate codes and identifiers. Real data from the CMS NPPES registry and the official ICD-10-CM release, with a first-class API and MCP endpoint so AI agents can call the same lookups your billing team uses. Free to search — built for medical billers, RCM teams, health-tech developers and the agents building on top of them.","contact":{"name":"Patientary","url":"https://patientary.com","email":"hello@patientary.com"}},"servers":[{"url":"https://patientary.com"}],"security":[{},{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"ptn_live_*"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"request_id":{"type":"string"}}}}},"paths":{"/api/v1/npi/{npi}":{"get":{"summary":"Look up a single provider by NPI number (live CMS NPPES data).","operationId":"get_api_v1_npi_npi","parameters":[{"name":"npi","in":"path","required":true,"description":"10-digit National Provider Identifier.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/npi":{"get":{"summary":"Search the NPPES registry by name, organization, taxonomy or location.","operationId":"get_api_v1_npi","parameters":[{"name":"first_name","in":"query","required":false,"description":"Individual first name.","schema":{"type":"string"}},{"name":"last_name","in":"query","required":false,"description":"Individual last name.","schema":{"type":"string"}},{"name":"organization","in":"query","required":false,"description":"Organization name.","schema":{"type":"string"}},{"name":"taxonomy","in":"query","required":false,"description":"Provider taxonomy / specialty description.","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"City (pair with state).","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Two-letter state code.","schema":{"type":"string"}},{"name":"postal_code","in":"query","required":false,"description":"5- or 9-digit ZIP.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1–200, default 20).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/icd10/{code}":{"get":{"summary":"Get one ICD-10-CM code with chapter, billable status, parent and children.","operationId":"get_api_v1_icd10_code","parameters":[{"name":"code","in":"path","required":true,"description":"ICD-10-CM code, e.g. E11.9 (dot optional).","schema":{"type":"string"}},{"name":"crosswalk","in":"query","required":false,"description":"1 to include the full code family (Pro).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/icd10":{"get":{"summary":"Search ICD-10-CM by code prefix or clinical description.","operationId":"get_api_v1_icd10","parameters":[{"name":"q","in":"query","required":true,"description":"A code (E11) or a description (type 2 diabetes).","schema":{"type":"string"}},{"name":"billable","in":"query","required":false,"description":"1 to return only billable (leaf) codes.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1–100, default 20).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/taxonomy":{"get":{"summary":"Look up or search NUCC provider-taxonomy (specialty) codes.","operationId":"get_api_v1_taxonomy","parameters":[{"name":"q","in":"query","required":false,"description":"Specialty term, e.g. cardiology.","schema":{"type":"string"}},{"name":"code","in":"query","required":false,"description":"A taxonomy code, e.g. 207Q00000X.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/validate":{"post":{"summary":"Batch-validate NPIs and ICD-10 codes in one call (claim scrubbing).","operationId":"post_api_v1_validate","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"npis":{"type":"array","items":{"type":"string"},"description":"Array of NPI numbers to validate."},"icd10":{"type":"array","items":{"type":"string"},"description":"Array of ICD-10 codes to validate."}}}}}}}}}}