---
title: "List all product lines"
method: GET
path: "/ext/v2/product-lines/"
tags: ["Catalog"]
---

# List all product lines

`GET /ext/v2/product-lines/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/product-lines/`
- Auth: HTTP bearer

Returns a list of all catalog product lines. The product lines are sorted by creation date, with the most recent product lines appearing first. When using modified filters, results are sorted in descending modification date instead.

A **product line** is the top level of the catalog hierarchy, representing a brand or product family (e.g., "Heartgard Plus"). Each product line contains one or more products, and is associated with a manufacturer and category.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.

## Response `200`

OK

- ExternalProductLineSchemaList
  - `data` ExternalProductLineSchema[], required: A single page of data contained within this list.
    - `alt_image_url` string, nullable: Alternative URL to the product line's image
    - `brand_name` string, required: The brand name of the product line.
    - `created` string, date-time, required: The datetime this object was created.
    - `description` string, nullable, required: A description of the Product Line, if available
    - `grouping` string, nullable, required: Indicates whether the Product Line is a prescription item or OTC item
    - `id` integer, required: Unique identifier for the product line.
    - `image_url` string, nullable: URL to the product line's image
    - `manufacturer_id` integer, required: ID of the manufacturer that produces this product line.
    - `manufacturer_name` string, required: The manufacturer of the Product Line
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `prescription_required` boolean, required: Indicates whether the Product Line requires a prescription
    - `primary_category_name` string, nullable: The primary product category this product line belongs to.
    - `refrigeration_required` boolean, required: Indicates whether the Product Line requires refrigeration
    - `secondary_category_names` string[], nullable: Additional product categories this product line belongs to.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)