Skip to content
/
Product

Konnect API Reference (1.0.0)

Fynd Konnect is a unified platform built to streamline e-commerce and omni-channel operations by connecting seller's downstream systems (OMS, WMS, ERP, & POS) with the the top marketplaces and webstores alongside Fynd Commerce

Fynd Konnect API Reference is a resource designed for quickly testing and exploring the functionality offered by Fynd Konnect. This reference provides:

  • Schema Definitions: Clear, concise data models for requests and responses to facilitate debugging and prototyping API integrations

  • Try It Console: Interactive testing directly from the documentation, enabling real-time experimentation with endpoints, response examination, and setup validation

  • Endpoint Overview: A structured catalog of Fynd Konnect APIs (Authorization, Catalog, Pricing, Inventory, Orders, Returns) for streamlined discovery and usage

Dive into how Fynd Konnect can support operational and technical needs in a sandboxed, experimentation-friendly environment

Download OpenAPI description
konnect.json
konnect.yaml
Overview
Fynd Support
help@fyndplatform.com
Terms of Service
Languages
Servers
Fynd Konnect [Sandbox]
https://fyndkonnect.konnect.uat.fyndx1.de/

Authorization

  • Provides endpoints for obtaining and managing authentication tokens Supports both Company-Level and Location-Level authorization modes, giving you fine-grained access control across multiple stores or warehouses
  • Integrate seamlessly with Fynd Konnect by exchanging your credentials for time-bound access tokens, ensuring secure interactions with all other APIs
Operations

Catalog

  • Unified suite of APIs to manage product catalogs on Fynd Commerce Platform

  • Retrieve core catalog entities (brands, categories, departments, templates) and reference metadata (attributes, HS codes, tax rules) needed for product creation

  • Create, update, and delete products in bulk with full validation support

  • Fetch product listings and counts with pagination and filtering options

  • Track processing status for write operations via Check Product Status

  • Ideal for product synchronization, bulk catalog management, and validating data consistency across systems

Operations

Departments

Request

Retrieve departments (top-level catalog groupings such as Men's Clothing, Accessories, Footwear, Grocery)

Departments help organize products and improve discovery

Security
ApiKeyAuth
Query
namestring

Filter departments by name

slugstring

Filter departments by slug

is_activeboolean

Filter by active (true) or inactive (false) status

page_numberinteger>= 1

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

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

Responses

Departments retrieved successfully

Bodyapplication/json
itemsArray of objects

List of departments

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … },
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 2
}

Categories

Request

Retrieve product categories with a three-level hierarchy (L1 → L2 → L3) to improve discoverability

  • L1: Top level (e.g., Clothing)
  • L2: Sub-category (e.g., Shirts)
  • L3: Leaf category (e.g., Formal Shirts)

Categories are sales-channel specific: L1 and L2 remain common across channels while L3 names can vary per channel

Security
ApiKeyAuth
Query
slugstring

Retrieve a category by its slug

levelinteger

Filter categories by hierarchy level (1 for L1, 2 for L2, 3 for L3)

Enum123
departmentinteger

Filter categories by department ID (UID)

cat3_idArray of integers

Comma-separated list of L3 category IDs (UIDs) to fetch multiple categories

page_numberinteger>= 1

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/category?slug=string&level=1&department=0&cat3_id=0&page_number=1&page_size=1' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Categories retrieved successfully

Bodyapplication/json
itemsArray of objects

List of categories

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 420
}

Brands

Request

Retrieve the list of available brands or filter by name

Brands represent the manufacturer of a product Each brand has a unique ID and name to help identify and differentiate products

Security
ApiKeyAuth
Query
brand_namestring

Search brands by brand name

page_numberinteger>= 1

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/company-brand?brand_name=string&page_number=1&page_size=1' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Brands retrieved successfully

Bodyapplication/json
itemsArray of objects

List of brands

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 1
}

Templates

Request

Retrieve the list of available product templates

Templates are predefined blueprints that enforce structure and validation for product data to ensure uniformity and compliance across listings

Security
ApiKeyAuth
Query
departmentstring

Filter templates by department slug

page_numberinteger>= 1

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

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

Responses

Templates retrieved successfully

Bodyapplication/json
itemsArray of objects

List of product templates

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 1
}

Attributes By Product

Request

Retrieve category-specific product attributes (mandatory and optional)

Use this API to discover which attributes are required for a given L3 category before creating products. If mandatory attributes are missing or invalid during creation, the request will fail with a validation error

Security
ApiKeyAuth
Query
categorystringrequired

L3 category name

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/product-attributes?category=string' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Product attributes retrieved successfully

Bodyapplication/json
itemsArray of objects

List of product attributes for the category

Response
application/json
{
  "items": [
    { … }
  ]
}

HS Code

Request

Retrieve a company's HS/SAC codes used to classify goods and services for taxation

Security
ApiKeyAuth
Query
searchstring

Search by HS/SAC code or description

typestring

Filter by code type

Enum"HS""SAC"
page_numberinteger>= 1

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/taxes/hscodes?search=string&type=HS&page_number=1&page_size=1' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

HS/SAC codes retrieved successfully

Bodyapplication/json
itemsArray of objects

List of HS/SAC codes

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 150
}

Tax Rule IDs

Request

Retrieve available tax rules configured for the company, including rule status and version status

Security
ApiKeyAuth
Query
statusstring

Filter tax rules by rule status (e.g., ACTIVE)

version_statusstring

Filter by version status (e.g., CURRENT, FUTURE)

rule_namestring

Search query to filter tax rules by name

page_numberinteger>= 1

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/taxes/rules?status=string&version_status=string&rule_name=string&page_number=1&page_size=1' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Tax rules retrieved successfully

Bodyapplication/json
itemsArray of objects

List of tax rules

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 15
}

Listings

Request

Retrieve SKUs from Fynd Commerce using flexible filters

Ideal for confirming product data, checking recently onboarded items, or auditing stock parity with Fynd. Supports pagination via page_no and page_size

Security
ApiKeyAuth
Query
page_nostring

The current page number of the request

page_sizestring<= 500

Number of items per page

skusstring<= 10

Comma-separated SKUs to fetch certain product listings

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/ims/v3/listings?page_no=string&page_size=string&skus=string' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Successful retrieval of product listings

Bodyapplication/json
dataArray of objects

Array of product listing objects

metaobject

Response metadata for product listings

Response
application/json
{
  "data": [
    { … },
    { … },
    { … }
  ],
  "meta": {
    "ack_id": "55a7bd5d-4dbd-46ed-8cc9-8677e9d691fa",
    "integrationId": "63b8e31227ah5327f0affee7",
    "time": "2025-01-31T06:58:37.608+00:00",
    "status": "SUCCESS"
  }
}

Product Count

Request

Fetch a quick overview of the total products listed at the company level in the Fynd OMS.

Optionally include x-batch-product to check batch-based articles. Perfect for pre-sync validations or monitoring overall listing growth or discrepancy.

Security
ApiKeyAuth
Headers
x-batch-productstring

Flag indicating batch processing for the product count

Enum"TRUE""FALSE"
curl -i -X GET \
  https://fyndkonnect.konnect.uat.fyndx1.de/ims/v3/listings/count \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -H 'x-batch-product: TRUE'

Responses

Successful retrieval of product count

Bodyapplication/json
dataobject

Data object containing listing counts

metaobject

Response metadata for product count

Response
application/json
{
  "data": {
    "listing_count": 55050
  },
  "meta": {
    "ack_id": "ef0f3996-d414-134a-b9e9-09658a5cb781",
    "integrationId": "63b8e31227ah5327f0affee7",
    "time": "2025-01-31T06:58:37.608+00:00",
    "status": "SUCCESS"
  }
}

Product

Request

Fetch the latest product details, including identifiers and size information

Supports filtering by name, slug, or item code and pagination

Security
ApiKeyAuth
Query
namestring

Product name to search

slugstring

Fetch product by its slug

item_codeArray of strings

Fetch product(s) by item code (comma-separated)

sort_onstring

Sort field (use modified_on for latest or created for creation order)

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

Page number for pagination

page_sizeinteger[ 1 .. 200 ]

Number of items to retrieve per page (1–200)

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'

Responses

Products retrieved successfully

Bodyapplication/json
itemsArray of objects

List of products

page_numberinteger

Current page number

page_sizeinteger

Page size used for this response

totalinteger

Total number of records available

Response
application/json
{
  "items": [
    { … }
  ],
  "page_number": 1,
  "page_size": 10,
  "total": 25
}

Create Product

Request

Create one or more products in a single request. Each product can include multiple sizes (variants) along with traders, attributes, and global attributes

Prerequisites: Fetch and use valid values from the read APIs (Departments, Categories, Brands, Templates, Attributes, Tax Rule IDs, and HS Codes) to comply with platform validation

Note: You can create up to 100 products per API request

Security
ApiKeyAuth
Bodyapplication/jsonrequired
productsArray of objects(ProductInput)non-emptyrequired

Array of products to create

products[].​item_typestring

Product type

Enum"standard""set""composite""digital"
products[].​namestring[ 1 .. 300 ] charactersrequired

Product name

products[].​slugstring^[a-z0-9]+(?:-[a-z0-9]+)*$required

URL-friendly product identifier (unique per brand)

products[].​departmentsArray of stringsnon-emptyrequired

Department UIDs from Fetch Departments

products[].​categorystringrequired

L3 category name from Fetch Categories

products[].​brandstringrequired

Brand name from Fetch Brands

products[].​item_codestringrequired

Unique item code for the product

products[].​net_quantityobject(NetQuantity)
products[].​country_of_originstringrequired

Country where the product is manufactured

products[].​tax_identifierobject(TaxIdentifier)required
products[].​tax_identifier.​tax_rule_idstringrequired

Tax rule ID obtained from Fetch Tax Rule IDs

products[].​no_of_boxesinteger>= 0

Number of boxes used for packaging

products[].​hs_codestringrequired

HS/SAC code from Fetch HS Code

products[].​mediaArray of objects(MediaItem)

Product images and videos

products[].​short_descriptionstring<= 50 characters

Brief summary shown in listings

products[].​descriptionstring<= 5000 characters

Detailed product description

products[].​highlightsArray of strings

Key product highlights

products[].​sizesArray of objects(ProductSize)non-emptyrequired

Array of product sizes/variants

products[].​sizes[].​primary_identifierstringrequired

Primary identifier for this size variant

products[].​sizes[].​sizestringrequired

Size value of the variant

products[].​sizes[].​pricenumber>= 0required

Original (base) price

products[].​sizes[].​price_effectivenumber>= 0required

Effective/selling price

products[].​sizes[].​item_lengthnumber>= 0

Item length in centimeters

products[].​sizes[].​item_widthnumber>= 0

Item width in centimeters

products[].​sizes[].​item_heightnumber>= 0

Item height in centimeters

products[].​sizes[].​item_weightnumber>= 0

Item weight in grams

products[].​sizes[].​track_inventoryboolean

Whether inventory tracking is enabled for this variant

products[].​sizes[].​identifiersArray of objects(ProductIdentifier)

List of additional identifiers for this size

products[].​traderArray of objects(Trader)required

Trader information (manufacturer, importer, etc.)

products[].​trader[].​typestringrequired

Type of trader involved with the product

Enum"Manufacturer""Importer""Packer""Seller"
products[].​trader[].​namestringrequired

Trader or company name

products[].​trader[].​addressArray of stringsrequired

Address lines for the trader

products[].​attributesobjectrequired

Category-specific attributes returned by Fetch Attributes By Product

products[].​attributes.​property name*anyadditional property
products[].​product_publishobject(ProductGlobalPublish)
products[].​tagsArray of strings

Product tags or keywords

products[].​return_configobject(ProductReturnConfig)
products[].​custom_orderobject(ProductCustomOrder)
products[].​is_dependentbooleanrequired

Whether the product depends on another product

templatestringrequired

Template slug from Fetch Templates

curl -i -X POST \
  https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/product \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '{
    "products": [
      {
        "item_type": "standard",
        "name": "string",
        "slug": "string",
        "departments": [
          "string"
        ],
        "category": "string",
        "brand": "string",
        "item_code": "string",
        "net_quantity": {
          "unit": "kg",
          "value": 0
        },
        "country_of_origin": "string",
        "tax_identifier": {
          "tax_rule_id": "string"
        },
        "no_of_boxes": 0,
        "hs_code": "string",
        "media": [
          {
            "url": "http://example.com",
            "type": "image"
          }
        ],
        "short_description": "string",
        "description": "string",
        "highlights": [
          "string"
        ],
        "sizes": [
          {
            "primary_identifier": "string",
            "size": "string",
            "price": 0,
            "price_effective": 0,
            "item_length": 0,
            "item_width": 0,
            "item_height": 0,
            "item_weight": 0,
            "track_inventory": true,
            "identifiers": [
              {
                "gtin_value": "string",
                "gtin_type": "SKU",
                "primary": true
              }
            ]
          }
        ],
        "trader": [
          {
            "type": "Manufacturer",
            "name": "string",
            "address": [
              "string"
            ]
          }
        ],
        "attributes": {},
        "product_publish": {
          "product_online_date": "2019-08-24T14:15:22Z",
          "is_set": true
        },
        "tags": [
          "string"
        ],
        "return_config": {
          "returnable": "Yes",
          "time": 0,
          "unit": "days"
        },
        "custom_order": {
          "is_custom_order": "Yes",
          "manufacturing_time": 0,
          "manufacturing_time_unit": "days"
        },
        "is_dependent": true
      }
    ],
    "template": "string"
  }'

Responses

Product(s) accepted for processing

Bodyapplication/json
trace_idstring

Unique trace ID for tracking the operation

totalinteger

Total number of products submitted

successinteger

Number of products accepted for processing

failedinteger

Number of products rejected

statusstring

Overall submission status

errorsobject

Error details for failed records

stagestring

Current processing stage

company_idinteger

Company ID

Response
application/json
{
  "trace_id": "1356dfa6-7d45-4ff9-8397-f43b9d92dc52",
  "total": 1,
  "success": 1,
  "failed": 0,
  "status": "SUCCESS",
  "errors": {},
  "stage": "RUNNING",
  "company_id": 26049
}

Update Product

Request

Update details of an existing product

Immutable fields: slug, brand, brand_uid, item_code, and the top-level template must not be changed

Update supports modifying name, description, media, tax rule ID, HS code, trader info, attributes, and global attributes (tags, return config, custom order, publish info)

Security
ApiKeyAuth
Bodyapplication/jsonrequired
productsArray of objects(ProductUpdateInput)non-emptyrequired

Array of products to update

products[].​item_typestringrequired

Product type

Enum"standard""set""composite""digital"
products[].​namestring[ 1 .. 300 ] charactersrequired

Product name

products[].​departmentsArray of stringsnon-emptyrequired

Department UIDs from Fetch Departments

products[].​categorystringrequired

L3 category name from Fetch Categories

products[].​country_of_originstringrequired

Country where the product is manufactured

products[].​tax_identifierobject(TaxIdentifier)required
products[].​tax_identifier.​tax_rule_idstringrequired

Tax rule ID obtained from Fetch Tax Rule IDs

products[].​hs_codestringrequired

HS/SAC code from Fetch HS Code (4, 6, or 8 digits long)

products[].​sizesArray of objects(ProductSize)non-emptyrequired

Array of product sizes/variants

products[].​sizes[].​primary_identifierstringrequired

Primary identifier for this size variant

products[].​sizes[].​sizestringrequired

Size value of the variant

products[].​sizes[].​pricenumber>= 0required

Original (base) price

products[].​sizes[].​price_effectivenumber>= 0required

Effective/selling price

products[].​sizes[].​item_lengthnumber>= 0

Item length in centimeters

products[].​sizes[].​item_widthnumber>= 0

Item width in centimeters

products[].​sizes[].​item_heightnumber>= 0

Item height in centimeters

products[].​sizes[].​item_weightnumber>= 0

Item weight in grams

products[].​sizes[].​track_inventoryboolean

Whether inventory tracking is enabled for this variant

products[].​sizes[].​identifiersArray of objects(ProductIdentifier)

List of additional identifiers for this size

products[].​traderArray of objects(Trader)

Trader information (manufacturer, importer, etc.)

products[].​attributesobject

Category-specific attributes to update

products[].​descriptionstring<= 5000 characters

Detailed product description

products[].​short_descriptionstring<= 50 characters

Brief summary shown in listings

products[].​mediaArray of objects(MediaItem)

Product images and videos

products[].​net_quantityobject(NetQuantity)
products[].​no_of_boxesinteger>= 0

Number of boxes used for packaging

products[].​highlightsArray of strings

Key product highlights

products[].​product_publishobject(ProductGlobalPublish)
products[].​tagsArray of strings

Product tags or keywords

products[].​return_configobject(ProductReturnConfig)
products[].​custom_orderobject(ProductCustomOrder)
products[].​is_dependentstring

Whether the product depends on another product

Enum"Yes""No"
templatestringrequired

Template slug (immutable at product level)

curl -i -X PUT \
  https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/product \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '{
    "products": [
      {
        "item_type": "standard",
        "name": "string",
        "departments": [
          "string"
        ],
        "category": "string",
        "country_of_origin": "string",
        "tax_identifier": {
          "tax_rule_id": "string"
        },
        "hs_code": "string",
        "sizes": [
          {
            "primary_identifier": "string",
            "size": "string",
            "price": 0,
            "price_effective": 0,
            "item_length": 0,
            "item_width": 0,
            "item_height": 0,
            "item_weight": 0,
            "track_inventory": true,
            "identifiers": [
              {
                "gtin_value": "string",
                "gtin_type": "SKU",
                "primary": true
              }
            ]
          }
        ],
        "trader": [
          {
            "type": "Manufacturer",
            "name": "string",
            "address": [
              "string"
            ]
          }
        ],
        "attributes": {},
        "description": "string",
        "short_description": "string",
        "media": [
          {
            "url": "http://example.com",
            "type": "image"
          }
        ],
        "net_quantity": {
          "unit": "kg",
          "value": 0
        },
        "no_of_boxes": 0,
        "highlights": [
          "string"
        ],
        "product_publish": {
          "product_online_date": "2019-08-24T14:15:22Z",
          "is_set": true
        },
        "tags": [
          "string"
        ],
        "return_config": {
          "returnable": "Yes",
          "time": 0,
          "unit": "days"
        },
        "custom_order": {
          "is_custom_order": "Yes",
          "manufacturing_time": 0,
          "manufacturing_time_unit": "days"
        },
        "is_dependent": "Yes"
      }
    ],
    "template": "string"
  }'

Responses

Update request accepted for processing

Bodyapplication/json
trace_idstring

Unique trace ID for tracking the operation

totalinteger

Total number of products submitted

successinteger

Number of products accepted for processing

failedinteger

Number of products rejected

statusstring

Overall submission status

errorsobject

Error details for failed records

stagestring

Current processing stage

company_idinteger

Company ID

Response
application/json
{
  "trace_id": "c7b6b1f4-0494-4d1a-a5dc-b61291274bce",
  "total": 1,
  "success": 1,
  "failed": 0,
  "status": "SUCCESS",
  "errors": {},
  "stage": "RUNNING",
  "company_id": 26049
}

Delete Product

Request

Delete a whole product or a specific size (variant)

To delete an entire product, provide only the identifying fields (slug, brand, brand_uid, item_code) and the fixed template field in the request body

To delete a specific size, include the sizes array with the variant's primary identifier and GTIN details

Security
ApiKeyAuth
Bodyapplication/jsonrequired
productsArray of objects(ProductDeleteInput)non-emptyrequired

Array of products to delete

products[].​namestringrequired

Product name

products[].​slugstringrequired

Product slug

products[].​brandstringrequired

Brand name

products[].​brand_uidstringrequired

Brand UID

products[].​item_codestringrequired

Item code

products[].​sizesArray of objects

Include to delete specific sizes only; omit to delete the whole product

templatestringrequired

Template slug for the product being deleted

curl -i -X DELETE \
  https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/product \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '{
    "products": [
      {
        "name": "string",
        "slug": "string",
        "brand": "string",
        "brand_uid": "string",
        "item_code": "string",
        "sizes": [
          {
            "primary_identifier": "string",
            "size": "string",
            "identifiers": [
              {
                "gtin_value": "string",
                "gtin_type": "SKU",
                "primary": true
              }
            ]
          }
        ]
      }
    ],
    "template": "string"
  }'

Responses

Delete request accepted for processing

Bodyapplication/json
trace_idstring

Unique trace ID for tracking the operation

totalinteger

Total number of products submitted

successinteger

Number of products accepted for processing

failedinteger

Number of products rejected

statusstring

Overall submission status

errorsobject

Error details for failed records

stagestring

Current processing stage

company_idinteger

Company ID

Response
application/json
{
  "trace_id": "a736437f4c389a5f-1760266316425",
  "total": 1,
  "success": 1,
  "failed": 0,
  "status": "SUCCESS",
  "errors": {},
  "stage": "RUNNING",
  "company_id": 26049
}

Check Product Status

Request

Verify whether a previously submitted create/update/delete operation has completed, is pending, or failed

Supply the trace_id returned by the write API to obtain processing status and error details (if any)

Security
ApiKeyAuth
Query
trace_idstringrequired

Trace ID from the Create/Update/Delete response

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/v3/catalog/status?trace_id=string' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Product status retrieved successfully

Bodyapplication/json
trace_idstring

Trace ID of the submitted operation

statusstring

High-level status

Enum"completed""pending""failed"
stagestring

Processing stage returned by the system

totalinteger

Total products in the tracked operation

successinteger

Number of successful records

failedinteger

Number of failed records

errorsobject

Error details, if any

company_idinteger

Company ID associated with the operation

messagestring

Human-readable status message

Response
application/json
{
  "trace_id": "90591ba5-b88c-475d-bbca-e9cda685ed78",
  "status": "completed",
  "stage": "COMPLETED",
  "total": 1,
  "success": 1,
  "failed": 0,
  "errors": {},
  "company_id": 26049,
  "message": "Product processed successfully"
}

Pricing

  • Offers a way to set or update the MRP and ESP for your SKUs on a per-location basis, ensuring pricing uniformity across your internal systems and the Fynd platform
  • Supports high-volume updates (up to 500 records) in one call, streamlining real-time price adjustments for flash sales, promotions, or omni-channel pricing consistency
Operations

Inventory

  • Enables real-time stock-level management in the Fynd OMS. Update inventory quantities for each SKU across multiple locations, ensuring that Fynd accurately reflects item availability. Prevent overselling or stockouts by syncing frequently
  • Maximum 500 records can be updated in a single request
Operations

Orders

  • Covers the entire end-to-end lifecycle of orders on Fynd, from initial retrieval through packing, dispatching, and final delivery. Includes:

    • Fetching new or updated orders

    • Cancellation of orders or specific items before invoicing

    • Confirmation of orders in bulk

    • Invoicing or credit note generation

    • Make order pack and dispatch calls

    • AWB and courier updates for self-ship scenarios

    • Order status transitions for self-ship scenarios (bag_picked, delivery_done, etc.)

  • Maximum 20 records can be updated in a single request

Operations

Returns

  • Manages the reverse and RTO (Return to Origin) journeys for your orders:

    • Fetch returns by using GET Orders endpoint with RETURN_DELIVERED as the order status
    • Quality Check acceptance after items are returned to the seller
    • Credit Note issuance for returns or RTO using the PUT Update Inventory endpoint with "invoiceType: return"

  • All reverse processes remain in sync with Fynd OMS

  • Maximum 20 records can be updated in a single request

Operations
© 2026 Shopsense Retail Technologies | MadeInIndia