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

# List passes [Beta]

`GET /passes`

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.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)