> ## Documentation Index
> Fetch the complete documentation index at: https://tapace.lk/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List passes

> Returns the passes in your environment, newest first.

Results are [paginated](https://tapace.lk/docs/pagination.md). List items don't include `fieldValues`, `featuredActions`, `relevance`, `stamps` or `points`. [Get the pass](https://tapace.lk/docs/api-reference/passes/get.md) to read them.

**limit** `integer` (default: 25)

Items per page, from 1 to 100.

**cursor** `string`

The `nextCursor` from the previous page.

**templateId** `string`

Only passes issued from this template.

**status** `string`

`active` or `voided`.

**source** `string`

`api` for passes issued through the API, `dashboard` for passes issued in the dashboard.

**externalId** `string`

Only passes with exactly this `externalId`, for example every pass of one of your customers. Matching is case-sensitive.

**search** `string`

Matches part of the holder's name, the holder's email or the pass's `shortId`, ignoring case.

```bash cURL theme={null}
curl "https://api.tapace.lk/v1/passes?externalId=cus_8812&status=active" \
  -H "Authorization: Bearer $TAPACE_API_KEY"
```

```json 200 theme={null}
{
  "object": "list",
  "data": [
    {
      "object": "pass",
      "id": "pass_7hGk2LmQ9xVt4RnB8cYe",
      "shortId": "6BkJLsso1xyB",
      "templateId": "tmpl_Q4vN8xT2mLr7KpZs3Wd1",
      "templateName": "Gold membership",
      "templateRevision": 3,
      "environment": "test",
      "status": "active",
      "source": "api",
      "holderName": "Nimal Perera",
      "holderEmail": "nimal@example.com",
      "externalId": "cus_8812",
      "metadata": { "plan": "gold" },
      "platforms": { "apple": true, "google": true },
      "signing": {
        "appleCertificateId": "demo",
        "applePassTypeIdentifier": null,
        "googleIssuerId": "demo"
      },
      "distributionUrl": "https://tapace.lk/p/6BkJLsso1xyB",
      "appleDownloadUrl": "https://tapace.lk/p/6BkJLsso1xyB/apple",
      "googleSaveUrl": "https://tapace.lk/p/6BkJLsso1xyB/google",
      "presence": {
        "apple": { "activeDevices": 1 },
        "google": { "observedState": "saved" }
      },
      "createdAt": "2026-10-13T10:00:00.000Z",
      "updatedAt": "2026-10-13T10:00:00.000Z",
      "voidedAt": null
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.