> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapace.lk/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](/pagination). List items don't include `fieldValues`. [Get the pass](/api-reference/passes/get) to read them.

<ParamField query="limit" type="integer" default="25">
  Items per page, from 1 to 100.
</ParamField>

<ParamField query="cursor" type="string">
  The `nextCursor` from the previous page.
</ParamField>

<ParamField query="templateId" type="string">
  Only passes issued from this template.
</ParamField>

<ParamField query="status" type="string">
  `active` or `voided`.
</ParamField>

<ParamField query="source" type="string">
  `api` for passes issued through the API, `dashboard` for passes issued in the dashboard.
</ParamField>

<ParamField query="search" type="string">
  Matches part of the holder's name, the holder's email or the pass's `shortId`, ignoring case.
</ParamField>

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

<ResponseExample>
  ```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",
        "platforms": { "apple": true, "google": true },
        "signing": {
          "appleCertificateId": "demo",
          "applePassTypeIdentifier": null,
          "googleIssuerId": "demo"
        },
        "distributionUrl": "https://pass.tapace.lk/6BkJLsso1xyB",
        "createdAt": "2026-10-13T10:00:00.000Z",
        "updatedAt": "2026-10-13T10:00:00.000Z",
        "voidedAt": null
      }
    ],
    "hasMore": false,
    "nextCursor": null
  }
  ```
</ResponseExample>


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