---
title: Списък на паспортите
description: Странициран списък на паспортите. Филтриране по productId, статус или free-text търсене по GTIN + сериен номер. Брои се срещу дневния бюджет за четене.
canonical: "https://www.tracepass.eu/bg/docs/list-passports"
locale: bg
source: "https://www.tracepass.eu/bg/docs/list-passports"
---

# Списък на паспортите

> Странициран списък на паспортите. Филтриране по productId, статус или free-text търсене по GTIN + сериен номер. Брои се срещу дневния бюджет за четене.

```http
GET /api/v1/passports
```

Пагиниран списък на паспортите в работното пространство. Филтрирайте по `productId`, `status` или free-text търсене по GTIN и сериен номер. Брои се срещу дневния бюджет за четене на паспорти (`maxV1PassportsPerDay`); елементите на отговора използват същата форма като endpoint-а за единично четене, но скъсена до полетата за списъка.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — или `tp_` API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes. |
| `page` | query | number (default 1) | no | 1-базиран номер. |
| `limit` | query | number (1-100, default 20) | no | Елементи на страница. |
| `productId` | query | ObjectId | no | Филтър по продукт. |
| `status` | query | enum | no | `draft`, `in_review`, `approved`, `published`, `suspended`, `expired`, `archived`. |
| `search` | query | string | no | Free-text по GTIN + сериен. |

## Examples

```bash
curl -sS \
  "https://app.tracepass.eu/api/v1/passports?status=published&limit=50" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const url = new URL("https://app.tracepass.eu/api/v1/passports");
url.searchParams.set("status", "published");
url.searchParams.set("limit", "50");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` },
});
const { data } = await res.json();
```

```python
import os, requests
res = requests.get(
    "https://app.tracepass.eu/api/v1/passports",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
    params={"status": "published", "limit": 50},
)
res.raise_for_status()
items = res.json()["data"]["items"]
```

## Responses

### 200 — OK

```json
{
  "data": {
    "items": [
      {
        "_id": "6650b2c3d4e5f6a7b8c9d0e1",
        "productId": "6650a1b2c3d4e5f6a7b8c9d0",
        "gs1": {
          "gtin": "04012345000016",
          "serialNumber": "BP-48V-100-000001",
          "digitalLinkUri": "https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"
        },
        "status": "published",
        "completionPercentage": 87,
        "publishedAt": "2026-04-11T10:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 50,
    "totalPages": 1
  }
}
```

## Related

- [Прочитане на паспорт](https://www.tracepass.eu/bg/docs/get-passport.md)
- [Създаване на паспорт](https://www.tracepass.eu/bg/docs/create-passport.md)