> ## Documentation Index
> Fetch the complete documentation index at: https://convo.co.in/docs/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

**project\_id** `string` *required*

Your Convo project ID.

## Query Parameters

**limit** `integer`

Maximum number of catalogues to return per page. Defaults to `20`.

**skip** `integer`

Number of records to skip for offset-based pagination. Defaults to `0`.

**productCount** `integer`

Filter catalogues by an exact product count. Omit this parameter to return catalogues regardless of product count.

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

**catalogues** `array`

Array of catalogue objects. Each object contains:

**Catalogue Object**

**\_id** `string`

Internal database ID of the catalogue record.

**catalogueId** `string`

The Meta catalogue ID as registered with your WhatsApp Business Account.

**catalogueName** `string`

Display name of the catalogue.

**productCount** `integer`

Total number of products in this catalogue.

**feedCount** `integer`

Number of product feeds associated with this catalogue.

**vertical** `string`

The product vertical/category for this catalogue (e.g., `"commerce"`, `"hotels"`).

**isActive** `boolean`

Whether this catalogue is currently active on your WhatsApp Business Account.

**status** `string`

Current sync/approval status of the catalogue.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.