Get List

GET /v1/integration/:id/config

Returns a collection of integrations. Each item represents an integration configuration, including mapping definitions, CSV format settings, import options, and metadata. Useful for listing all integrations for a given tenant or user context.

Query Parameters

• ~filter[resource] - Parameter for ~filter[resource]
• ~filter[format] - Parameter for ~filter[format]

Request Example

GET /v1/integration/:id/config

Response Example

{
  "items": [
    {
      "_id": "integration-id-1",
      "name": "Distributor 1",
      "tenant": "tenant-id-1",
      "isGlobal": false,
      "resource": "products",
      "format": "csv",
      "csvOptions": {
        "fieldDelimiter": ";",
        "valueDelimiter": ","
      },
      "filter": {
        "all": true,
        "ids": []
      },
      "importOptions": {
        "isSubscription": false,
        "isActive": true,
        "salesChannels": ["shop"],
        "matchingField": "sku"
      },
      "fieldMapping": {
        "name": "Name",
        "price": "Price",
        "sku": "SKU",
        "media": "Media Link",
        "categories": ["Categories"],
        "cost_price": "Cost Price"
      },
      "propertyMapping": {
        "Memory": ["8GB RAM", "16GB RAM"],
        "Storage": ["256GB SSD", "512GB SSD"],
        "Size": ["13-inch", "15-inch"]
      },
      "created": "2025-06-19T23:17:18.035Z",
      "updated": "2025-10-14T04:53:01.166Z",
      "__v": 0
    },
    {
      "_id": "integration-id-2",
      "name": "GlobalFiber",
      "tenant": "tenant-id-1",
      "isGlobal": false,
      "resource": "products",
      "format": "csv",
      "csvOptions": {
        "fieldDelimiter": ";",
        "valueDelimiter": ","
      },
      "filter": {
        "all": true,
        "ids": []
      },
      "importOptions": {
        "isSubscription": false,
        "isActive": true,
        "salesChannels": ["shop"],
        "matchingField": "sku"
      },
      "fieldMapping": {
        "name": "Product Description",
        "price": "Price",
        "sku": "SKU",
        "media": "Image"
      },
      "propertyMapping": {
        "Type": ["SFP", "QSFP28", "SFP28"],
        "Length": ["10km", "40km", "80km"]
      },
      "created": "2025-08-29T10:56:32.983Z",
      "updated": "2025-10-14T04:53:01.166Z",
      "__v": 0
    },
    {
      "_id": "integration-id-3",
      "name": "Full External",
      "tenant": "tenant-id-1",
      "isGlobal": false,
      "resource": "products",
      "format": "csv",
      "csvOptions": {
        "fieldDelimiter": ",",
        "valueDelimiter": ","
      },
      "filter": {
        "all": true,
        "ids": [0, 1, 2, 3]
      },
      "importOptions": {
        "isSubscription": false,
        "isActive": true,
        "salesChannels": ["shop"],
        "matchingField": "sku"
      },
      "fieldMapping": {
        "name": "Product Name",
        "sku": "SKU",
        "price": "Price",
        "media": ""
      },
      "propertyMapping": {
        "vendor": ["Cisco", "Generic", "Dell"],
        "form-factor": ["QSFP to SFP+ adapter"],
        "size": ["SM"],
        "level": ["5dB"]
      },
      "created": "2025-10-31T11:46:35.275Z",
      "updated": "2025-10-31T11:46:35.275Z",
      "__v": 0
    }
  ],
  "metadata": {
    "offset": 0,
    "limit": 100,
    "total": 3
  }
}