---
title: "Retrieve a list of all the guest passes sent from or received by a user"
method: GET
path: "/v1/guests/{guest_id}/guestpass"
---

# Retrieve a list of all the guest passes sent from or received by a user

`GET /v1/guests/{guest_id}/guestpass`

## Request

- Base URL: `https://api.zenoti.com`
- URL: `https://api.zenoti.com/v1/guests/{guest_id}/guestpass`
- Auth: none required
- TypeScript: <https://skmtc.dev/zenoti/apis/zenoti-authentication/docs/v1/guests/:guest_id/guestpass/get.ts> (a function with typed inputs; its response is checked against the schema)

The purpose of this API is to retrieve a list of all the guest passes sent from or received by a user. This includes Used, Received, and Available guest passes. You must specify the unique identifier of the guest who is sharing the guest pass `guest_id`, the item id for which the user wants to transfer to/receive from (default value would be null) `instrument_id`, the item type (default would be 1. 1: Membership) `instrument_type`, guest pass credit type (default would be 1. 1: Classes, 2: Visits, 0: Both) `credit_type`, type of user list the user requested (default would be 0. 0: Both, 1: Receiver, 2:Sender) `list_type`, and the expand parameter (expand[0]=available, expand[1]=received, expand[2]=used) `expand`.

## Query parameters

- `guest_id` string
- `instrument_id` string
- `instrument_type` integer
- `credit_type` ''
- `list_type` integer
- `expand` string[]

## Response `200`

200

---

[API](https://skmtc.dev/zenoti/apis/zenoti-authentication.md) - [All operations](https://skmtc.dev/zenoti/apis/zenoti-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/zenoti/apis/zenoti-authentication/revisions/e628f892391a?raw)