# GET /catalogs/{{catalogId}}/products — List Products

> Product: **Pabbly Chatflow** (v1)
> Base URL: `https://chatflow.pabbly.com/api/v1`
> Auth: Bearer via `Authorization` header
> Canonical: `/chatflow/catalogs/list-products`

Fetch all products under a specific catalog. Products are returned as flat items (variants unwound). Path Parameters:

**Path parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| catalogId | string | Yes |  |

**Query parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| page | integer | No |  |
| limit | integer | No |  |
| search | string | No |  |

**Response (200)** — List Products:

```json
{
  "success": true,
  "message": "Products fetched successfully",
  "data": {
    "products": [
      {
        "productId": "789012345678XXXX",
        "retailerId": "SKU-TSHIRT-001",
        "retailerProductGroupId": "GROUP-TSHIRT",
        "catalogId": "123456789012XXXX",
        "name": "Classic T-Shirt - Blue - Large",
        "description": "Premium cotton t-shirt, comfortable fit",
        "price": "2999",
        "salePrice": "2499",
        "currency": "INR",
        "availability": "in stock",
        "status": "active",
        "imageUrl": "https://example.com/images/tshirt-blue-l.jpg",
        "url": "https://example.com/products/tshirt-blue-l",
        "brand": "MyBrand",
        "condition": "new"
      },
      {
        "productId": "789012345678XXXX",
        "retailerId": "SKU-TSHIRT-002",
        "retailerProductGroupId": "GROUP-TSHIRT",
        "catalogId": "123456789012XXXX",
        "name": "Classic T-Shirt - Red - Medium",
        "description": "Premium cotton t-shirt, comfortable fit",
        "price": "2999",
        "salePrice": null,
        "currency": "INR",
        "availability": "in stock",
        "status": "active",
        "imageUrl": "https://example.com/images/tshirt-red-m.jpg",
        "url": "https://example.com/products/tshirt-red-m",
        "brand": "MyBrand",
        "condition": "new"
      }
    ],
    "catalogId": "123456789012XXXX",
    "catalogName": "Fashion Store",
    "pagination": {
      "totalResults": 150,
      "totalPages": 8,
      "currentPage": 1,
      "limit": 20,
      "hasNextPage": true,
      "hasPrevPage": false
    }
  }
}
```

**Code examples:**

_cURL_

```curl
curl https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}} \
  -H "Authorization: Bearer {{YOUR_API_KEY}}"
```

_Ruby_

```ruby
require 'net/http'
require 'json'

uri = URI('https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer {{YOUR_API_KEY}}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

data = JSON.parse(response.body)
```

_Python_

```python
import requests

response = requests.get(
    'https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}',
    headers={'Authorization': 'Bearer {{YOUR_API_KEY}}'},
)

data = response.json()
```

_PHP_

```php
<?php
$ch = curl_init('https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer {{YOUR_API_KEY}}']);

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
```

_Java_

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}"))
    .header("Authorization", "Bearer {{YOUR_API_KEY}}")
    .GET();

HttpRequest request = builder.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

_Node.js_

```node
const response = await fetch('https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{YOUR_API_KEY}}',
  },
});

const data = await response.json();
```

_Go_

```go
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}", nil)
    req.Header.Set("Authorization", "Bearer {{YOUR_API_KEY}}")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
```

_.NET_

```dotnet
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://chatflow.pabbly.com/api/v1/catalogs/{{catalogId}}/products?page={{page}}&limit={{limit}}&search={{search}}");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer {{YOUR_API_KEY}}");

var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);
```

---

**Other endpoints in Catalogs:**

- [GET /catalogs — List Catalogs](/chatflow/catalogs/list-catalogs)