---
title: "List passes [Beta]"
method: GET
path: "/passes"
---

# List passes \[Beta\]

`GET /passes`

## Request

- Base URL: `https://api.sandbox.cleeng.com/3.1`
- URL: `https://api.sandbox.cleeng.com/3.1/passes`
- Auth: API key in header `X-Publisher-Token`

This endpoint returns passes that match the specified criteria (`transactionId`, `paymentMethodId`, `externalId`, `customerId` or `offerId` and `customerId` together). Please bear in mind that if you don't provide any parameters, an empty list will be returned. <br><br> **Note:** Filtering by `customerId` and `offerId` might return multiple active passes instead of one if [multiple passes have been created for the same offer](https://developers.cleeng.com/docs/externally-managed-passes#multiple-passes-per-offer).

## Query parameters

- `transactionId` string
- `customerId` integer
- `offerId` string
- `paymentMethodId` integer
- `externalId` string
- `offset` integer

## Headers

- `Content-Type` string

## Response `200`

200

- object[]
  - `passId` integer
  - `customerId` integer
  - `status` string
  - `offerId` string
  - `expiresAt` unknown
  - `paymentMethodId` integer
  - `externalId` string
  - `externalProperties` object
    - `property1` string
    - `property2` string
  - `isExternallyManaged` boolean
  - `source` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/cleeng/apis/api-31.md) - [All operations](https://skmtc.dev/cleeng/apis/api-31/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/api-31/revisions/df55396cda4f?raw)