Checkout Options (DOMS)

Endpoints used by shops to get the current available pickup stores and available service levels like Same-Day delivery.

List all record items (search cached for 5 minutes)

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Search for LookupRecordItem

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

LookupRecordItemSearchPayload

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.

Example: 10

startAfterIdstringOptionalDeprecated

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

Responses

200

Your search result

application/json

LookupRecordItemPaginatedResult

totalnumberOptional

The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.

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

post/api/lookuprecorditems/search

HTTPcURLJavaScriptPython

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

{
  "after": "text",
  "before": "text",
  "last": 1,
  "options": {
    "withTotal": true
  },
  "query": {
    "and": [
      {
        "and": [
          {
            "and": "[Circular Reference]",
            "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "or": "[Circular Reference]",
            "recordRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "tenantRecordId": "MY_RECORD_ID",
            "values": {
              "contains": {
                "attributeId": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                },
                "attributeValue": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "or": [
          {
            "and": "[Circular Reference]",
            "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "or": "[Circular Reference]",
            "recordRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "tenantRecordId": "MY_RECORD_ID",
            "values": {
              "contains": {
                "attributeId": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                },
                "attributeValue": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "recordRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "tenantRecordId": "MY_RECORD_ID",
        "values": {
          "contains": {
            "attributeId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "attributeValue": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
    "or": [
      {
        "and": "[Circular Reference]",
        "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "or": "[Circular Reference]",
        "recordRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "tenantRecordId": "MY_RECORD_ID",
        "values": {
          "contains": {
            "attributeId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "attributeValue": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "recordRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
    "tenantRecordId": "MY_RECORD_ID",
    "values": {
      "contains": {
        "attributeId": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "attributeValue": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        }
      }
    }
  },
  "size": 10
}

{
  "lookupRecordItems": [
    {
      "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "recordRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "tenantRecordId": "MY_RECORD_ID",
      "values": {
        "attributeId": "text",
        "attributeValue": "text"
      }
    }
  ],
  "pageInfo": {
    "endCursor": "text",
    "hasNextPage": true,
    "hasPreviousPage": true,
    "startCursor": "text"
  },
  "total": 1
}

Get all lookup records

get

Retrieves all lookup records.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successfully retrieved the lookup records.

application/json

LookupRecord

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequiredExample: 0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

versionnumberRequired

The version of the record.

Example: 1

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

The requested entity was not found

application/json

get/api/lookuprecords

HTTPcURLJavaScriptPython

GET /api/lookuprecords HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "attributeDefinitions": {},
  "created": "2026-07-22T15:57:49.621Z",
  "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
  "items": [
    {
      "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-07-22T15:57:49.621Z",
  "tenantRecordId": "MY_RECORD_ID",
  "version": 1
}

Create a lookup record by its ID

post

Creates a single lookup record.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

LookupRecordForCreation

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

Responses

200

Successfully created the lookup record.

application/json

LookupRecord

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequiredExample: 0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

versionnumberRequired

The version of the record.

Example: 1

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

The requested entity was not found

application/json

post/api/lookuprecords

HTTPcURLJavaScriptPython

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

{
  "attributeDefinitions": {},
  "items": [
    {
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "tenantRecordId": "MY_RECORD_ID"
}

{
  "attributeDefinitions": {},
  "created": "2026-07-22T15:57:49.621Z",
  "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
  "items": [
    {
      "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-07-22T15:57:49.621Z",
  "tenantRecordId": "MY_RECORD_ID",
  "version": 1
}

Get a lookup record by its ID

get

Retrieves a single lookup record using its unique identifier.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

recordIdstringRequired

Responses

200

Successfully retrieved the lookup record.

application/json

LookupRecord

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequiredExample: 0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

versionnumberRequired

The version of the record.

Example: 1

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

The requested entity was not found

application/json

get/api/lookuprecords/{recordId}

HTTPcURLJavaScriptPython

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

{
  "attributeDefinitions": {},
  "created": "2026-07-22T15:57:49.621Z",
  "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
  "items": [
    {
      "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-07-22T15:57:49.621Z",
  "tenantRecordId": "MY_RECORD_ID",
  "version": 1
}

Updates a whole lookup record by its ID

put

Updates a single lookup record.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

recordIdstringRequired

Body

application/json

LookupRecordForUpdate

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

versionnumberRequired

The version of the record.

Example: 1

Responses

200

Successfully updated the lookup record.

application/json

LookupRecord

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequiredExample: 0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

versionnumberRequired

The version of the record.

Example: 1

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

The requested entity was not found

application/json

put/api/lookuprecords/{recordId}

HTTPcURLJavaScriptPython

PUT /api/lookuprecords/{recordId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "attributeDefinitions": {},
  "items": [
    {
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "tenantRecordId": "MY_RECORD_ID",
  "version": 1
}

{
  "attributeDefinitions": {},
  "created": "2026-07-22T15:57:49.621Z",
  "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
  "items": [
    {
      "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-07-22T15:57:49.621Z",
  "tenantRecordId": "MY_RECORD_ID",
  "version": 1
}

Delete a lookup record by its ID

delete

Deletes a single lookup record using its unique identifier.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

recordIdstringRequired

Responses

200

Successfully deleted the lookup record.

application/json

LookupRecord

attributeDefinitionsobject · LookupAttributeDefinitionsRequired

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequiredExample: 0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Example: MY_RECORD_ID

versionnumberRequired

The version of the record.

Example: 1

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

The requested entity was not found

application/json

delete/api/lookuprecords/{recordId}

HTTPcURLJavaScriptPython

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

{
  "attributeDefinitions": {},
  "created": "2026-07-22T15:57:49.621Z",
  "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
  "items": [
    {
      "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-07-22T15:57:49.621Z",
  "tenantRecordId": "MY_RECORD_ID",
  "version": 1
}

Deprecated

Create checkout options

post

This part of the API is deprecated. For details, see the API release lifecycle documentation. Evaluate a checkout options input against the DOMS.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CheckoutOptionsInput

filterDuplicatesbooleanOptional

Filter duplicate facilities

Example: true

orderLineItemsobject[]Required

Order line items

tagsobject[]Optional

Tags

Responses

200

The request could be evaluated

application/json

or

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

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

post/api/promises/checkoutoptions

HTTPcURLJavaScriptPython

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

{
  "consumerAddress": {
    "addressType": "POSTAL_ADDRESS",
    "city": "Yellowstone",
    "country": "DE",
    "houseNumber": 42,
    "postalCode": "42420",
    "province": "text",
    "street": "text"
  },
  "customAttributes": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "customServices": [
    {
      "articleItems": [
        {
          "quantity": 1,
          "tenantArticleRef": "text"
        }
      ],
      "customServiceDefinition": {
        "additionalInformation": [
          {
            "additionalInformationRef": "text",
            "tenantAdditionalInformationId": "text",
            "value": "text"
          }
        ],
        "customAttributes": {},
        "customServiceRef": "text",
        "isBundled": true,
        "tenantCustomServiceId": "text"
      },
      "customServiceItems": [
        {
          "articleItems": [
            {
              "quantity": 1,
              "tenantArticleRef": "text"
            }
          ],
          "customServiceDefinition": {
            "additionalInformation": [
              {
                "additionalInformationRef": "text",
                "tenantAdditionalInformationId": "text",
                "value": "text"
              }
            ],
            "customAttributes": {},
            "customServiceRef": "text",
            "isBundled": true,
            "tenantCustomServiceId": "text"
          },
          "customServiceItems": "[Circular Reference]"
        }
      ],
      "id": "text"
    }
  ],
  "deliveryPreferences": {
    "collect": [
      null
    ],
    "reservationPreferences": {
      "mode": "SCHEDULED",
      "reservationTime": "2020-02-03T09:45:51.525Z"
    },
    "shipping": {
      "carrierProductCategory": "STANDARD",
      "desiredDeliveryTime": "2020-02-03T09:45:51.525Z",
      "preferredCarriers": [
        "text"
      ],
      "preferredCarriersWithProduct": [
        {
          "carrierKey": "DPD",
          "carrierProduct": "WORLDWIDE",
          "carrierServices": [
            "SIGNATURE"
          ]
        }
      ],
      "preselectedFacilities": [
        null
      ],
      "serviceLevel": "DELIVERY"
    },
    "sourcingOptionRefs": [
      "928f3730-bc48-4d85-b83f-3fd86b776178"
    ],
    "supplyingFacilities": [
      "928f3730-bc48-4d85-b83f-3fd86b776178"
    ],
    "targetTime": "2020-02-03T09:45:51.525Z"
  },
  "filterDuplicates": true,
  "geoFence": {
    "lat": 50.968713,
    "lon": 7.011375,
    "radius": 1
  },
  "orderLineItems": [
    {}
  ],
  "tags": [
    {}
  ]
}

{
  "facilities": [
    {
      "address": {
        "additionalAddressInfo": "to care of: Mrs. Müller",
        "city": "Langenfeld",
        "country": "DE",
        "customAttributes": {},
        "houseNumber": "42a",
        "phoneNumbers": [
          {
            "customAttributes": {},
            "label": "text",
            "type": "MOBILE",
            "value": "text"
          }
        ],
        "postalCode": "40764",
        "province": "NRW",
        "street": "Hauptstr.",
        "companyName": "Speedy Boxales Ltd.",
        "emailAddresses": [
          {
            "recipient": "'Mailinglist reaching all the employees', 'Marc Fulton, Manager', etc.",
            "value": "text"
          }
        ],
        "resolvedCoordinates": {
          "lat": 50.937531,
          "lon": 6.960279
        },
        "resolvedTimeZone": {
          "offsetInSeconds": 28800,
          "source": "Google Maps API",
          "timeZoneId": "America/Los_Angeles",
          "timeZoneName": "Pacific Standard Time"
        }
      },
      "availabilities": [
        {
          "available": 42,
          "carrier": {
            "carrierProductCategory": "STANDARD",
            "carrierRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
          },
          "isBackOrderable": true,
          "latestPickingStart": "2026-06-17T12:00:00.000Z",
          "preOrderReleaseDate": "2026-06-17T12:00:00.000Z",
          "tenantArticleId": "MY_ARTICLE_ID"
        }
      ],
      "closingDays": [
        {
          "date": "2020-02-03T09:45:51.525Z",
          "reason": "text",
          "recurrence": "YEARLY"
        }
      ],
      "customServices": [
        {
          "customServiceRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "name": "text"
        }
      ],
      "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "name": "text",
      "pickingTimes": {
        "friday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ],
        "monday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ],
        "saturday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ],
        "sunday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ],
        "thursday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ],
        "tuesday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ],
        "wednesday": [
          {
            "capacity": 1,
            "end": {
              "hour": 1,
              "minute": 1
            },
            "start": {
              "hour": 1,
              "minute": 1
            }
          }
        ]
      },
      "targetTime": "2026-06-17T12:00:00.000Z"
    }
  ]
}

Get earliest collect

post

Get earliest collect timepoint for a given checkoutOption

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CheckoutOptionsCollectEarliestRequest

desiredCollectDatestring · date-timeOptional

Desired collection date

Example: 2026-06-17T12:00:00.000Z

includeCalculationHintsbooleanOptional

Whether to include calculation hints in the response

Example: true

tenantArticleIdsstring[] · min: 1Required

List of tenant article IDs

Responses

200

The request could be evaluated

application/json

CheckoutOptionsCollectEarliestResponse

calculationHintsstring[]Optional

Calculation hints

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

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

post/api/promises/checkoutoptions/collect/earliest

HTTPcURLJavaScriptPython

POST /api/promises/checkoutoptions/collect/earliest HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "desiredCollectDate": "2026-06-17T12:00:00.000Z",
  "facilities": [
    {
      "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
    }
  ],
  "includeCalculationHints": true,
  "tenantArticleIds": [
    "text"
  ]
}

{
  "calculationHints": [
    "text"
  ],
  "checkoutOptions": [
    {
      "available": 42,
      "earliestPredictedProvisioningDate": "2026-06-17T12:00:00.000Z",
      "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "latestPickingStartDate": "2026-06-17T12:00:00.000Z",
      "tenantArticleId": "MY_ARTICLE_ID",
      "tenantFacilityId": "MY_FACILITY_ID"
    }
  ]
}

Get earliest delivery

post

Get earliest delivery timepoint for a given checkoutOption

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CheckoutOptionsDeliveryEarliestRequest

earliestDeliveryDatestring · date-timeOptional

Earliest delivery date

Example: 2026-06-17T12:00:00.000Z

includeCalculationHintsbooleanOptional

Whether to include calculation hints in the response

Example: true

includeListingDetailsbooleanOptional

Indicates whether listing-related details should be included in the response. If set to true, the response contains additional listing details. Defaults to false.

tenantArticleIdsstring[] · min: 1Required

List of tenant article IDs

Responses

200

The request could be evaluated

application/json

CheckoutOptionsDeliveryEarliestResponse

calculationHintsstring[]Optional

Calculation hints for debugging

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

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

post/api/promises/checkoutoptions/delivery/earliest

HTTPcURLJavaScriptPython

POST /api/promises/checkoutoptions/delivery/earliest HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 341

{
  "consumerAddress": {
    "addressType": "POSTAL_ADDRESS",
    "city": "Yellowstone",
    "country": "DE",
    "houseNumber": 42,
    "postalCode": "42420",
    "province": "text",
    "street": "text"
  },
  "earliestDeliveryDate": "2026-06-17T12:00:00.000Z",
  "filter": {
    "customAttributes": {},
    "tags": []
  },
  "includeCalculationHints": true,
  "includeListingDetails": true,
  "tenantArticleIds": [
    "text"
  ]
}

{
  "calculationHints": [
    "text"
  ],
  "checkoutOptions": [
    {
      "availableCarriers": [
        {
          "carrierRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "latestPickingStartDate": "2026-06-17T12:00:00.000Z",
          "name": "text",
          "nonDeliveryDays": [
            "text"
          ]
        }
      ],
      "availableFacilityConnections": [
        {
          "connectionRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "latestPickingStartDate": "2026-06-17T12:00:00.000Z",
          "nonDeliveryDays": [
            "text"
          ]
        }
      ],
      "earliestPredictedDeliveryDate": "2026-06-17T12:00:00.000Z",
      "listingDetails": [
        {
          "customAttributes": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "tenantFacilityId": "MY_FACILITY_ID"
        }
      ],
      "tenantArticleId": "MY_ARTICLE_ID"
    }
  ]
}

Get delivery time period

post

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CheckoutOptionsDeliveryTimePeriodRequest

endDatestring · date-timeOptional

End date-time of the period

Example: 2026-06-17T12:00:00.000Z

includeCalculationHintsbooleanOptional

Whether to include calculation hints in the response

Example: true

startDatestring · date-timeOptional

Start date-time of the period

Example: 2026-06-17T12:00:00.000Z

Responses

200

The request could be evaluated

application/json

CheckoutOptionsDeliveryTimePeriodResponse

calculationHintsstring[]Optional

Calculation hints

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

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

post/api/promises/checkoutoptions/delivery/timeperiod

HTTPcURLJavaScriptPython

POST /api/promises/checkoutoptions/delivery/timeperiod HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 638

{
  "basket": [
    {
      "quantity": 42,
      "tenantArticleId": "MY_ARTICLE_ID"
    }
  ],
  "consumerAddress": {
    "addressType": "POSTAL_ADDRESS",
    "city": "Yellowstone",
    "country": "DE",
    "houseNumber": 42,
    "postalCode": "42420",
    "province": "text",
    "street": "text"
  },
  "deliveryPreferences": {
    "carrierProductCategory": "STANDARD",
    "desiredDeliveryTime": "2020-02-03T09:45:51.525Z",
    "preferredCarriers": [
      "text"
    ],
    "preferredCarriersWithProduct": [
      {
        "carrierKey": "DPD",
        "carrierProduct": "WORLDWIDE",
        "carrierServices": [
          "SIGNATURE"
        ]
      }
    ],
    "preselectedFacilities": [
      null
    ],
    "serviceLevel": "DELIVERY"
  },
  "endDate": "2026-06-17T12:00:00.000Z",
  "includeCalculationHints": true,
  "startDate": "2026-06-17T12:00:00.000Z"
}

{
  "calculationHints": [
    "text"
  ],
  "checkoutOptions": [
    {
      "availableCarriers": [
        {
          "carrierRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "latestPickingStartDate": "2026-06-17T12:00:00.000Z",
          "name": "text",
          "nonDeliveryDays": [
            "text"
          ]
        }
      ],
      "availableFacilityConnections": [
        {
          "connectionRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "latestPickingStartDate": "2026-06-17T12:00:00.000Z",
          "nonDeliveryDays": [
            "text"
          ]
        }
      ],
      "date": "2026-06-17T12:00:00.000Z",
      "overallStatus": "ALL"
    }
  ]
}

Get delivery timepoint

post

This endpoint is to be used to get information about the possible delivery of items.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CheckoutOptionsDeliveryTimePointRequest

desiredDeliveryDatestring · date-timeRequired

Desired delivery date-time

Example: 2026-06-17T12:00:00.000Z

tenantArticleIdsstring[]Required

Tenant article IDs

Responses

200

The request could be evaluated

application/json

CheckoutOptionsDeliveryTimePointResponse

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

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

post/api/promises/checkoutoptions/delivery/timepoint

HTTPcURLJavaScriptPython

POST /api/promises/checkoutoptions/delivery/timepoint HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 196

{
  "desiredDeliveryDate": "2026-06-17T12:00:00.000Z",
  "facilities": [
    {
      "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "latestPickingStart": "2026-06-17T12:00:00.000Z"
    }
  ],
  "tenantArticleIds": [
    "text"
  ]
}

{
  "items": [
    {
      "available": 42,
      "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "latestPickingStart": "2026-06-17T12:00:00.000Z",
      "tenantArticleId": "MY_ARTICLE_ID"
    }
  ]
}