---
title: "Get available handoff options"
method: GET
path: "/v4/handoff/available-handoffs"
tags: ["Handoff V4"]
---

# Get available handoff options

`GET /v4/handoff/available-handoffs`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/v4/handoff/available-handoffs`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

Retrieves available users or queues that can receive a handoff for the specified criteria.

## Query parameters

- `isOnline` boolean
- `channelId` string
- `appointmentId` string
- `showAll` boolean

## Response `200`

Successfully retrieved available handoff options

- AvailableHandoffsDto
  - `users` HandoffUserInfo[], required: List of available users for handoff
    - `firstname` string, required: User first name
    - `lastname` string, required: User last name
    - `picture` string: User profile picture URL
    - `id` string, required: User ID
    - `blocked` 'not_available': Reason why user is blocked from handoff (if applicable)
  - `scope` 'workspace' | 'company', required: Whether the list is limited to the appointment workspace or spans the company

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)