# List appointment summaries by status

Returns the appointment summary view filtered by status when the caller is authorized. Supports cursor-based pagination via pageSize and nextToken.

Endpoint: GET /integrations/v1/{domain}/appointments/by-status/{status}
Version: v1
Security: Bearer

## Path parameters:

  - `domain` (string, required)
    Partner domain identifier. Your bearer token is scoped to one or more domains and requests outside that scope are rejected.
    Example: "acme"

  - `status` (string, required)
    Appointment status filter value. Must match one of the known QUBS appointment status strings.
    Enum: "NOT ARRIVED", "ARRIVED", "DID NOT ATTEND", "APPPOINTMENT CANCELLED", "CANCELLATION LIST", "DICTATION INPROGRESS", "DICTATED", "TYPED", "AUTHORISING", "AUTHORISED", "TYPING INPROGRESS", "PENDING REPORTING", "STUDY INPROGRESS", "SECOND REVIEW", "FINALISED", "REVIEW TYPED", "PEER REVIEW", "SECOND OPINION"

## Query parameters:

  - `pageSize` (integer,string)
    Maximum number of items to return in a page. Defaults to 100 when omitted.
    Example: 100

  - `nextToken` (string)
    Opaque continuation token from a previous paged response. Omit for the first page.
    Example: "eyJwYWdlIjoyfQ=="

## Response 200 fields (application/json):

  - `items` (array, required)
    Appointment summaries in the current page.

  - `items.domain` (string, required)
    Domain this appointment belongs to.
    Example: "Example domain"

  - `items.appointmentId` (string, required)
    Appointment identifier.
    Example: "123"

  - `items.scheduledSite` (string, required)
    Scheduled site name.
    Example: "Example scheduledSite"

  - `items.status` (string, required)
    Appointment status.
    Enum: "NOT ARRIVED", "ARRIVED", "DID NOT ATTEND", "APPPOINTMENT CANCELLED", "CANCELLATION LIST", "DICTATION INPROGRESS", "DICTATED", "TYPED", "AUTHORISING", "AUTHORISED", "TYPING INPROGRESS", "PENDING REPORTING", "STUDY INPROGRESS", "SECOND REVIEW", "FINALISED", "REVIEW TYPED", "PEER REVIEW", "SECOND OPINION"

  - `items.appointmentDate` (string)
    Appointment date string as stored in QUBS.
    Example: "Example appointmentDate"

  - `items.startTime` (string)
    Scheduled start time string as stored in QUBS.
    Example: "Example startTime"

  - `items.endTime` (string)
    Scheduled end time string as stored in QUBS.
    Example: "Example endTime"

  - `items.modality` (string)
    Example: "Example modality"

  - `items.studyDescription` (string)
    Example: "Example description"

  - `nextToken` (null,string)
    Opaque continuation token to fetch the next page, when more results are available.
    Example: "Example nextToken"

## Response 400 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"

## Response 401 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"

## Response 403 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"

## Response 500 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"