---
title: Elencare i prodotti
description: Elenco paginato dei prodotti (max 100/pagina), ordinati per createdAt desc. Filtra per categoria, stato (active/archived) o ricerca testuale su nome + modello.
canonical: "https://www.tracepass.eu/it/docs/list-products"
locale: it
source: "https://www.tracepass.eu/it/docs/list-products"
---

# Elencare i prodotti

> Elenco paginato dei prodotti (max 100/pagina), ordinati per createdAt desc. Filtra per categoria, stato (active/archived) o ricerca testuale su nome + modello.

```http
GET /api/v1/products
```

Elenco paginato di ogni prodotto posseduto dallo spazio di lavoro, ordinato per `createdAt` decrescente. Dimensione della pagina limitata a 100. Filtrate per slug di categoria, status (`active` / `archived`), oppure con una ricerca a testo libero su nome + model.

Conta come una lettura v1 sul contatore `maxV1PassportsPerDay` (il budget lato lettura — lo stesso contatore dell'endpoint di elenco passaporti). Le letture non vengono conteggiate sul budget di scrittura.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes. |
| `page` | query | number (default 1) | no | Numero di pagina su base 1. |
| `limit` | query | number (1-100, default 20) | no | Elementi per pagina. |
| `category` | query | string | no | Filtra per slug di categoria. |
| `status` | query | string | no | `active` o `archived`. |
| `search` | query | string | no | Ricerca a testo libero su nome e model. |

## Examples

```bash
curl -sS \
  "https://app.tracepass.eu/api/v1/products?category=batteries&page=1&limit=20" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const url = new URL("https://app.tracepass.eu/api/v1/products");
url.searchParams.set("category", "batteries");
url.searchParams.set("limit", "20");

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/products",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
    params={"category": "batteries", "limit": 20},
)
res.raise_for_status()
data = res.json()["data"]
```

## Responses

### 200 — OK

```json
{
  "data": {
    "items": [
      {
        "_id": "6650a1b2c3d4e5f6a7b8c9d0",
        "name": "Li-Ion 48V Battery Pack",
        "model": "BP-48V-100",
        "category": "batteries",
        "passportCount": 12,
        "status": "active",
        "createdAt": "2026-04-10T14:30:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}
```

## Related

- [Creare un prodotto](https://www.tracepass.eu/it/docs/create-product.md)
- [Leggere un singolo prodotto](https://www.tracepass.eu/it/docs/get-product.md)