# QUBS Integrations API

Partner-facing API providing read-only access to selected QUBS configuration and scheduling data for integration purposes.

Authentication is via a bearer JWT in the `Authorization` header. Authorization is domain-scoped; all requests include a `{domain}` path parameter.

Errors are returned as RFC7807 Problem Details (`application/problem+json`).

Version: v1

## Servers

Relative to the current host
```
/
```

## Security

### Bearer

JWT bearer token

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[QUBS Integrations API](https://partners.qubs.io/_bundle/openapi.yaml)

## Site Settings

Partner-facing endpoints for listing sites and retrieving site configuration within a domain.

### List sites in the specified partner domain

 - [GET /integrations/v1/{domain}/sites](https://partners.qubs.io/openapi/site-settings/integrations_listsites.md): Returns the active sites a partner is allowed to access within a domain after authorization succeeds.

### Get site settings summary by domain and site name

 - [GET /integrations/v1/{domain}/sites/{siteName}](https://partners.qubs.io/openapi/site-settings/integrations_getsitesettings_summary.md): Returns the site settings summary view for a specific site when the caller is authorized for the requested domain and site.

### Get operational site settings by domain and site name

 - [GET /integrations/v1/{domain}/sites/{siteName}/operational](https://partners.qubs.io/openapi/site-settings/integrations_getsitesettings_operational.md): Returns the operational site settings view for a specific site when the caller is authorized for the requested domain and site.

## Exam Codes

Partner-facing endpoints for retrieving exam code configuration for a site within a domain.

### List exam codes for a site

 - [GET /integrations/v1/{domain}/sites/{siteName}/exam-codes](https://partners.qubs.io/openapi/exam-codes/integrations_listexamcodes.md): Returns exam codes for the specified domain and site when the caller is authorized.

## Staff Skills

Partner-facing endpoints for retrieving the staff skill grid and related metadata for a site within a domain.

### Get staff skill grid for a site

 - [GET /integrations/v1/{domain}/sites/{siteName}/staff-skills](https://partners.qubs.io/openapi/staff-skills/integrations_getstaffskills.md): Returns the staff skills grid, exam mappings, and comments for the specified domain and site when authorized.

## Appointments

Partner-facing endpoints for retrieving appointments within a domain.

### List operational appointments by status

 - [GET /integrations/v1/{domain}/appointments/operational/by-status/{status}](https://partners.qubs.io/openapi/appointments/integrations_listappointmentsbystatus_operational.md): Returns the operational appointment view filtered by status when the caller is authorized. Supports cursor-based pagination via pageSize and nextToken.

### Get operational appointment by domain and appointment id

 - [GET /integrations/v1/{domain}/appointments/operational/{appointmentId}](https://partners.qubs.io/openapi/appointments/integrations_getappointment_operational.md): Returns the operational appointment view for the specified domain and appointment id when the caller is authorized.

### List operational appointments for a domain

 - [GET /integrations/v1/{domain}/appointments/operational](https://partners.qubs.io/openapi/appointments/integrations_listappointments_operational.md): Returns the operational appointment view for the specified domain when the caller is authorized. Supports optional filters via query string and offset paging via skip and take.

### List appointment summaries by status

 - [GET /integrations/v1/{domain}/appointments/by-status/{status}](https://partners.qubs.io/openapi/appointments/integrations_listappointmentsbystatus_summary.md): Returns the appointment summary view filtered by status when the caller is authorized. Supports cursor-based pagination via pageSize and nextToken.

### Get appointment summary by domain and appointment id

 - [GET /integrations/v1/{domain}/appointments/{appointmentId}](https://partners.qubs.io/openapi/appointments/integrations_getappointment_summary.md): Returns the appointment summary view for the specified domain and appointment id when the caller is authorized.

### List appointment summaries for a domain

 - [GET /integrations/v1/{domain}/appointments](https://partners.qubs.io/openapi/appointments/integrations_listappointments_summary.md): Returns the appointment summary view for the specified domain when the caller is authorized. Supports optional filters via query string and offset paging via skip and take.

## Attachments

Partner-facing endpoints for retrieving appointment attachments and generating short-lived presigned URLs.

### List attachments for an appointment

 - [GET /integrations/v1/{domain}/appointments/{appointmentId}/attachments](https://partners.qubs.io/openapi/attachments/integrations_listappointmentattachments.md): Returns appointment attachments (e.g. referrals, worksheets) and a short-lived presigned URL for each attachment when available.

### Get a single attachment for an appointment

 - [GET /integrations/v1/{domain}/appointments/{appointmentId}/attachments/{attachmentGuid}](https://partners.qubs.io/openapi/attachments/integrations_getappointmentattachment.md): Returns a single appointment attachment and a short-lived presigned URL when available.

## Comments

Partner-facing endpoints for retrieving appointment and patient comments/alerts associated with an appointment.

### List comments for an appointment

 - [GET /integrations/v1/{domain}/appointments/{appointmentId}/comments](https://partners.qubs.io/openapi/comments/integrations_listappointmentcomments.md): Returns all appointment comments/alerts plus patient comments/alerts for the appointment's patient when the caller is authorized.

### Get a single comment for an appointment

 - [GET /integrations/v1/{domain}/appointments/{appointmentId}/comments/{commentGuid}](https://partners.qubs.io/openapi/comments/integrations_getappointmentcomment.md): Returns a single appointment comment/alert or patient comment/alert (for the appointment's patient) when the caller is authorized.

## Patients

Partner-facing endpoints for retrieving patients within a domain.

### Get patient summary by domain and patient id

 - [GET /integrations/v1/{domain}/patients/{patientId}](https://partners.qubs.io/openapi/patients/integrations_getpatient_summary.md): Returns the patient summary view for the specified domain and patient id when the caller is authorized.

### List patient summaries for a domain

 - [GET /integrations/v1/{domain}/patients](https://partners.qubs.io/openapi/patients/integrations_listpatients_summary.md): Returns the patient summary view for the specified domain when the caller is authorized. Supports optional filters via query string and offset paging via skip and take.

## Reporting

Partner-facing endpoints for retrieving appointments that are pending reporting.

### List pending reporting appointments

 - [GET /integrations/v1/{domain}/reporting/appointments/pending](https://partners.qubs.io/openapi/reporting/integrations_listpendingreportingappointments.md): Returns the tele reporting appointment view for appointments in the PENDING REPORTING status. Supports cursor-based pagination via pageSize and nextToken.

### List attachments for a pending reporting appointment

 - [GET /integrations/v1/{domain}/reporting/appointments/{appointmentId}/attachments](https://partners.qubs.io/openapi/reporting/integrations_listpendingreportingappointmentattachments.md): Returns appointment attachments (e.g. referrals, worksheets) for the specified appointment when it is in the PENDING REPORTING status.

### Get a single attachment for a pending reporting appointment

 - [GET /integrations/v1/{domain}/reporting/appointments/{appointmentId}/attachments/{attachmentGuid}](https://partners.qubs.io/openapi/reporting/integrations_getpendingreportingappointmentattachment.md): Returns a single appointment attachment for the specified appointment when it is in the PENDING REPORTING status.

### List comments for a pending reporting appointment

 - [GET /integrations/v1/{domain}/reporting/appointments/{appointmentId}/comments](https://partners.qubs.io/openapi/reporting/integrations_listpendingreportingappointmentcomments.md): Returns appointment comments/alerts plus patient comments/alerts for the specified appointment when it is in the PENDING REPORTING status.

### Get a single comment for a pending reporting appointment

 - [GET /integrations/v1/{domain}/reporting/appointments/{appointmentId}/comments/{commentGuid}](https://partners.qubs.io/openapi/reporting/integrations_getpendingreportingappointmentcomment.md): Returns a single appointment comment/alert or patient comment/alert (for the appointment's patient) when the appointment is in the PENDING REPORTING status.