---
title: "List product families"
method: GET
path: "/api/v1/product_families"
tags: ["Product Families"]
---

# List product families

`GET /api/v1/product_families`

## Query parameters

- `order_by` string
- `page` integer
- `per_page` integer
- `search` string

## Response `200`

List of product families

- ProductFamilyListResponse
  - `data` ProductFamily[], required
    - `id` string, MeteroidId, required
    - `name` string, required
  - `pagination_meta` PaginationResponse, required
    - `page` integer, required
    - `per_page` integer, required
    - `total_items` integer, required
    - `total_pages` integer, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `429` — Too many requests
- `500` — Internal error

## Changes

- **2026-03-30** (v1) `5cb340234766` — 1 info
  - added the new optional `query` request parameter `order_by`
- **2026-03-27** (v1) `de35c02bb0d2` — 1 info
  - added the non-success response with the status `429`
- **2026-01-21** (v1) `9fba45d198be` — 2 info
  - api tag `Product Families` added
  - api tag `Product Family` removed
- **2026-01-20** (v1) `665f680338b5` — 2 info
  - api tag `Product Family` added
  - api tag `product_family` removed
- **2025-12-17** (v1) `2244ec0dabe3` — 1 info
  - added the new optional `query` request parameter `search`

[Full history](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/product_families/get.md)

---

[API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.dev/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/03f9d8ae5c5e/schema)