Skip to content

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


Common Request Headers

HeaderMandatoryDescription
x-access-tokenYesAccess token used for authenticating API requests to Fynd Konnect
Content-TypeYesapplication/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

namestring

Search products by name (partial match supported)

slugstring

Retrieve a specific product by its unique slug identifier

item_codeArray of strings

Fetch one or more products by item code (comma-separated for multiple)

sort_onstring

Sort field: use 'modified_on' for latest updates or 'created' for creation order

Default "modified_on"
Enum"modified_on""created"
page_numberinteger>= 1

Page number for pagination (default: 1)

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200, default: 10)

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

itemsArray of objects

List of products matching the query filters

page_numberinteger

Current page number in the paginated response

page_sizeinteger

Number of items returned in this page

totalinteger

Total number of products available matching the query

API Call Example

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/product?name=string&slug=string&item_code=string&sort_on=modified_on&page_number=1&page_size=1' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Example Response

{
  "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
© 2026 Shopsense Retail Technologies | MadeInIndia