---
title: "Retrieve All Appointments for a Practice/Firm"
method: GET
path: "/fhir/v2/Appointment"
tags: ["Appointments and Slots"]
---

# Retrieve All Appointments for a Practice/Firm

`GET /fhir/v2/Appointment`

## Request

- Base URL: `https://stage.ema-api.com/ema-dev/firm/apiportal/ema`
- URL: `https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Appointment`
- Auth: HTTP bearer and API key in header `x-api-key`

## Query parameters

- `_count` string
- `_lastUpdated` string, date
- `appointment-type` string
- `created` string, date
- `date` string, date
- `location` string
- `page` string
- `patient` string
- `practitioner` string
- `status` string
- `supporting-info` string

## Headers

- `Content-flag` 'Referral'

## Response `200`

Success

- FHIRJSONRESOURCE: A FHIR resource

## Other responses

- `400`: BAD REQUEST - The request was bad, often due to a missing required parameter
- `401`: NOT AUTHORIZED - Authentication error; this token is not allowed access to the API
- `403`: FORBIDDEN
- `404`: NOT FOUND
- `422`: UNPROCESSABLE ENTITY - Request could not be processed; typically a validation error
- `429`: TOO MANY REQUESTS - Request was rate limited (1000 calls/min default); please retry
- `500`: SERVER ERROR - Internal Server Error

---

[API](https://skmtc.dev/modmed/apis/ema-proprietary-api.md) - [All operations](https://skmtc.dev/modmed/apis/ema-proprietary-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modmed/apis/ema-proprietary-api/revisions/c03c1956a05d?raw)