# Fetch Products

Products are the core entities in your Fynd Commerce catalog, representing the items you sell across various sales channels. Each product contains essential information such as name, brand, category, pricing, inventory, and size variants (SKUs). The product structure in Fynd follows a parent-child model where the product is the parent and sizes/variants are children, enabling efficient management of multi-variant products.

The Fetch Products endpoint retrieves product listings from your company's catalog with comprehensive details including identifiers, brand information, size variants, and metadata. Use this API to access product data for inventory verification, catalog synchronization, reporting, or building custom integrations. The endpoint supports flexible querying by name, slug, item code, or sorting preferences, along with pagination for handling large product catalogs.

> **Request Type:** `GET`
**Scheme:** `HTTPS`
**Endpoint:** `https://{{host}}/v3/catalog/product`


Try out Fynd Konnect's Fetch Products Endpoint
br
**Common Request Headers**

| Header | Mandatory | Description |
|  --- | --- | --- |
| `x-access-token` | Yes | Access token used for authenticating API requests to Fynd Konnect |
| `Content-Type` | Yes | `application/json` |


Use Cases
* Retrieve recently created or modified products for catalog synchronization
* Search for specific products by name, slug, or item code
* Verify product data after creation or updates
* Export product listings for reporting or analytics
* Build custom product discovery or search interfaces
* Validate SKU and identifier mappings across systems


### Query Parameters

Query Tips
* Use `sort_on=modified_on` (default) to get recently updated products first
* Use `name` for fuzzy product search across your catalog
* Use `slug` for exact product lookups when you have the unique identifier
* Use `item_code` with comma-separated values to fetch multiple products efficiently
* Implement pagination for catalogs with thousands of products


### Success Response

### API Call Example

### Example Response


```json
{
  "items": [
    {
      "id": "prod_12345",
      "name": "Berry Blast Drink",
      "slug": "berry-blast-drink-12292868",
      "item_code": "BRYBLAST",
      "brand_name": "Tally",
      "brand_uid": 318057,
      "category": "Fruit Juices & Fruit Drinks",
      "departments": ["5957"],
      "is_active": true,
      "currency": "INR",
      "country_of_origin": "India",
      "all_sizes": [
        {
          "size": "1L",
          "seller_identifier": "8904578390999",
          "price": 50,
          "price_effective": 45,
          "track_inventory": true,
          "identifiers": [
            {
              "gtin_type": "sku_code",
              "gtin_value": "8904578390999",
              "primary": true
            }
          ]
        }
      ],
      "seller_identifier": "seller_12345",
      "created_at": "2025-01-15T10:30:00Z",
      "modified_on": "2025-01-15T15:45:00Z"
    },
    {
      "id": "prod_67890",
      "name": "Air Coolers",
      "slug": "aircoolers-12337395",
      "item_code": "AIRCOOL",
      "brand_name": "Generic",
      "brand_uid": 6994,
      "category": "Air Coolers",
      "departments": ["5956"],
      "is_active": true,
      "currency": "INR",
      "country_of_origin": "India",
      "all_sizes": [
        {
          "size": "2TON",
          "seller_identifier": "890457830999",
          "price": 25000,
          "price_effective": 22000,
          "track_inventory": true,
          "identifiers": [
            {
              "gtin_type": "sku_code",
              "gtin_value": "890457830999",
              "primary": true
            }
          ]
        }
      ],
      "seller_identifier": "890457830999",
      "created_at": "2025-09-28T16:00:07Z",
      "modified_on": "2025-09-28T16:00:07Z"
    }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 25
}
```

## Understanding Product Structure

#### Parent-Child Model

- **Product (Parent)**: Contains common attributes like name, brand, category, and description
- **Sizes/Variants (Children)**: Each size is a unique SKU with its own identifiers, pricing, and inventory


#### Identifiers Hierarchy

Each size variant can have multiple identifiers:

- **Primary Identifier**: The main SKU code used for inventory and order management (marked with `primary: true`)
- **Secondary Identifiers**: Additional codes like EAN, UPC, or ISBN for marketplace integrations


## Best Practices

1. **Use sort_on parameter**: Set `sort_on=modified_on` to fetch recently updated products for incremental syncs
2. **Filter by item_code**: Use item codes for efficient bulk product lookups across systems
3. **Cache product data**: Implement caching with TTL based on your sync frequency requirements
4. **Handle pagination**: For catalogs with thousands of products, implement proper pagination logic
5. **Validate identifiers**: Cross-reference `seller_identifier` and `identifiers` arrays with your system
6. **Check is_active status**: Only sync active products to avoid displaying discontinued items
7. **Monitor modified_on**: Track the `modified_on` timestamp to identify products needing updates
8. **Store product IDs**: Save both `id` and `slug` for efficient product updates and deletions


Next Steps
* To create new products, see [Create Product](/konnect/channels/erp-wms/api-documentation/catalog/post-create-product)
* To update existing products, see [Update Product](/konnect/channels/erp-wms/api-documentation/catalog/put-update-product)
* To delete products or variants, see [Delete Product](/konnect/channels/erp-wms/api-documentation/catalog/delete-product)
* To check product processing status, see [Check Product Status](/konnect/channels/erp-wms/api-documentation/catalog/get-product-status)
* For complete catalog setup workflow, see [Catalog Management Guide](/konnect/channels/erp-wms/whats-new/catalog-management)