# Prescriptions API

Prescription service for Tidepool Loop

Version: 1.0
License: BSD 2-Clause "Simplified" License

## Servers

integration
```
https://external.integration.tidepool.org
```

production
```
https://api.tidepool.org
```

dev1
```
https://dev1.dev.tidepool.org
```

qa1
```
https://qa1.development.tidepool.org
```

qa2
```
https://qa2.development.tidepool.org
```

## Security

### sessionToken

Tidepool Session Token

Type: apiKey
In: header
Name: X-Tidepool-Session-Token

## Download OpenAPI description

[Prescriptions API](https://tidepool.redocly.app/_spec/reference/prescription.v1.yaml)

## Prescriptions

Manage prescriptions for Tidepool Loop

### List Prescriptions

 - [GET /v1/clinics/{clinicId}/prescriptions](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/listclinicprescriptions.md): Retrieve the list of prescriptions created by clinic members

### Create a Prescription

 - [POST /v1/clinics/{clinicId}/prescriptions](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/createprescription.md): Create a new prescription

### Get Prescription

 - [GET /v1/clinics/{clinicId}/prescriptions/{prescriptionId}](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/getprescriptionbyid.md): Retrieve a prescription by id

### Delete Prescription

 - [DELETE /v1/clinics/{clinicId}/prescriptions/{prescriptionId}](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/deleteprescription.md): Clinician only endpoint to delete a prescription. Works only when the prescription has status .

### Create new revision

 - [POST /v1/clinics/{clinicId}/prescriptions/{prescriptionId}/revisions](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/createprescriptionrevision.md): Add a new revision to a prescription which is still a draft.

### Claim Prescription

 - [POST /v1/patients/{userId}/prescriptions](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/claimprescription.md): Claim a submitted prescription using an access code and date of birth.

### List Prescriptions for Patient

 - [GET /v1/patients/{userId}/prescriptions](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/listpatientprescriptions.md): Retrieve a list of prescription that the user has claimed

### Get Prescription for User

 - [GET /v1/patients/{userId}/prescriptions/{prescriptionId}](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/getprescriptionforuser.md): Retrieve a prescription by id

### Update Prescription State

 - [PATCH /v1/patients/{userId}/prescriptions/{prescriptionId}](https://tidepool.redocly.app/reference/prescription.v1/prescriptions/updateprescriptionstate.md): Update prescription state