> ## Documentation Index
> Fetch the complete documentation index at: https://doc.convo.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# List and Paginate Products in a Convo Catalogue

> GET /project/{project_id}/get-catalog-products — Retrieve a paginated list of products in a specific catalogue, with status and availability details.

Use this endpoint to retrieve all products within a specific catalogue. Results are paginated and can be filtered by product status.

## Endpoint

```text theme={null}
GET https://connect.api-wa.co/project-apis/v1/project/{project_id}/get-catalog-products
```

## Authentication

```text theme={null}
X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD
```

## Path Parameters

<ParamField path="project_id" type="string" required>
  Your Convo project ID.
</ParamField>

## Query Parameters

<ParamField query="catalogId" type="string" required>
  The ID of the catalogue whose products you want to retrieve. You can obtain catalogue IDs from the [List Catalogues](/api-reference/catalogue/get-catalogue) endpoint.
</ParamField>

<ParamField query="status" type="boolean">
  Filter products by their active status. Pass `true` to return only active products, or `false` to return only inactive products. Omit to return all products regardless of status.
</ParamField>

<ParamField query="limit" type="integer">
  Number of products to return per page. Defaults to `20`.
</ParamField>

<ParamField query="skip" type="integer">
  Number of records to skip for offset-based pagination. Defaults to `0`.
</ParamField>

## Request Example

```bash theme={null}
curl "https://connect.api-wa.co/project-apis/v1/project/YOUR_PROJECT_ID/get-catalog-products?catalogId=738763614338341&limit=20&skip=0" \
  -H "X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD"
```

## Response

Returns a `catalogueProducts` array containing product objects for the specified catalogue.

<ResponseField name="catalogueProducts" type="array">
  Array of product objects. Each object contains:

  <Expandable title="Product Object">
    <ResponseField name="_id" type="string">
      Internal database ID of the product record in Convo.
    </ResponseField>

    <ResponseField name="productId" type="string">
      The Meta product ID as registered in the catalogue.
    </ResponseField>

    <ResponseField name="productName" type="string">
      The display name of the product.
    </ResponseField>

    <ResponseField name="price" type="string">
      The product price in the smallest currency unit (e.g., `"89900"` = ₹899.00).
    </ResponseField>

    <ResponseField name="currency" type="string">
      The ISO 4217 currency code for the price (e.g., `"INR"`, `"USD"`).
    </ResponseField>

    <ResponseField name="description" type="string">
      The product description text.
    </ResponseField>

    <ResponseField name="imageUrl" type="string">
      URL of the product's image.
    </ResponseField>

    <ResponseField name="retailerId" type="string">
      Your unique product SKU or identifier.
    </ResponseField>

    <ResponseField name="availability" type="string">
      Inventory availability status (e.g., `"in stock"`, `"out of stock"`).
    </ResponseField>

    <ResponseField name="condition" type="string">
      Product condition (e.g., `"new"`, `"refurbished"`, `"used"`).
    </ResponseField>

    <ResponseField name="status" type="boolean">
      Whether the product is currently active (`true`) or inactive (`false`).
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 timestamp of when the product record was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Response

```json theme={null}
{
  "catalogueProducts": [
    {
      "_id": "64b3e1a2c4f1a234560d2e5a",
      "productId": "4812039481203",
      "productName": "Classic Leather Watch",
      "price": "89900",
      "currency": "INR",
      "description": "Elegant leather-strap watch with a stainless steel case. Water-resistant to 50m.",
      "imageUrl": "https://example.com/images/classic-leather-watch.jpg",
      "retailerId": "WATCH-CLW-001",
      "availability": "in stock",
      "condition": "new",
      "status": true,
      "updatedAt": "2024-01-07T10:30:00.000Z"
    },
    {
      "_id": "64b3e1a2c4f1a234560d2e6b",
      "productId": "4812039481204",
      "productName": "Sport Chronograph",
      "price": "54900",
      "currency": "INR",
      "description": "Professional sport watch with tachymeter bezel and co-axial movement.",
      "imageUrl": "https://example.com/images/sport-chronograph.jpg",
      "retailerId": "WATCH-SCH-001",
      "availability": "in stock",
      "condition": "new",
      "status": true,
      "updatedAt": "2024-01-06T08:15:00.000Z"
    }
  ]
}
```