> ## 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.

# GET /project/{project_id}/get-catalog — List Catalogues

> Retrieve a paginated list of all product catalogues linked to your Convo project, with optional pagination and product-count filters.

Use this endpoint to retrieve all product catalogues linked to your Convo project. Results are paginated and can be filtered by product count.

## Endpoint

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

## 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="limit" type="integer">
  Maximum number of catalogues 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>

<ParamField query="productCount" type="integer">
  Filter catalogues by an exact product count. Omit this parameter to return catalogues regardless of product count.
</ParamField>

## Request Example

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

## Response

Returns a `catalogues` array containing catalogue objects.

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

  <Expandable title="Catalogue Object">
    <ResponseField name="_id" type="string">
      Internal database ID of the catalogue record.
    </ResponseField>

    <ResponseField name="catalogueId" type="string">
      The Meta catalogue ID as registered with your WhatsApp Business Account.
    </ResponseField>

    <ResponseField name="catalogueName" type="string">
      Display name of the catalogue.
    </ResponseField>

    <ResponseField name="productCount" type="integer">
      Total number of products in this catalogue.
    </ResponseField>

    <ResponseField name="feedCount" type="integer">
      Number of product feeds associated with this catalogue.
    </ResponseField>

    <ResponseField name="vertical" type="string">
      The product vertical/category for this catalogue (e.g., `"commerce"`, `"hotels"`).
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether this catalogue is currently active on your WhatsApp Business Account.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current sync/approval status of the catalogue.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Response

```json theme={null}
{
  "catalogues": [
    {
      "_id": "64b3e1a2c4f1a234560d1a2b",
      "catalogueId": "738763614338341",
      "catalogueName": "Summer Collection 2024",
      "productCount": 48,
      "feedCount": 2,
      "vertical": "commerce",
      "isActive": true,
      "status": "active"
    },
    {
      "_id": "64b3e1a2c4f1a234560d1a3c",
      "catalogueId": "849874625449452",
      "catalogueName": "Winter Essentials",
      "productCount": 22,
      "feedCount": 1,
      "vertical": "commerce",
      "isActive": false,
      "status": "pending"
    }
  ]
}
```

## Error Responses

| Status Code | Description                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------- |
| `500`       | Internal Server Error — An unexpected server-side error occurred. Retry the request or contact support. |