# Get a pending reporting appointment

Returns the tele reporting appointment view for the specified appointment when it is in the PENDING REPORTING status.

Returns 404 when the appointment is not found or is not in the PENDING REPORTING status.

Endpoint: GET /integrations/v1/{domain}/reporting/appointments/{appointmentId}
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"

  - `appointmentId` (string, required)
    Appointment identifier within the specified domain.
    Example: "A123456"

## Header parameters:

  - `X-Correlation-Id` (string)
    Request correlation identifier. Echoes the incoming X-Correlation-Id header when provided.
    Example: "4b7f0a91b4f54f2a"

## Response 200 fields (application/json):

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

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

  - `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"

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

  - `appointmentDate` (null,string)
    Appointment date (ISO 8601, yyyy-MM-dd) in the scheduled site's local timezone.
    Example: "2020-01-01"

  - `startTime` (null,string)
    Scheduled start time (ISO 8601, HH:mm:ss) in the scheduled site's local timezone.
    Example: "13:45:00"

  - `endTime` (null,string)
    Scheduled end time (ISO 8601, HH:mm:ss) in the scheduled site's local timezone.
    Example: "13:45:00"

  - `patientId` (string)
    Patient identifier when available.
    Example: "123"

  - `patientName` (string)
    Patient display name.
    Example: "Example Name"

  - `firstName` (string)
    Patient first name.
    Example: "Example Name"

  - `lastName` (string)
    Patient last name.
    Example: "Example Name"

  - `dateOfBirth` (null,string)
    Patient date of birth (ISO 8601, yyyy-MM-dd).
    Example: "2020-01-01"

  - `gender` (string)
    Patient gender/sex string as stored in QUBS.
    Example: "Example gender"

  - `modality` (string)
    Exam modality string as stored in QUBS.
    Example: "Example modality"

  - `studyDescription` (string)
    Study description as stored in QUBS.
    Example: "Example description"

  - `clinicalInfo` (string)
    Clinical information text as stored in QUBS.
    Example: "Example clinicalInfo"

  - `doctorName` (string)
    Referring doctor display name.
    Example: "Example Name"

  - `clinicName` (string)
    Referring clinic name when available.
    Example: "Example Name"

  - `priority` (string)
    Appointment/reporting priority string as stored in QUBS.
    Example: "Example priority"

  - `reportNeededBy` (null,string)
    Optional deadline timestamp for reporting (UTC, ISO 8601) when available.
    Example: "2020-01-01T00:00:00Z"

  - `studyInstanceUid` (string)
    PACS study instance UID when available.
    Example: "123"

  - `radiologistUser` (object)
    Radiologist user assigned to the appointment when available.

  - `radiologistUser.username` (string, required)
    User's unique username.
    Example: "Example Name"

  - `radiologistUser.firstName` (string)
    User's first name.
    Example: "Example Name"

  - `radiologistUser.initials` (string)
    User's initials when available.
    Example: "Example initials"

  - `radiologistUser.lastName` (string)
    User's last name.
    Example: "Example Name"

  - `radiologistUser.role` (string)
    User role when available.
    Example: "Example role"

  - `serviceItems` (array)
    Service items attached to the appointment.

  - `serviceItems.itemNo` (string, required)
    Service item number.
    Example: "Example itemNo"

  - `serviceItems.shortDescription` (string)
    Human-readable service item description.
    Example: "Example description"

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

  - `type` (string)
    Stable error type identifier (urn:qubs:integrations:...). For each response, the type matches the HTTP status.
    Enum: "urn:qubs:integrations:bad-request"

  - `title` (null,string)
    Short, human-readable summary of the error.
    Example: "Example title"

  - `status` (integer)
    HTTP status code for this error response.
    Example: 400

  - `detail` (null,string)
    Detailed description of the error.
    Example: "Example detail"

  - `instance` (null,string)
    Request path for this error.
    Example: "Example instance"

  - `requestId` (string)
    Request correlation identifier for support. Also returned as the X-Correlation-Id response header.
    Example: "4b7f0a91b4f54f2a"

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

  - `type` (string)
    Stable error type identifier (urn:qubs:integrations:...). For each response, the type matches the HTTP status.
    Enum: "urn:qubs:integrations:unauthorized"

  - `title` (null,string)
    Short, human-readable summary of the error.
    Example: "Example title"

  - `status` (integer)
    HTTP status code for this error response.
    Example: 401

  - `detail` (null,string)
    Detailed description of the error.
    Example: "Example detail"

  - `instance` (null,string)
    Request path for this error.
    Example: "Example instance"

  - `requestId` (string)
    Request correlation identifier for support. Also returned as the X-Correlation-Id response header.
    Example: "4b7f0a91b4f54f2a"

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

  - `type` (string)
    Stable error type identifier (urn:qubs:integrations:...). For each response, the type matches the HTTP status.
    Enum: "urn:qubs:integrations:forbidden"

  - `title` (null,string)
    Short, human-readable summary of the error.
    Example: "Example title"

  - `status` (integer)
    HTTP status code for this error response.
    Example: 403

  - `detail` (null,string)
    Detailed description of the error.
    Example: "Example detail"

  - `instance` (null,string)
    Request path for this error.
    Example: "Example instance"

  - `requestId` (string)
    Request correlation identifier for support. Also returned as the X-Correlation-Id response header.
    Example: "4b7f0a91b4f54f2a"

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

  - `type` (string)
    Stable error type identifier (urn:qubs:integrations:...). For each response, the type matches the HTTP status.
    Enum: "urn:qubs:integrations:not-found"

  - `title` (null,string)
    Short, human-readable summary of the error.
    Example: "Example title"

  - `status` (integer)
    HTTP status code for this error response.
    Example: 404

  - `detail` (null,string)
    Detailed description of the error.
    Example: "Example detail"

  - `instance` (null,string)
    Request path for this error.
    Example: "Example instance"

  - `requestId` (string)
    Request correlation identifier for support. Also returned as the X-Correlation-Id response header.
    Example: "4b7f0a91b4f54f2a"

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

  - `type` (string)
    Stable error type identifier (urn:qubs:integrations:...). For each response, the type matches the HTTP status.
    Enum: "urn:qubs:integrations:too-many-requests"

  - `title` (null,string)
    Short, human-readable summary of the error.
    Example: "Example title"

  - `status` (integer)
    HTTP status code for this error response.
    Example: 429

  - `detail` (null,string)
    Detailed description of the error.
    Example: "Example detail"

  - `instance` (null,string)
    Request path for this error.
    Example: "Example instance"

  - `requestId` (string)
    Request correlation identifier for support. Also returned as the X-Correlation-Id response header.
    Example: "4b7f0a91b4f54f2a"

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

  - `type` (string)
    Stable error type identifier (urn:qubs:integrations:...). For each response, the type matches the HTTP status.
    Enum: "urn:qubs:integrations:server-error"

  - `title` (null,string)
    Short, human-readable summary of the error.
    Example: "Example title"

  - `status` (integer)
    HTTP status code for this error response.
    Example: 500

  - `detail` (null,string)
    Detailed description of the error.
    Example: "Example detail"

  - `instance` (null,string)
    Request path for this error.
    Example: "Example instance"

  - `requestId` (string)
    Request correlation identifier for support. Also returned as the X-Correlation-Id response header.
    Example: "4b7f0a91b4f54f2a"