# Get Next available group appointment time

Endpoint: GET /next_available_group_appointment
Version: v1
Security: x-api-key, A-api-key

## Query parameters:

  - `from` (string, required)

  - `to` (string, required)

  - `appointment_type_id` (integer, required)

  - `business_ids` (array)

  - `practitioner_ids` (array)

  - `profession_ids` (array)

## Response 200 fields (application/json):

  - `available_times` (array)

  - `available_times.appointment_id` (integer)

  - `available_times.current_class_size` (integer)

  - `available_times.max_class_size` (integer)

  - `available_times.app_time` (string)

  - `available_times.column_number` (integer)

  - `available_times.item_id` (integer)

  - `available_times.item_group_id` (integer)

  - `available_times.hourly_billing` (boolean)

  - `available_times.ndis_claim_type` (string)

  - `available_times.ndis_cancellation_reason` (string)

  - `available_times.appointment_type_id` (integer)

  - `available_times.practitioner_business_id` (integer)

  - `available_times.practitioner_id` (integer)

  - `available_times.business_id` (integer)

  - `available_times.profession_id` (integer)

  - `available_times.width` (integer)

  - `available_times.duration` (integer)

  - `available_times.resource_ids` (array)

  - `available_times.practitioner_name` (string)

  - `total_entries` (integer)

  - `links` (object)

  - `links.self` (string)
    Example: "https://api.pracsuite.com/v1/next_available_group_appointment?page=2&appointment_type_id=1&from=2025-01-01&to=2025-01-07"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.status` (integer, required)
    Example: 400

  - `error.code` (string, required)
    Example: "INVALID_PARAMS"

  - `error.title` (string, required)
    Example: "Invalid Params"

  - `error.detail` (string)
    Human readable explanation of the error
    Example: "One or more request parameters are invalid."

  - `request_id` (string, required)
    Example: "00000000-0000-0000-0000-000000000000"

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.status` (integer, required)
    Example: 403

  - `error.code` (string, required)
    Example: "UNAUTHORIZED"

  - `error.title` (string, required)
    Example: "Unauthorised"

  - `error.detail` (string)
    Human readable explanation of the error
    Example: "Access could not be verified for this request."

  - `request_id` (string, required)
    Example: "00000000-0000-0000-0000-000000000000"

## Response 403 fields (application/json):

  - `error` (object, required)

  - `error.status` (integer, required)
    Example: 403

  - `error.code` (string, required)
    Example: "MISSING_AUTHENTICATION_TOKEN"

  - `error.title` (string, required)
    Example: "Unauthorised"

  - `error.detail` (string)
    Human readable explanation of the error
    Example: "Authentication token is missing or the requested endpoint does not exist"

  - `request_id` (string, required)
    Example: "00000000-0000-0000-0000-000000000000"

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.status` (integer, required)
    Example: 500

  - `error.code` (string, required)
    Example: "SERVER_ERROR"

  - `error.title` (string, required)
    Example: "Server Error"

  - `error.detail` (string)
    Human readable explanation of the error
    Example: "An unexpected error occurred while processing your request. Please try again in a few minutes. If it keeps happening, contact support with Request ID: 00000000-0000-0000-0000-000000000000."

  - `request_id` (string, required)
    Example: "00000000-0000-0000-0000-000000000000"