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

# Products

> List and read products for your merchant account

## GET /v1/products

List products for the organization the API key belongs to.

### Request

```bash theme={null}
curl "https://merchant-api-prod.anyway.sh/v1/products?page=1&size=20&status=PUBLISHED" \
  -H "X-API-Key: ak_YOUR_API_KEY"
```

### Query Parameters

| Param    | Type    | Default     | Description                                           |
| -------- | ------- | ----------- | ----------------------------------------------------- |
| `page`   | integer | `1`         | Page number                                           |
| `size`   | integer | `20`        | Page size (max 100)                                   |
| `search` | string  | —           | Filter by name substring                              |
| `status` | string  | `PUBLISHED` | Lifecycle status: `PUBLISHED`, `DRAFT`, or `ARCHIVED` |

### Response

```json theme={null}
{
  "success": true,
  "message": "Products retrieved",
  "data": {
    "records": [
      {
        "id": "PRD25XWPQ8TN2VHK6",
        "name": "API Credits — Starter",
        "description": "1,000 API calls",
        "status": "PUBLISHED"
      }
    ],
    "total": 1,
    "page": 1,
    "size": 20,
    "pages": 1
  }
}
```

`description` is omitted when unset.

***

## GET /v1/products/:id

Get a single product.

### Request

```bash theme={null}
curl https://merchant-api-prod.anyway.sh/v1/products/PRD25XWPQ8TN2VHK6 \
  -H "X-API-Key: ak_YOUR_API_KEY"
```

### Path Parameters

| Param | Type   | Description                |
| ----- | ------ | -------------------------- |
| `id`  | string | The product ID to retrieve |

### Response

```json theme={null}
{
  "success": true,
  "message": "Product retrieved",
  "data": {
    "id": "PRD25XWPQ8TN2VHK6",
    "name": "API Credits — Starter",
    "description": "1,000 API calls",
    "status": "PUBLISHED"
  }
}
```

`status` is one of `PUBLISHED`, `DRAFT`, or `ARCHIVED`.

### Errors

| Status | Description                                                     |
| ------ | --------------------------------------------------------------- |
| `401`  | API key missing or invalid.                                     |
| `404`  | Product does not exist or does not belong to your organization. |