Carriers (Operations)

Endpoints to create, update, and read carriers.

List carriers

get

List carriers

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sizenumberOptional

startAfterIdstringOptional

Responses

200

The current list of available carriers

application/json

StrippedCarriers

totalintegerOptional

Total number of found entities for this query

Example: 42

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

get/api/carriers

HTTPcURLJavaScriptPython

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

{
  "carriers": [
    {
      "created": "2026-07-22T15:57:50.059Z",
      "deliveryType": "SAMEDAY",
      "id": "LGMl2DuvPnfPoSHhYFOm",
      "key": "DHL_V2",
      "lastModified": "2026-07-22T15:57:50.059Z",
      "lifecycle": "GA",
      "name": "DHL",
      "status": "ACTIVE",
      "version": 42
    }
  ],
  "total": 42
}

Create carrier

post

Create carrier

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CarrierForCreation

defaultParcelHeightInCmnumber · min: 1Optional

Default height in cm

Default: 10Example: 10

defaultParcelLengthInCmnumber · min: 1Optional

Default length in cm

Default: 25Example: 25

defaultParcelWeightInGramnumber · min: 1Optional

Default weight for a parcel in gram

Default: 1000Example: 1000

defaultParcelWidthInCmnumber · min: 1Optional

Default width in cm

Default: 35Example: 35

keystringRequired

References the KEP. Currently allowed values are DHL_V2, DPD_CH, DPD_CH_VCE, ANGEL, GLS, FEDEX, POSTNL, BRING, UPS, POST_NORD, DHL_EXPRESS, CUSTOM and to distinct between multiple custom carriers one can use CUSTOM_ combined with a unique name.

Example: DHL_V2

logoUrlstring · min: 1Optional

URL of the carrier logo

Example: https://example.com/resource

namestringRequired

This is the well known name for a supported CEP partner. Can be adapted to the clients needs.

Example: DHL Köln

productValueNeededbooleanOptional

Setting to enable the Client to ask for the parcel product value while ordering a label. This information is mandatory for sending parcels between different countries (customs declaration)

Example: true

statusstring · enumOptional

It is taken into consideration for all carriers. Default: INACTIVE

Possible values:

Responses

201

The carrier was successfully created. The Location header contains the URL of the carrier.

application/json

Carrier

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

defaultParcelHeightInCmnumber · min: 1Required

Default height in cm

Default: 10Example: 10

defaultParcelLengthInCmnumber · min: 1Required

Default length in cm

Default: 25Example: 25

defaultParcelWeightInGramnumber · min: 1Optional

Default weight for a parcel in gram

Default: 1000Example: 1000

defaultParcelWidthInCmnumber · min: 1Required

Default width in cm

Default: 35Example: 35

deliveryTypestring · enumOptional

Provided delivery of this CEP. Default: DELIVERY

Possible values:

idstringRequired

The id of the carrier

Example: LGMl2DuvPnfPoSHhYFOm

keystringRequired

References the KEP. Currently allowed values are DHL_V2, DPD_CH, DPD_CH_VCE, ANGEL, GLS, FEDEX, POSTNL, BRING, UPS, POST_NORD, DHL_EXPRESS, CUSTOM and to distinct between multiple custom carriers one can use CUSTOM_ combined with a unique name.

Example: DHL_V2

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

lifecyclestring · enumOptional

Used to determine if a carrier is available for configuration. GA carriers are generally available and are covered by our SLA. BETA carriers are available, but subject to change and not covered by SLA. ALPHA carriers are not implemented completely, yet. Default: GA

Possible values:

logoUrlstring · min: 1Optional

URL of the carrier logo

Example: https://example.com/resource

namestringRequired

This is the well known name for a supported CEP partner. Can be adapted to the clients needs.

Example: DHL Köln

productValueNeededbooleanOptional

Setting to enable the Client to ask for the parcel product value while ordering a label. This information is mandatory for sending parcels between different countries (customs declaration)

Example: true

statusstring · enumOptional

It is taken into consideration for all carriers. Default: INACTIVE

Possible values:

versionintegerRequired

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

Example: 42

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

post/api/carriers

HTTPcURLJavaScriptPython

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

{
  "credentials": {
    "key": "text"
  },
  "defaultParcelHeightInCm": 10,
  "defaultParcelLengthInCm": 25,
  "defaultParcelWeightInGram": 1000,
  "defaultParcelWidthInCm": 35,
  "key": "DHL_V2",
  "logoUrl": "https://example.com/resource",
  "name": "DHL Köln",
  "parcelLabelClassifications": [
    {
      "nameLocalized": {
        "de_DE": "S-Paket",
        "en_US": "S-Parcel",
        "ru_RU": "S-пакет"
      },
      "dimensions": {
        "customWeight": 1,
        "height": 1,
        "length": 1,
        "weight": 1,
        "width": 1
      },
      "services": {
        "bulkyGoods": false
      }
    }
  ],
  "productValueNeeded": true,
  "status": "ACTIVE"
}

{
  "created": "2026-07-22T15:57:50.059Z",
  "credentials": {
    "key": "text"
  },
  "defaultParcelHeightInCm": 10,
  "defaultParcelLengthInCm": 25,
  "defaultParcelWeightInGram": 1000,
  "defaultParcelWidthInCm": 35,
  "deliveryType": "SAMEDAY",
  "id": "LGMl2DuvPnfPoSHhYFOm",
  "key": "DHL_V2",
  "lastModified": "2026-07-22T15:57:50.059Z",
  "lifecycle": "GA",
  "logoUrl": "https://example.com/resource",
  "name": "DHL Köln",
  "parcelLabelClassifications": [
    {
      "nameLocalized": {
        "de_DE": "S-Paket",
        "en_US": "S-Parcel",
        "ru_RU": "S-пакет"
      },
      "dimensions": {
        "customWeight": 1,
        "height": 1,
        "length": 1,
        "weight": 1,
        "width": 1
      },
      "name": "S-Parcel",
      "services": {
        "bulkyGoods": false
      }
    }
  ],
  "productValueNeeded": true,
  "status": "ACTIVE",
  "version": 42
}

Get carrier

get

Get carrier

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

carrierIdstringRequired

Responses

200

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

application/json

Carrier

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

defaultParcelHeightInCmnumber · min: 1Required

Default height in cm

Default: 10Example: 10

defaultParcelLengthInCmnumber · min: 1Required

Default length in cm

Default: 25Example: 25

defaultParcelWeightInGramnumber · min: 1Optional

Default weight for a parcel in gram

Default: 1000Example: 1000

defaultParcelWidthInCmnumber · min: 1Required

Default width in cm

Default: 35Example: 35

deliveryTypestring · enumOptional

Provided delivery of this CEP. Default: DELIVERY

Possible values:

idstringRequired

The id of the carrier

Example: LGMl2DuvPnfPoSHhYFOm

keystringRequired

References the KEP. Currently allowed values are DHL_V2, DPD_CH, DPD_CH_VCE, ANGEL, GLS, FEDEX, POSTNL, BRING, UPS, POST_NORD, DHL_EXPRESS, CUSTOM and to distinct between multiple custom carriers one can use CUSTOM_ combined with a unique name.

Example: DHL_V2

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

lifecyclestring · enumOptional

Used to determine if a carrier is available for configuration. GA carriers are generally available and are covered by our SLA. BETA carriers are available, but subject to change and not covered by SLA. ALPHA carriers are not implemented completely, yet. Default: GA

Possible values:

logoUrlstring · min: 1Optional

URL of the carrier logo

Example: https://example.com/resource

namestringRequired

This is the well known name for a supported CEP partner. Can be adapted to the clients needs.

Example: DHL Köln

productValueNeededbooleanOptional

Setting to enable the Client to ask for the parcel product value while ordering a label. This information is mandatory for sending parcels between different countries (customs declaration)

Example: true

statusstring · enumOptional

It is taken into consideration for all carriers. Default: INACTIVE

Possible values:

versionintegerRequired

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

Example: 42

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/carriers/{carrierId}

HTTPcURLJavaScriptPython

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

{
  "created": "2026-07-22T15:57:50.059Z",
  "credentials": {
    "key": "text"
  },
  "defaultParcelHeightInCm": 10,
  "defaultParcelLengthInCm": 25,
  "defaultParcelWeightInGram": 1000,
  "defaultParcelWidthInCm": 35,
  "deliveryType": "SAMEDAY",
  "id": "LGMl2DuvPnfPoSHhYFOm",
  "key": "DHL_V2",
  "lastModified": "2026-07-22T15:57:50.059Z",
  "lifecycle": "GA",
  "logoUrl": "https://example.com/resource",
  "name": "DHL Köln",
  "parcelLabelClassifications": [
    {
      "nameLocalized": {
        "de_DE": "S-Paket",
        "en_US": "S-Parcel",
        "ru_RU": "S-пакет"
      },
      "dimensions": {
        "customWeight": 1,
        "height": 1,
        "length": 1,
        "weight": 1,
        "width": 1
      },
      "name": "S-Parcel",
      "services": {
        "bulkyGoods": false
      }
    }
  ],
  "productValueNeeded": true,
  "status": "ACTIVE",
  "version": 42
}

Update carrier

patch

Update carrier

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

carrierIdstringRequired

Body

application/json

CarrierPatchActions

versioninteger · int64Required

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

Example: 1

Responses

200

Carrier was found & patch-set has been applied. The patched entity is in the body.

application/json

Carrier

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

defaultParcelHeightInCmnumber · min: 1Required

Default height in cm

Default: 10Example: 10

defaultParcelLengthInCmnumber · min: 1Required

Default length in cm

Default: 25Example: 25

defaultParcelWeightInGramnumber · min: 1Optional

Default weight for a parcel in gram

Default: 1000Example: 1000

defaultParcelWidthInCmnumber · min: 1Required

Default width in cm

Default: 35Example: 35

deliveryTypestring · enumOptional

Provided delivery of this CEP. Default: DELIVERY

Possible values:

idstringRequired

The id of the carrier

Example: LGMl2DuvPnfPoSHhYFOm

keystringRequired

References the KEP. Currently allowed values are DHL_V2, DPD_CH, DPD_CH_VCE, ANGEL, GLS, FEDEX, POSTNL, BRING, UPS, POST_NORD, DHL_EXPRESS, CUSTOM and to distinct between multiple custom carriers one can use CUSTOM_ combined with a unique name.

Example: DHL_V2

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

lifecyclestring · enumOptional

Used to determine if a carrier is available for configuration. GA carriers are generally available and are covered by our SLA. BETA carriers are available, but subject to change and not covered by SLA. ALPHA carriers are not implemented completely, yet. Default: GA

Possible values:

logoUrlstring · min: 1Optional

URL of the carrier logo

Example: https://example.com/resource

namestringRequired

This is the well known name for a supported CEP partner. Can be adapted to the clients needs.

Example: DHL Köln

productValueNeededbooleanOptional

Setting to enable the Client to ask for the parcel product value while ordering a label. This information is mandatory for sending parcels between different countries (customs declaration)

Example: true

statusstring · enumOptional

It is taken into consideration for all carriers. Default: INACTIVE

Possible values:

versionintegerRequired

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

Example: 42

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

patch/api/carriers/{carrierId}

HTTPcURLJavaScriptPython

PATCH /api/carriers/{carrierId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 559

{
  "actions": [
    {
      "action": "ModifyCarrier",
      "credentials": {
        "key": "text"
      },
      "defaultParcelHeightInCm": 10,
      "defaultParcelLengthInCm": 25,
      "defaultParcelWeightInGram": 1000,
      "defaultParcelWidthInCm": 35,
      "deliveryType": "SAMEDAY",
      "lifecycle": "GA",
      "logoUrl": "https://example.com/resource",
      "name": "text",
      "parcelLabelClassifications": [
        {
          "nameLocalized": {
            "de_DE": "S-Paket",
            "en_US": "S-Parcel",
            "ru_RU": "S-пакет"
          },
          "dimensions": {
            "customWeight": 1,
            "height": 1,
            "length": 1,
            "weight": 1,
            "width": 1
          },
          "services": {
            "bulkyGoods": false
          }
        }
      ],
      "productValueNeeded": true,
      "status": "ACTIVE"
    }
  ],
  "version": 1
}

{
  "created": "2026-07-22T15:57:50.059Z",
  "credentials": {
    "key": "text"
  },
  "defaultParcelHeightInCm": 10,
  "defaultParcelLengthInCm": 25,
  "defaultParcelWeightInGram": 1000,
  "defaultParcelWidthInCm": 35,
  "deliveryType": "SAMEDAY",
  "id": "LGMl2DuvPnfPoSHhYFOm",
  "key": "DHL_V2",
  "lastModified": "2026-07-22T15:57:50.059Z",
  "lifecycle": "GA",
  "logoUrl": "https://example.com/resource",
  "name": "DHL Köln",
  "parcelLabelClassifications": [
    {
      "nameLocalized": {
        "de_DE": "S-Paket",
        "en_US": "S-Parcel",
        "ru_RU": "S-пакет"
      },
      "dimensions": {
        "customWeight": 1,
        "height": 1,
        "length": 1,
        "weight": 1,
        "width": 1
      },
      "name": "S-Parcel",
      "services": {
        "bulkyGoods": false
      }
    }
  ],
  "productValueNeeded": true,
  "status": "ACTIVE",
  "version": 42
}

Update transit time config

put

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

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

TransitTimeConfigurationForUpsert

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z

versioninteger · int64Required

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

Example: 42

calculationStrategystring · enumRequiredPossible values:

Responses

200

Transit time configuration was written successfully

application/json

TransitTimeConfiguration

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z

versioninteger · int64Required

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

Example: 42

calculationStrategystring · enumRequiredPossible values:

idstringRequired

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

Transit time configuration not found

application/json

put/api/configurations/transittime

HTTPcURLJavaScriptPython

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

{
  "calculationStrategy": "EARLIEST",
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}

{
  "calculationStrategy": "EARLIEST",
  "id": "text",
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}