# Public API – Patient Management

Operations related to patients, appointments, providers and so on.

Version: 191.0.3

## Servers

Sandbox
```
https://test.hs1api.com/ascend-gateway/api
```

Prod
```
https://prod.hs1api.com/ascend-gateway/api
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

### oAuthSandbox

OAuth 2.0 client credentials (Sandbox)

Type: oauth2
Token URL: https://test.hs1api.com/oauth/client_credential/accesstoken?grant_type=client_credentials
Scopes:

## Download OpenAPI description

 - [Public API – Patient Management](https://papidocs.hs1api.com/_bundle/PublicAPI/api-patient-management.yaml)

 - [GET /v1/patientconditions](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientconditionsv1.md): **Query shape:** Prefer a **narrow** filter—combine scoping filters with `lastModified` or date bounds where supported. A very wide date range with no other scoping can **408** (timeout) on large tena
 - [POST /v1/patientconditions](https://papidocs.hs1api.com/publicapi/api-patient-management/other/postpatientconditionsv1.md): Creates a resource from the request body. Validation errors return **400**; a successful create returns **201** with the created resource in `data`.
 - [GET /v1/patientconditions/{patientConditionId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientconditionsbypatientconditionidv1.md): Returns the patientCondition entry identified by the path parameter. **404** when the resource is missing or not accessible in the organization context.
 - [PUT /v1/patientconditions/{patientConditionId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/putpatientconditionsbypatientconditionidv1.md): Updates the resource identified by the path parameter. Validation errors return **400**; **404** when the resource is missing.
 - [DELETE /v1/patientconditions/{patientConditionId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/deletepatientconditionsbypatientconditionidv1.md): Deletes the resource identified by the path parameter. **404** when the resource is missing or already deleted.
 - [GET /v1/patientrecares](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientrecaresv1.md): **Query shape:** Prefer a **narrow** filter—combine scoping filters with `lastModified` or date bounds where supported. A very wide date range with no other scoping can **408** (timeout) on large tena
 - [POST /v1/patientrecares](https://papidocs.hs1api.com/publicapi/api-patient-management/other/postpatientrecaresv1.md): Creates a resource from the request body. Validation errors return **400**; a successful create returns **201** with the created resource in `data`.
 - [GET /v1/patientrecares/{patientRecareId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientrecaresbypatientrecareidv1.md): Returns the PatientRecareV1 identified by the path parameter. **404** when the resource is missing or not accessible in the organization context.
 - [PUT /v1/patientrecares/{patientRecareId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/putpatientrecaresbypatientrecareidv1.md): Updates the resource identified by the path parameter. Validation errors return **400**; **404** when the resource is missing.
 - [DELETE /v1/patientrecares/{patientRecareId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/deletepatientrecaresbypatientrecareidv1.md): Deletes the resource identified by the path parameter. **404** when the resource is missing or already deleted.
 - [GET /v1/patients](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getallpatients.md): **Query shape:** Prefer a **narrow** filter—combine name, chart, or contact filters with `lastModified` or `dateOfBirth` bounds where possible. A very wide `lastModified` range with no other scoping c
 - [POST /v1/patients](https://papidocs.hs1api.com/publicapi/api-patient-management/other/createpatient.md): Creates a resource from the request body. Validation errors return **400**; a successful create returns **201** with the created resource in `data`.
 - [GET /v1/patients/async](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getallpatientsasync.md): Retrieves patients asynchronously. Returns the first 10 results immediately and delivers matching records via StreamAPI webhooks (SNS). Filter remaining results with MessageAttributes.RoutingKey.
 - [GET /v1/patients/{patientId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientbyid.md): Returns the patient identified by the path parameter. **404** when the patient is missing or not accessible in the organization context.
 - [PUT /v1/patients/{patientId}](https://papidocs.hs1api.com/publicapi/api-patient-management/other/updatepatient.md): Updates the resource identified by the path parameter. Validation errors return **400**; **404** when the resource is missing.
 - [GET /v1/patients/{patientId}/billingtypes](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientsbypatientidbillingtypes.md)
 - [POST /v1/patients/{patientId}/billingtypes](https://papidocs.hs1api.com/publicapi/api-patient-management/other/postpatientsbypatientidbillingtypes.md): Creates a resource from the request body. Validation errors return **400**; a successful create returns **201** with the created resource in `data`.
 - [GET /v1/patients/calculated](https://papidocs.hs1api.com/publicapi/api-patient-management/other/getpatientcalculatedfields.md): Returns calculated fields per patient row. **Required:** `filter` (narrow with `patient.id==…` or `patient.id->[…]`) and `responseFields` listing at least one allowed field (for example `lastVisitDate