# Get participants for appointment

This endpoint retrieves the participants of an appointment. Developers must provide a valid  as a path parameter, and Zocdoc returns the participants of that appointment.


Endpoint: GET /v1/appointments/{appointment_id}/participants
Version: 1.22
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Path parameters:

  - `appointment_id` (string, required)
    The Zocdoc id of the appointment
    Example: "d04b049a-41b1-4aba-9268-d8973cf72cdd"

## Response 200 fields (application/json):

  - `request_id` (string, required)

  - `data` (object, required)

  - `data.patient` (object, required)

  - `data.patient.patient_id` (string)
    The Zocdoc ID of the patient.

  - `data.patient.developer_patient_id` (string)
    The patient identifier provided by 3P developer.

  - `data.patient.first_name` (string, required)
    The patient's first name.

  - `data.patient.last_name` (string, required)
    The patient's last name.

  - `data.patient.date_of_birth` (string, required)
    The patient's date of birth in the format, YYYY-MM-DD.

  - `data.patient.sex_at_birth` (string, required)
    The patient's sex assigned at birth.
    Enum: "male", "female"

  - `data.patient.phone_number` (string, required)
    The patient's unformatted 10 digit phone number. The first and fourth digits cannot be a 0 or 1.
    Example: "9999999999"

  - `data.patient.email_address` (string, required)
    The patient's email address.
    Example: "test@example.com"

  - `data.patient.patient_address` (object, required)

  - `data.patient.patient_address.address1` (string, required)
    The patient's address, line 1.

  - `data.patient.patient_address.city` (string, required)
    The patient's address, city.

  - `data.patient.patient_address.state` (string, required)
    The patient's address, two letter state code.
    Example: "NY"

  - `data.patient.patient_address.zip_code` (string, required)
    The patient's address, 5 digit zip code.
    Example: 36925

  - `data.patient.patient_address.address2` (string)
    The patient's address, line 2.

  - `data.patient.insurance` (object)

  - `data.patient.insurance.insurance_plan_id` (string)
    The ID of the patient's insurance plan. See [Reference Data](/guides/reference-data) for options.
    Example: "ip_2224"

  - `data.patient.insurance.insurance_group_number` (string)
    The patients insurance group number.

  - `data.patient.insurance.insurance_member_id` (string)
    The patients insurance card member ID.

  - `data.patient.insurance.is_self_pay` (boolean)
    Indicates is a patient is self paying

  - `data.patient.gender` (array)
    none_apply and prefer_not_to_say must be used independently, all other gender identities can be used in combination with each other.
    Enum: "female_at_birth", "male_at_birth", "cisgender", "genderfluid", "genderqueer", "intersex", "non_binary", "transgender_man", "transgender_woman", "prefer_not_to_say", "none_apply"

  - `data.patient.uploaded_attachments` (array, required)
    Documents and files that have been uploaded by the patient for this appointment, such as insurance cards, ID cards, or intake forms.

  - `data.patient.uploaded_attachments.attachment_type` (string, required)
    Types of attachments that patients have uploaded and are returned in participant data.
    Enum: "insurance_card_medical", "insurance_card_dental", "insurance_card_vision", "insurance_card_secondary", "id_card", "intake_form", "other"

  - `data.patient.uploaded_attachments.attachment_url` (string, required)
    A full URL to download the attachment pointing to one of auxiliary endpoints in the same API. To access the url the same authentication must be used as the one used to make the request to /participants endpoint.

  - `data.patient.uploaded_attachments.side` (string)
    Indicates whether the document image is of the front or back side. This field is typically used for documents like insurance cards or ID cards that have information on both sides.
    Enum: "front", "back"

  - `data.patient.is_booked_by_another_patient` (boolean, required)
    Indicates whether this patient's appointment was booked by another patient (e.g., a parent booking for their child or someone booking for a dependent)

  - `data.provider_id` (string, required)
    The Zocdoc id of the provider

  - `data.location_id` (string, required)
    The Zocdoc id of the location

## Response 404 fields (application/json):

  - `request_id` (string, required)

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)