---
title: "Get all encounters"
method: GET
path: "/api/encounters/v4"
tags: ["v4"]
---

# Get all encounters

`GET /api/encounters/v4`

## Query parameters

- `limit` integer
- `claim_status` 'biller_received' | 'coded' | 'submitted_to_payer' | 'missing_information' | 'not_billable' | 'waiting_for_provider' | 'era_received' | 'rejected' | 'denied' | 'paid' | 'paid_incorrectly' | 'finalized_paid' | 'finalized_denied' | 'held_by_customer' | 'era_requires_review'
- `sort` V4EncounterSortOptions — unresolved $ref
- `page_token` string
- `date_of_service_min` string, date
- `date_of_service_max` string, date
- `primary_payer_names` string
- `search_term` string
- `external_id` string
- `diagnoses_updated_since` string, date-time
- `tag_ids` string
- `work_queue_id` string
- `billable_status` V4BillableStatusType — unresolved $ref
- `responsible_party` V4ResponsiblePartyType — unresolved $ref
- `owner_of_next_action` V4EncounterOwnerOfNextActionType — unresolved $ref
- `patient_external_id` string
- `include_merged_patient_data` boolean
- `billing_provider_npis` string

## Headers

- `Authorization` string, required

## Response `200`

Response with status 200

- V4EncounterPage — unresolved $ref

## Other responses

- `422` — Error response with status 422
- `500` — Error response with status 500

---

[API](https://skmtc.net/joincandidhealth/apis/api-reference.md) · [All operations](https://skmtc.net/joincandidhealth/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joincandidhealth/api-reference/revisions/7cc5974e4128/schema)