# List a patient's charges

Canonical page: https://docs.ovok.com/api/patient-billing/list-a-patient-s-charges

`GET /v1/patient-billing/patients/{patientId}/charges`

Lists the patient's charges, latest service first, a page at a time.

**Scope:** the caller's project, with `PATIENT_BILLING_ENABLED` on.

## Behaviour

- Your access policy must grant `patient_billing_charges` `read` and let you read the patient, else **403** `PATIENT_BILLING_NOT_ALLOWED` or **404** `PATIENT_BILLING_PATIENT_NOT_FOUND`.
- `clinicId` lists only that clinic's charges. Every status is listed; `status` says which are still `billable`.
- `limit` is 1 to 100 (30 when left out). Send `nextCursor` back as `cursor` for the next page; a cursor no page gave answers **400** `PATIENT_BILLING_CURSOR_INVALID`.

## Example

```bash
curl 'https://api.sandbox.ovok.com/v1/patient-billing/patients/<patientId>/charges?clinicId=<clinicId>' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```
