{"openapi":"3.1.0","info":{"title":"GenHealth API","version":"1.0.0-preview","description":"A curated preview of the public GenHealth API contract. This snapshot is generated from reviewed ETL routes; GenHealth's internal FastAPI schema is intentionally not published.","contact":{"name":"GenHealth developer support","url":"https://genhealth.ai/contact"}},"servers":[{"url":"https://api.umpa.genhealth.ai","description":"GenHealth API"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Cases","description":"Retrieve prior-authorization cases for your organization."},{"name":"Policies","description":"Find medical-necessity policies and questionnaires."},{"name":"Codes","description":"Look up supported medical codes and prior-authorization indicators."},{"name":"Publishers","description":"List policy publishers available to your organization."}],"paths":{"/v2/cases":{"get":{"tags":["Cases"],"summary":"List cases","description":"Returns the prior-authorization cases associated with the authenticated organization.","operationId":"listCasesV2","x-required-scopes":["read:umpa"],"parameters":[{"name":"page","in":"query","description":"Page number.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","description":"Maximum number of cases to return.","schema":{"type":"integer","minimum":1,"default":10}},{"name":"status","in":"query","description":"Filter by one or more case statuses.","schema":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},{"name":"recommendation","in":"query","description":"Filter by decision recommendation.","schema":{"type":"string"}},{"name":"sort_by","in":"query","description":"Case field used for sorting.","schema":{"type":"string"}},{"name":"order_by","in":"query","description":"Sort direction.","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"A paginated collection of cases.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CasesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/ValidationError"}}}},"/v1/cases/{case_id}":{"get":{"tags":["Cases"],"summary":"Retrieve a case","description":"Retrieves a single case belonging to the authenticated organization.","operationId":"getCase","x-required-scopes":["read:umpa"],"parameters":[{"name":"case_id","in":"path","required":true,"description":"The case identifier.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Case details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Case"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/policies":{"get":{"tags":["Policies"],"summary":"List policies","description":"Returns active medical-necessity policies visible to the authenticated organization.","operationId":"listPolicies","x-required-scopes":["read:umpa"],"parameters":[{"name":"title","in":"query","description":"Filter by policy title.","schema":{"type":"string"}},{"name":"publisher","in":"query","description":"Filter by publisher name.","schema":{"type":"string"}},{"name":"publisher_id","in":"query","description":"Filter by publisher identifier.","schema":{"type":"string","format":"uuid"}},{"name":"policy_id","in":"query","description":"Filter by policy identifier.","schema":{"type":"string","format":"uuid"}},{"name":"page","in":"query","description":"Page number.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","description":"Records per page, capped at 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"A paginated collection of policies.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoliciesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/ValidationError"}}}},"/v1/codes":{"get":{"tags":["Codes"],"summary":"List medical codes","description":"Returns medical codes available to the authenticated organization.","operationId":"listCodes","x-required-scopes":["read:umpa"],"parameters":[{"name":"page","in":"query","description":"Page number.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","description":"Records per page.","schema":{"type":"integer","minimum":1,"default":20}},{"name":"query","in":"query","description":"Search by code or display name.","schema":{"type":"string"}}],"responses":{"200":{"description":"Medical-code results.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MedicalCode"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/publishers":{"get":{"tags":["Publishers"],"summary":"List publishers","description":"Returns policy publishers available to the authenticated organization.","operationId":"listPublishers","x-required-scopes":["read:umpa"],"responses":{"200":{"description":"Publisher results.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Publisher"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Send a GenHealth API key or JWT as a bearer token."}},"responses":{"Unauthorized":{"description":"The bearer token is missing, invalid, or lacks the required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The requested resource could not be found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ValidationError":{"description":"One or more request values failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Pagination":{"type":"object","properties":{"currentPage":{"type":"integer"},"pageSize":{"type":"integer"},"totalPages":{"type":"integer"},"totalItems":{"type":"integer"},"next":{"type":["integer","null"]},"previous":{"type":["integer","null"]}}},"Case":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"recommendation":{"type":["string","null"]},"policy_id":{"type":["string","null"]},"created_at":{"type":["string","null"],"format":"date-time"},"last_modified":{"type":["string","null"],"format":"date-time"}}},"CasesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Case"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Policy":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"publisher":{"type":["string","null"]},"type":{"type":["string","null"]},"last_updated":{"type":["string","null"],"format":"date-time"}}},"PoliciesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Policy"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"MedicalCode":{"type":"object","additionalProperties":true,"properties":{"code":{"type":"string"},"system":{"type":["string","null"]},"display":{"type":["string","null"]}}},"Publisher":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"publisher":{"type":"string"}}},"Error":{"type":"object","properties":{"detail":{"type":"string"}}}}}}