Listings endpoint

List listings (search)

post

Search for Listing

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ListingSearchPayload

afterstringOptional

The cursor to start after for forward pagination. The value is provided in the pageInfo.endCursor field of the response. Cannot be used with before or last.

beforestringOptional

The cursor to start before for backward pagination. The value is provided in the pageInfo.startCursor field of the response. Cannot be used with after or size (first).

lastnumber · min: 1 · max: 250Optional

Number of items to return for backward pagination. Cannot be used with 'size' (first). Default: 20.

sizenumber · min: 1 · max: 250Optional

Number of items to return for forward pagination. Cannot be used with 'last'. Default: 20.

startAfterIdstringOptionalDeprecated

The ID to start after. Deprecated, use after with the value provided in pageInfo.endCursor instead.

Responses

200

Your search result

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

post

/api/listings/search

HTTPcURLJavaScriptPython

POST /api/listings/search HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 7242

{
  "after": "text",
  "before": "text",
  "last": 1,
  "options": {
    "withTotal": true
  },
  "query": {
    "and": [
      {
        "and": [
          {
            "and": "[Circular Reference]",
            "availabilityTimeframe": {
              "start": {
                "after": "text",
                "before": "text",
                "eq": "2026-03-20T20:20:58.562Z",
                "gt": "2026-03-20T20:20:58.562Z",
                "gte": "2026-03-20T20:20:58.562Z",
                "lt": "2026-03-20T20:20:58.562Z",
                "lte": "2026-03-20T20:20:58.562Z",
                "notEq": "2026-03-20T20:20:58.562Z"
              }
            },
            "categoryRefs": {
              "contains": {
                "eq": "text",
                "notEq": "text"
              }
            },
            "created": {
              "after": "text",
              "before": "text",
              "eq": "2026-03-20T20:20:58.562Z",
              "gt": "2026-03-20T20:20:58.562Z",
              "gte": "2026-03-20T20:20:58.562Z",
              "lt": "2026-03-20T20:20:58.562Z",
              "lte": "2026-03-20T20:20:58.562Z",
              "notEq": "2026-03-20T20:20:58.562Z"
            },
            "customAttributes": {
              "ANY_ADDITIONAL_PROPERTY": {
                "eq": true,
                "notEq": true
              }
            },
            "facilityRef": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "id": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "measurementUnitKey": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "or": "[Circular Reference]",
            "outOfStockBehaviour": {
              "eq": "NONE",
              "in": [
                "NONE"
              ],
              "notEq": "NONE"
            },
            "price": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "status": {
              "eq": "ACTIVE",
              "in": [
                "ACTIVE"
              ],
              "notEq": "ACTIVE"
            },
            "tenantArticleId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "weight": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "tags": {
              "contains": {
                "id": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                },
                "value": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "availabilityTimeframe": {
          "start": {
            "after": "text",
            "before": "text",
            "eq": "2026-03-20T20:20:58.562Z",
            "gt": "2026-03-20T20:20:58.562Z",
            "gte": "2026-03-20T20:20:58.562Z",
            "lt": "2026-03-20T20:20:58.562Z",
            "lte": "2026-03-20T20:20:58.562Z",
            "notEq": "2026-03-20T20:20:58.562Z"
          }
        },
        "categoryRefs": {
          "contains": {
            "eq": "text",
            "notEq": "text"
          }
        },
        "created": {
          "after": "text",
          "before": "text",
          "eq": "2026-03-20T20:20:58.562Z",
          "gt": "2026-03-20T20:20:58.562Z",
          "gte": "2026-03-20T20:20:58.562Z",
          "lt": "2026-03-20T20:20:58.562Z",
          "lte": "2026-03-20T20:20:58.562Z",
          "notEq": "2026-03-20T20:20:58.562Z"
        },
        "customAttributes": {
          "ANY_ADDITIONAL_PROPERTY": {
            "eq": true,
            "notEq": true
          }
        },
        "facilityRef": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "id": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "measurementUnitKey": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "or": [
          {
            "and": "[Circular Reference]",
            "availabilityTimeframe": {
              "start": {
                "after": "text",
                "before": "text",
                "eq": "2026-03-20T20:20:58.562Z",
                "gt": "2026-03-20T20:20:58.562Z",
                "gte": "2026-03-20T20:20:58.562Z",
                "lt": "2026-03-20T20:20:58.562Z",
                "lte": "2026-03-20T20:20:58.562Z",
                "notEq": "2026-03-20T20:20:58.562Z"
              }
            },
            "categoryRefs": {
              "contains": {
                "eq": "text",
                "notEq": "text"
              }
            },
            "created": {
              "after": "text",
              "before": "text",
              "eq": "2026-03-20T20:20:58.562Z",
              "gt": "2026-03-20T20:20:58.562Z",
              "gte": "2026-03-20T20:20:58.562Z",
              "lt": "2026-03-20T20:20:58.562Z",
              "lte": "2026-03-20T20:20:58.562Z",
              "notEq": "2026-03-20T20:20:58.562Z"
            },
            "customAttributes": {
              "ANY_ADDITIONAL_PROPERTY": {
                "eq": true,
                "notEq": true
              }
            },
            "facilityRef": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "id": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "measurementUnitKey": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "or": "[Circular Reference]",
            "outOfStockBehaviour": {
              "eq": "NONE",
              "in": [
                "NONE"
              ],
              "notEq": "NONE"
            },
            "price": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "status": {
              "eq": "ACTIVE",
              "in": [
                "ACTIVE"
              ],
              "notEq": "ACTIVE"
            },
            "tenantArticleId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "weight": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "tags": {
              "contains": {
                "id": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                },
                "value": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "outOfStockBehaviour": {
          "eq": "NONE",
          "in": [
            "NONE"
          ],
          "notEq": "NONE"
        },
        "price": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "status": {
          "eq": "ACTIVE",
          "in": [
            "ACTIVE"
          ],
          "notEq": "ACTIVE"
        },
        "tenantArticleId": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "weight": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "tags": {
          "contains": {
            "id": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "value": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "availabilityTimeframe": {
      "start": {
        "after": "text",
        "before": "text",
        "eq": "2026-03-20T20:20:58.562Z",
        "gt": "2026-03-20T20:20:58.562Z",
        "gte": "2026-03-20T20:20:58.562Z",
        "lt": "2026-03-20T20:20:58.562Z",
        "lte": "2026-03-20T20:20:58.562Z",
        "notEq": "2026-03-20T20:20:58.562Z"
      }
    },
    "categoryRefs": {
      "contains": {
        "eq": "text",
        "notEq": "text"
      }
    },
    "created": {
      "after": "text",
      "before": "text",
      "eq": "2026-03-20T20:20:58.562Z",
      "gt": "2026-03-20T20:20:58.562Z",
      "gte": "2026-03-20T20:20:58.562Z",
      "lt": "2026-03-20T20:20:58.562Z",
      "lte": "2026-03-20T20:20:58.562Z",
      "notEq": "2026-03-20T20:20:58.562Z"
    },
    "customAttributes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "eq": true,
        "notEq": true
      }
    },
    "facilityRef": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "id": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "measurementUnitKey": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "or": [
      {
        "and": "[Circular Reference]",
        "availabilityTimeframe": {
          "start": {
            "after": "text",
            "before": "text",
            "eq": "2026-03-20T20:20:58.562Z",
            "gt": "2026-03-20T20:20:58.562Z",
            "gte": "2026-03-20T20:20:58.562Z",
            "lt": "2026-03-20T20:20:58.562Z",
            "lte": "2026-03-20T20:20:58.562Z",
            "notEq": "2026-03-20T20:20:58.562Z"
          }
        },
        "categoryRefs": {
          "contains": {
            "eq": "text",
            "notEq": "text"
          }
        },
        "created": {
          "after": "text",
          "before": "text",
          "eq": "2026-03-20T20:20:58.562Z",
          "gt": "2026-03-20T20:20:58.562Z",
          "gte": "2026-03-20T20:20:58.562Z",
          "lt": "2026-03-20T20:20:58.562Z",
          "lte": "2026-03-20T20:20:58.562Z",
          "notEq": "2026-03-20T20:20:58.562Z"
        },
        "customAttributes": {
          "ANY_ADDITIONAL_PROPERTY": {
            "eq": true,
            "notEq": true
          }
        },
        "facilityRef": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "id": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "measurementUnitKey": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "or": "[Circular Reference]",
        "outOfStockBehaviour": {
          "eq": "NONE",
          "in": [
            "NONE"
          ],
          "notEq": "NONE"
        },
        "price": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "status": {
          "eq": "ACTIVE",
          "in": [
            "ACTIVE"
          ],
          "notEq": "ACTIVE"
        },
        "tenantArticleId": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "weight": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "tags": {
          "contains": {
            "id": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "value": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "outOfStockBehaviour": {
      "eq": "NONE",
      "in": [
        "NONE"
      ],
      "notEq": "NONE"
    },
    "price": {
      "eq": 1,
      "gt": 1,
      "gte": 1,
      "in": [
        1
      ],
      "lt": 1,
      "lte": 1,
      "notEq": 1,
      "notIn": [
        1
      ]
    },
    "status": {
      "eq": "ACTIVE",
      "in": [
        "ACTIVE"
      ],
      "notEq": "ACTIVE"
    },
    "tenantArticleId": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "weight": {
      "eq": 1,
      "gt": 1,
      "gte": 1,
      "in": [
        1
      ],
      "lt": 1,
      "lte": 1,
      "notEq": 1,
      "notIn": [
        1
      ]
    },
    "tags": {
      "contains": {
        "id": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "value": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        }
      }
    }
  },
  "size": 1,
  "sort": [
    {
      "customAttributes": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "lastModified": "ASC",
      "tenantArticleId": "ASC"
    }
  ]
}

{
  "listings": [
    {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "currency": "EUR",
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "2020-02-03T08:45:50.525Z"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 100
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "price": 1200,
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "key": "Serialnumber",
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": []
      },
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "weight": 1,
      "tags": [],
      "created": "2020-02-03T08:45:51.525Z",
      "lastModified": "2020-02-03T09:45:51.525Z",
      "version": 42,
      "facilityId": "4711",
      "id": "fsfdsf87fsd",
      "status": "ACTIVE"
    }
  ],
  "pageInfo": {
    "endCursor": "text",
    "hasNextPage": true,
    "hasPreviousPage": true,
    "startCursor": "text"
  },
  "total": 1
}

Update listings

put

Bulk upsert listings independently of their facility

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ListingBulkUpsertPayload

Responses

200

Result of the bulk upsert operation

application/json

400

Invalid input. See response for details.

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

put

/api/listings

HTTPcURLJavaScriptPython

PUT /api/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1382

{
  "listings": [
    {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "customAttributes": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "text"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 1
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "text"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": []
      },
      "selector": [
        {
          "facility": {
            "facilityRef": "text"
          },
          "version": 1
        }
      ],
      "status": "ACTIVE",
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "targetingStrategy": "MULTI_SELECTOR",
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "tags": []
    }
  ]
}

{
  "listings": [
    {
      "result": {
        "titleLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "attributes": [
          {
            "valueLocalized": {
              "de_DE": "Wert",
              "en_US": "Value",
              "ru_RU": "значение"
            },
            "keyLocalized": {
              "de_DE": "Wert",
              "en_US": "Value",
              "ru_RU": "значение"
            },
            "category": "descriptive",
            "context": {
              "type": "FACILITY_GROUP",
              "value": "text"
            },
            "key": "%%subtitle%%",
            "priority": 100,
            "type": "STRING",
            "value": "585er Gold"
          }
        ],
        "categoryRefs": [
          "text"
        ],
        "currency": "EUR",
        "customAttributes": {},
        "imageUrl": "text",
        "legal": {
          "hsCode": "text"
        },
        "measurementUnitKey": "liter",
        "outOfStockBehaviour": "NONE",
        "outOfStockBehaviourByContexts": [
          {
            "context": [
              {
                "operator": "NOT",
                "type": "FACILITY_GROUP",
                "values": [
                  "uuid-bkrs-0157"
                ]
              }
            ],
            "outOfStockBehaviour": "NONE",
            "outOfStockConfig": {
              "preorder": {
                "availabilityTimeframe": {
                  "start": "2020-02-03T08:45:50.525Z"
                }
              },
              "restock": {
                "restockableInDays": 1
              }
            },
            "priority": 100
          }
        ],
        "outOfStockConfig": {
          "preorder": {
            "availabilityTimeframe": {
              "start": "2020-02-03T08:45:50.525Z"
            }
          },
          "restock": {
            "restockableInDays": 1
          }
        },
        "price": 1200,
        "recordableAttributes": [
          {
            "keyLocalized": {
              "de_DE": "Wert",
              "en_US": "Value",
              "ru_RU": "значение"
            },
            "key": "Serialnumber",
            "recordingRule": "MANDATORY",
            "value": "Germany"
          }
        ],
        "scannableCodes": [
          "text"
        ],
        "scanningRule": {
          "values": []
        },
        "stockAvailableUntil": {
          "calculationBase": "EXPIRY",
          "modifier": "-P30D"
        },
        "stockProperties": {
          "ANY_ADDITIONAL_PROPERTY": {
            "defaultValue": "text",
            "inputType": "DATE",
            "required": true
          }
        },
        "tenantArticleId": "4711",
        "title": "Adidas Superstar",
        "weight": 1,
        "tags": [],
        "created": "2020-02-03T08:45:51.525Z",
        "lastModified": "2020-02-03T09:45:51.525Z",
        "version": 42,
        "facilityId": "4711",
        "id": "fsfdsf87fsd",
        "status": "ACTIVE"
      },
      "status": "CREATED"
    }
  ],
  "summary": {
    "created": 1,
    "unchanged": 1,
    "updated": 1
  }
}

Get listing

get

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to get listing. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

tenantArticleId of listing you want to get

Query parameters

localestringOptional

Provide the localized names and descriptions for the listing. If not provided the default locale is used., for example de_DE.

Responses

200

Listing is found & you were allowed to access it. The result is in the body.

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Listings not found

application/json

get

/api/facilities/{facilityId}/listings/{tenantArticleId}

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/listings/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "titleLocalized": {
    "de_DE": "Wert",
    "en_US": "Value",
    "ru_RU": "значение"
  },
  "attributes": [
    {
      "valueLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "keyLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "category": "descriptive",
      "context": {
        "type": "FACILITY_GROUP",
        "value": "text"
      },
      "key": "%%subtitle%%",
      "priority": 100,
      "type": "STRING",
      "value": "585er Gold"
    }
  ],
  "categoryRefs": [
    "text"
  ],
  "currency": "EUR",
  "customAttributes": {},
  "imageUrl": "text",
  "legal": {
    "hsCode": "text"
  },
  "measurementUnitKey": "liter",
  "outOfStockBehaviour": "NONE",
  "outOfStockBehaviourByContexts": [
    {
      "context": [
        {
          "operator": "NOT",
          "type": "FACILITY_GROUP",
          "values": [
            "uuid-bkrs-0157"
          ]
        }
      ],
      "outOfStockBehaviour": "NONE",
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "priority": 100
    }
  ],
  "outOfStockConfig": {
    "preorder": {
      "availabilityTimeframe": {
        "start": "2020-02-03T08:45:50.525Z"
      }
    },
    "restock": {
      "restockableInDays": 1
    }
  },
  "price": 1200,
  "recordableAttributes": [
    {
      "keyLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "key": "Serialnumber",
      "recordingRule": "MANDATORY",
      "value": "Germany"
    }
  ],
  "scannableCodes": [
    "text"
  ],
  "scanningRule": {
    "values": []
  },
  "stockAvailableUntil": {
    "calculationBase": "EXPIRY",
    "modifier": "-P30D"
  },
  "stockProperties": {
    "ANY_ADDITIONAL_PROPERTY": {
      "defaultValue": "text",
      "inputType": "DATE",
      "required": true
    }
  },
  "tenantArticleId": "4711",
  "title": "Adidas Superstar",
  "weight": 1,
  "tags": [],
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42,
  "facilityId": "4711",
  "id": "fsfdsf87fsd",
  "status": "ACTIVE"
}

Delete listings

delete

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to delete all listings of. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Responses

200

Facility listings were found and successfully deleted

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

delete

/api/facilities/{facilityId}/listings

HTTPcURLJavaScriptPython

DELETE /api/facilities/{facilityId}/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List listings

get

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to get listing for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Query parameters

startAfterIdstringOptional

all entities after given Id

sizeintegerOptional

number of facilities to show

Default: 25

tenantArticleIdsstring[] · max: 500Optional

Array of tenantArticleIds

scannableCodestringOptional

limit results to this scannableCode

Responses

200

Facility was found & you were allowed to access it. The results are in the body.

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility not found

application/json

get

/api/facilities/{facilityId}/listings

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "listings": [
    {
      "created": "2020-02-03T08:45:51.525Z",
      "lastModified": "2020-02-03T09:45:51.525Z",
      "version": 42,
      "id": "fsfdsf87fsd",
      "status": "ACTIVE",
      "tenantArticleId": "4711"
    }
  ],
  "total": 42
}

Update listings

put

Bulk PUT for Listings. Please note: This endpoint has legacy behaviour, i.e. all PUTs fail if a single PUT fails.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to put listings for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Body

application/json

ListingsForReplacement

Responses

200

Facility listing was found & you were allowed to access it. The result is in the body.

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

put

/api/facilities/{facilityId}/listings

HTTPcURLJavaScriptPython

PUT /api/facilities/{facilityId}/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1461

{
  "listings": [
    {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "currency": "EUR",
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "2020-02-03T08:45:50.525Z"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 100
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "price": 1200,
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": []
      },
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "weight": 1,
      "tags": []
    }
  ]
}

[
  {
    "listing": {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "currency": "EUR",
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "2020-02-03T08:45:50.525Z"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 100
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "price": 1200,
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "key": "Serialnumber",
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": []
      },
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "weight": 1,
      "tags": [],
      "created": "2020-02-03T08:45:51.525Z",
      "lastModified": "2020-02-03T09:45:51.525Z",
      "version": 42,
      "facilityId": "4711",
      "id": "fsfdsf87fsd",
      "status": "ACTIVE"
    },
    "status": "UPDATED"
  }
]

Update listing

patch

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to patch a listing of. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

tenant ID of the articles listing you want to patch

Body

application/json

ListingPatchActions

versioninteger · int64Required

The version of the document to be used in optimistic locking mechanisms.

Example: 42

Responses

200

Facility listing was found and successfully patched

application/json

400

Invalid input. See response for details

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

409

Listing version conflict

application/json

patch

/api/facilities/{facilityId}/listings/{tenantArticleId}

HTTPcURLJavaScriptPython

PATCH /api/facilities/{facilityId}/listings/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1216

{
  "actions": [
    {
      "action": "ModifyListing",
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "currency": "EUR",
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "kg",
      "outOfStockBehaviour": "NONE",
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "price": 1200,
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": []
      },
      "status": "ACTIVE",
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "subtitle": "44 2/3",
      "title": "Adidas Superstar",
      "weight": 1,
      "tags": []
    }
  ],
  "version": 42
}

[
  {
    "titleLocalized": {
      "de_DE": "Wert",
      "en_US": "Value",
      "ru_RU": "значение"
    },
    "attributes": [
      {
        "valueLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "keyLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "category": "descriptive",
        "context": {
          "type": "FACILITY_GROUP",
          "value": "text"
        },
        "key": "%%subtitle%%",
        "priority": 100,
        "type": "STRING",
        "value": "585er Gold"
      }
    ],
    "categoryRefs": [
      "text"
    ],
    "currency": "EUR",
    "customAttributes": {},
    "imageUrl": "text",
    "legal": {
      "hsCode": "text"
    },
    "measurementUnitKey": "liter",
    "outOfStockBehaviour": "NONE",
    "outOfStockBehaviourByContexts": [
      {
        "context": [
          {
            "operator": "NOT",
            "type": "FACILITY_GROUP",
            "values": [
              "uuid-bkrs-0157"
            ]
          }
        ],
        "outOfStockBehaviour": "NONE",
        "outOfStockConfig": {
          "preorder": {
            "availabilityTimeframe": {
              "start": "2020-02-03T08:45:50.525Z"
            }
          },
          "restock": {
            "restockableInDays": 1
          }
        },
        "priority": 100
      }
    ],
    "outOfStockConfig": {
      "preorder": {
        "availabilityTimeframe": {
          "start": "2020-02-03T08:45:50.525Z"
        }
      },
      "restock": {
        "restockableInDays": 1
      }
    },
    "price": 1200,
    "recordableAttributes": [
      {
        "keyLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "key": "Serialnumber",
        "recordingRule": "MANDATORY",
        "value": "Germany"
      }
    ],
    "scannableCodes": [
      "text"
    ],
    "scanningRule": {
      "values": []
    },
    "stockAvailableUntil": {
      "calculationBase": "EXPIRY",
      "modifier": "-P30D"
    },
    "stockProperties": {
      "ANY_ADDITIONAL_PROPERTY": {
        "defaultValue": "text",
        "inputType": "DATE",
        "required": true
      }
    },
    "tenantArticleId": "4711",
    "title": "Adidas Superstar",
    "weight": 1,
    "tags": [],
    "created": "2020-02-03T08:45:51.525Z",
    "lastModified": "2020-02-03T09:45:51.525Z",
    "version": 42,
    "facilityId": "4711",
    "id": "fsfdsf87fsd",
    "status": "ACTIVE"
  }
]

Delete listing

delete

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to delete a listing of. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

tenant ID of the articles listing you want to delete

Responses

200

Facility listing was found and successfully deleted

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

delete

/api/facilities/{facilityId}/listings/{tenantArticleId}

HTTPcURLJavaScriptPython

DELETE /api/facilities/{facilityId}/listings/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content