# List catalog products for one product group

**GET** `/catalog/product-groups/{product_group_id}/products`

## Parameters

### `product_group_id` (_path_, required)

Product group id

- **Type:** `string`
- **Example:** `"12"`
- **Constraints:** pattern `^[1-9]\d*$`

### `delivery_country` (_query_, required)

ISO 3166-1 alpha-2 delivery country code (e.g. FR). Filters catalog by available_countries; cart line items must use a country allowed for the catalog product.

- **Type:** `string`
- **Example:** `"FR"`

## Responses

### 200

Catalog products available for one product group in the delivery country

**application/json**

_Schema ref:_ `#/components/schemas/ListCatalogProductsResponse` (ListCatalogProductsResponse)

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "has_keyboard": {
            "type": "boolean"
          },
          "img_url": {
            "type": "string",
            "nullable": true
          },
          "product_group_id": {
            "type": "integer",
            "nullable": true
          },
          "characteristics": {
            "type": "object",
            "properties": {
              "screen_size": {
                "type": "string",
                "nullable": true
              },
              "processor": {
                "type": "string",
                "nullable": true
              },
              "ram": {
                "type": "string",
                "nullable": true
              },
              "storage": {
                "type": "string",
                "nullable": true
              },
              "connectivity": {
                "type": "string",
                "nullable": true
              },
              "graphic": {
                "type": "string",
                "nullable": true
              },
              "weight": {
                "type": "number",
                "nullable": true
              },
              "quality": {
                "type": "string",
                "nullable": true
              },
              "noise_cancellation": {
                "type": "boolean",
                "nullable": true
              },
              "has_microphone": {
                "type": "boolean",
                "nullable": true
              },
              "connection_type": {
                "type": "array",
                "nullable": true,
                "items": {
                  "type": "string"
                }
              },
              "compliance": {
                "type": "array",
                "nullable": true,
                "items": {
                  "type": "string"
                }
              },
              "refresh_rate": {
                "type": "string",
                "nullable": true
              },
              "response_time": {
                "type": "string",
                "nullable": true
              },
              "screen_stand": {
                "type": "array",
                "nullable": true,
                "items": {
                  "type": "string"
                }
              },
              "definition": {
                "type": "string",
                "nullable": true
              },
              "equipment_sub_type": {
                "type": "string",
                "nullable": true
              },
              "battery_life": {
                "type": "string",
                "nullable": true
              },
              "optimized_to": {
                "type": "string",
                "nullable": true
              },
              "power": {
                "type": "string",
                "nullable": true
              },
              "has_stool": {
                "type": "boolean",
                "nullable": true
              },
              "has_video_package": {
                "type": "boolean",
                "nullable": true
              },
              "has_screen": {
                "type": "boolean",
                "nullable": true
              },
              "has_premium_tablet": {
                "type": "boolean",
                "nullable": true
              },
              "color": {
                "type": "string",
                "nullable": true
              },
              "seats_number": {
                "type": "string",
                "nullable": true
              },
              "assembly": {
                "type": "string",
                "nullable": true
              },
              "dimensions": {
                "type": "string",
                "nullable": true
              },
              "height": {
                "type": "string",
                "nullable": true
              },
              "has_power_plug": {
                "type": "boolean",
                "nullable": true
              },
              "has_adjustable_height": {
                "type": "boolean",
                "nullable": true
              },
              "has_cable_management": {
                "type": "boolean",
                "nullable": true
              },
              "has_wheels": {
                "type": "boolean",
                "nullable": true
              },
              "armrest": {
                "type": "string",
                "nullable": true
              },
              "lumbar_support": {
                "type": "string",
                "nullable": true
              },
              "length": {
                "type": "string",
                "nullable": true
              },
              "width": {
                "type": "string",
                "nullable": true
              },
              "has_webcam": {
                "type": "boolean",
                "nullable": true
              },
              "printer_characteristics": {
                "type": "object",
                "nullable": true,
                "properties": {
                  "scanner_type": {
                    "type": "string"
                  },
                  "paper_format": {
                    "type": "string"
                  },
                  "pages_per_month": {
                    "type": "string"
                  },
                  "has_maintenance_price": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "scanner_type",
                  "paper_format",
                  "pages_per_month",
                  "has_maintenance_price"
                ]
              },
              "printer_maintenance_prices": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "amount": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "string"
                        }
                      ]
                    },
                    "currency": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "amount",
                    "currency"
                  ]
                }
              },
              "product_phone_characteristics": {
                "type": "object",
                "nullable": true,
                "properties": {
                  "has_e_sim": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "has_e_sim"
                ]
              }
            },
            "required": [
              "screen_size",
              "processor",
              "ram",
              "storage",
              "connectivity",
              "graphic",
              "weight",
              "quality",
              "noise_cancellation",
              "has_microphone",
              "connection_type",
              "compliance",
              "refresh_rate",
              "response_time",
              "screen_stand",
              "definition",
              "equipment_sub_type",
              "battery_life",
              "optimized_to",
              "power",
              "has_stool",
              "has_video_package",
              "has_screen",
              "has_premium_tablet",
              "color",
              "seats_number",
              "assembly",
              "dimensions",
              "height",
              "has_power_plug",
              "has_adjustable_height",
              "has_cable_management",
              "has_wheels",
              "armrest",
              "lumbar_support",
              "length",
              "width",
              "has_webcam",
              "printer_characteristics",
              "printer_maintenance_prices",
              "product_phone_characteristics"
            ]
          },
          "keyboard_layouts": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "FRENCH_AZERTY",
                "SPANISH_QWERTY",
                "ITALIAN_QWERTY",
                "INTERNATIONAL_ENGLISH_QWERTY",
                "GERMAN_QWERTZ",
                "PORTUGUESE_QWERTY",
                "ENGLISH_QWERTY",
                "SWISS_QWERTZ",
                "AMERICAN_ENGLISH_QWERTY",
                "CANADIAN_ENGLISH_QWERTY",
                "DUTCH_QWERTY"
              ],
              "description": "Keyboard layout for delivery pricing (maps to Fleet keyboard_layouts.type)",
              "example": "FRENCH_AZERTY"
            }
          }
        },
        "required": [
          "id",
          "name",
          "has_keyboard",
          "img_url",
          "product_group_id",
          "characteristics",
          "keyboard_layouts"
        ]
      }
    }
  },
  "required": [
    "data"
  ]
}
```

### 400

Validation error

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ]
}
```

### 404

Resource not found

**application/json**

_Schema ref:_ `#/components/schemas/CatalogProductsNotFoundErrorResponse` (CatalogProductsNotFoundErrorResponse)

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "COMPANY_NOT_FOUND",
        "COUNTRY_NOT_FOUND",
        "DELIVERY_COUNTRY_NOT_FOUND",
        "PRODUCT_NOT_FOUND"
      ]
    }
  },
  "required": [
    "error"
  ]
}
```

## Security

```json
[
  {
    "bearerAuth": []
  }
]
```

**bearerAuth:** Bearer token using a Fleet platform API key (flt_sk_…).

---

_Generated from the OpenAPI specification for raw Markdown / tooling use._
