Eurosender API (2025-03.1)

Take the complexity out of logistics with Eurosender’s multi-carrier shipping API. Connect to a global network of trusted carriers and access over 150 million pre-negotiated rates—all through one simple integration.

Automate your shipping workflows, reduce costs, and scale your operations as your business grows. From real-time tracking to faster deliveries and better customer experience, the API gives you the tools to move smarter and faster—without the overhead.

Download OpenAPI description

index.json

index.yaml

Servers

Sandbox

https://sandbox-api.eurosender.com/

Production

https://api.eurosender.com/

Quote Endpoints

The Quote endpoint allows you to obtain accurate and up-to-date pricing for your desired shipment based on package details, service types, and other criteria. By providing comprehensive shipment information, you can receive tailored quotes reflecting available shipping options, estimated costs, and any applicable fees. This powerful feature enables businesses to compare different shipping methods, optimize cost-efficiency, and provide transparent pricing to end users — all through seamless API integration. Whether you’re shipping parcels, pallets, or freight, the Quote endpoint delivers fast, reliable data essential for making informed logistics decisions.

Key benefits include:

Real-time pricing based on shipment details and service types
Access to multiple shipping options with clear cost breakdowns
Support for additional services and date-based price adjustments
Foundation for subsequent order creation and validation workflows

Use this endpoint to streamline your shipping process and empower your customers with immediate, transparent shipping quotes.

Operations

Get Quote

Request

The Quote endpoint allows you to obtain real-time shipping rates based on your specified shipment details—such as parcel dimensions, weight, service type, and pickup/delivery locations. This ensures you can present precise, up-to-date pricing options to your customers or internal systems before creating an order.

Key features:

Supports multiple parcels and service types
Returns detailed pricing breakdown including optional services and pickup date fees
Enables comparison of different shipping options for optimized cost-efficiency

Security

x_api_key

Bodyapplication/jsonrequired

The new QuoteRequest resource

shipmentobject(ShipmentRequest)required

Shipment details (where and when to ship)

shipment.pickupAddressobject(ShipmentAddressRequest)required

shipment.pickupAddress.countryanyrequired

Country code in ISO 3166-1 alpha-2

Example: "LU"

shipment.pickupAddress.zipany

ZIP code

Example: "1911"

shipment.pickupAddress.cityany

City name, belonging to ZIP code. For cases where providing exact city name is mandatory (like Ireland or Romania), it can be retrieved from endpoint /v1/countries/{countryCode}/cities. This condition depends on Country, flag for this is available at endpoint /v1/countries. If cityId is provided, this field can be empty.

Example: "Luxembourg"

shipment.pickupAddress.cityIdany

ID of the City for cases where providing exact city is mandatory (like Ireland or Romania), it can be retrieved from endpoint /v1/countries/{countryCode}/cities. This condition depends on Country, flag for this is available at endpoint /v1/countries. If exact city name is provided in field city, this field can be empty. Example value: 1341 for Dublin in region County Dublin in Ireland

Default null

shipment.pickupAddress.streetstring or null

Street name with house number

Example: "9 Rue du Laboratoire"

shipment.pickupAddress.regionany

Region name. For cases where providing region (name, code or ID) is mandatory, like Ireland, Romania, Italy, USA, Canada, it can be retrieved from endpoint /v1/countries/{countryCode}/regions. This condition depends on Country, flag for this is available at endpoint /v1/countries. If regionCode or regionId is provided, this field can be empty. Example value: County Dublin in Ireland

Default null

shipment.pickupAddress.regionCodeany

Region code. For cases where providing region (name, code or ID) is mandatory, like Ireland, Romania, Italy, USA, Canada, it can be retrieved from endpoint /v1/countries/{countryCode}/regions. This condition depends on Country, flag for this is available at endpoint /v1/countries. If region or regionId is provided, this field can be empty. This field is supported only for some countries (Italy, USA, Canada). Example value: AC for region Ancona in Italy

Default null

shipment.pickupAddress.regionIdany

Region ID. For cases where providing region (name, code or ID) is mandatory, like Ireland, Romania, Italy, USA, Canada, it can be retrieved from endpoint /v1/countries/{countryCode}/regions. This condition depends on Country, flag for this is available at endpoint /v1/countries. If region or regionCode is provided, this field can be empty. Example value: 6 for region County Dublin in Ireland

Default null

shipment.pickupAddress.customFieldsany

Additional address fields that can be provided for some countries, like doorbell for Germany. Availability of the fields and flag if optional or required can be retrieved from endpoint /v1/countries.

Default []

shipment.pickupAddress.pudoPointCodestring or null

For internal use only

Example: null

shipment.pickupAddress.customerPudoNumberstring or null

For internal use only

Example: null

shipment.pickupAddress.additionalInfoanyDeprecated

Not used.

Default null

shipment.pickupAddress.timeZoneNameanyDeprecated

Not used.

Default null

shipment.deliveryAddressobject(ShipmentAddressRequest)required

shipment.deliveryAddress.countryanyrequired

Country code in ISO 3166-1 alpha-2

Example: "LU"

shipment.deliveryAddress.zipany

ZIP code

Example: "1911"

shipment.deliveryAddress.cityany

Example: "Luxembourg"

shipment.deliveryAddress.cityIdany

Default null

shipment.deliveryAddress.streetstring or null

Street name with house number

Example: "9 Rue du Laboratoire"

shipment.deliveryAddress.regionany

Default null

shipment.deliveryAddress.regionCodeany

Default null

shipment.deliveryAddress.regionIdany

Default null

shipment.deliveryAddress.customFieldsany

Default []

shipment.deliveryAddress.pudoPointCodestring or null

For internal use only

Example: null

shipment.deliveryAddress.customerPudoNumberstring or null

For internal use only

Example: null

shipment.deliveryAddress.additionalInfoanyDeprecated

Not used.

Default null

shipment.deliveryAddress.timeZoneNameanyDeprecated

Not used.

Default null

shipment.pickupDatestring(date-time)

Pickup date, can be empty to retrieve first possible date (minPickupDate). Time part is ignored. Value must be in RFC3339 format (for example 2023-04-04T00:00:00Z)

Default "2023-04-04T00:00:00Z"

shipment.pickupTypestring or null

Specifies if new pickup needs to be scheduled (new_pickup_request), or there is already pre-arranged regular pickup scheduled (scheduled_pickup), or there is no need for pickup because the shipment will be dropped off at a courier location (drop_off).
Not supported (ignored) on some couriers.

Default "new_pickup_request"

Enum"new_pickup_request""scheduled_pickup""drop_off"null

Example: "new_pickup_request"

shipment.independentPickupboolean

Pickup request with desires pickup time frame will be called independently (in 30 minutes) by using Pickup endpoint.

Default false

Example: false

shipment.pickupContactShipmentContactRequest (object) or null

Pickup contact, not needed for Quote, but required for Order.

Any of:

Pickup contact, not needed for Quote, but required for Order.

shipment.deliveryContactShipmentContactRequest (object) or null

Delivery contact, not needed for Quote, but required for Order.

Any of:

Delivery contact, not needed for Quote, but required for Order.

shipment.addOnsany

Extra addons that can be selected/activated if supported (returned by Quote)

Default []

Enum"flexibleChanges""early_delivery"

parcelsobject(ParcelsRequest)required

Parcels details (what to ship)

parcels.envelopesany

envelopes is named 'Documents' on website. More info

Default []

parcels.packagesArray of objects(PackageRequest)

parcels.palletsArray of objects(PalletRequest)

parcels.vansArray of objects(VanRequest)

Can be used only with serviceType van

parcels.ltlsArray of objects(LtlRequest)<= 1 items

LTL: Less than truckload
Only one allowed per shipment, can't be mixed with FTL
Can be used only with serviceType ftl

parcels.ftlsArray of objects(FtlRequest)

FTL: Full truckload
Can't be mixed with LTL
Can be used only with serviceType ftl

paymentMethodstringrequired

Payment method, where credit is for User credits (pre-paid, Wallet) and deferred must be additionally approved to be enabled for use. Other payment methods are not supported.

Default "deferred"

Enum"credit""deferred"

Example: "credit"

currencyCodestring

Only EUR supported.

Default "EUR"

Value"EUR"

Example: "EUR"

serviceTypestring

Service type to use. More on service types

Enum"selection""flexi""regular_plus""express""freight""freight_priority""freight_priority_express""van""ftl"

Example: "selection"

serviceSubtypestring or null

For internal use only.

Default null

Enum"door_to_door""door_to_shop""shop_to_door""shop_to_shop"

Example: "door_to_door"

courierTagstring or null

For internal use only.

Example: null

preferredCouriersOnlyboolean

For internal use only

Default false

courierIdinteger or null

Explicit courier to use, for internal use only.

Example: null

insuranceIdinteger or null

Additional insurance ID, applicable for selected service type, one of the values from Quote response under options.serviceTypes[].insurances[]

Example: null

labelFormatstring or null

Format in which labels will be created. Defaults to pdf. zpl format is not available for all couriers.

Default null

Enum"pdf""zpl"

Example: null

curl -i -X POST \
  https://sandbox-api.eurosender.com/v1/quotes \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "shipment": {
      "pickupAddress": {
        "country": "LU",
        "zip": "1911",
        "city": "Luxembourg",
        "cityId": null,
        "street": "9 Rue du Laboratoire",
        "additionalInfo": null,
        "region": null,
        "regionCode": null,
        "regionId": null,
        "timeZoneName": null,
        "customFields": [],
        "pudoPointCode": null,
        "customerPudoNumber": null
      },
      "deliveryAddress": {
        "country": "LU",
        "zip": "1911",
        "city": "Luxembourg",
        "cityId": null,
        "street": "9 Rue du Laboratoire",
        "additionalInfo": null,
        "region": null,
        "regionCode": null,
        "regionId": null,
        "timeZoneName": null,
        "customFields": [],
        "pudoPointCode": null,
        "customerPudoNumber": null
      },
      "pickupDate": "2023-04-04T00:00:00Z",
      "pickupType": "new_pickup_request",
      "independentPickup": false,
      "pickupContact": {
        "name": "Eurosender SARL",
        "email": "name@example.com",
        "phone": "+442031292884"
      },
      "deliveryContact": {
        "name": "Eurosender SARL",
        "email": "name@example.com",
        "phone": "+442031292884"
      },
      "addOns": "flexibleChanges"
    },
    "parcels": {
      "envelopes": [],
      "packages": [
        {
          "parcelId": "A00001",
          "quantity": 1,
          "width": 14,
          "height": 14,
          "length": 15,
          "weight": 2,
          "content": "books",
          "value": 150
        }
      ],
      "pallets": [
        {
          "parcelId": "B00001",
          "quantity": 1,
          "width": 80,
          "height": 100,
          "length": 120,
          "weight": 50,
          "content": "tires",
          "value": 500,
          "isStackable": true
        }
      ],
      "vans": [
        {
          "parcelId": "A00001",
          "vanType": "small_van",
          "optionalServices": [
            "help_loading"
          ]
        }
      ],
      "ltls": [
        {
          "parcelId": "T00001",
          "euroPalletQuantity": 12,
          "loadingMeters": null,
          "weight": 3600,
          "notes": "12x 120x80x220cm, 300kg/pallet, total weight: 3.600kg, not-stackable, boxes with a spare parts packed on pallets"
        }
      ],
      "ftls": [
        {
          "parcelId": "T00001"
        }
      ]
    },
    "paymentMethod": "credit",
    "currencyCode": "EUR",
    "serviceType": "selection",
    "serviceSubtype": "door_to_door",
    "courierTag": null,
    "preferredCouriersOnly": false,
    "courierId": null,
    "insuranceId": null,
    "labelFormat": null
  }'

Responses

QuoteRequest resource created

Bodyapplication/json

optionsobject(QuoteOptionsResponse)

orderQuoteOrderResponse (object) or null

Any of:

warningsArray of objects(QuoteWarningResponse)

Response

application/json

{
  "options": {
    "serviceTypes": [ … ],
    "parcelLevelOptionalServices": [ … ],
    "generalTermsAndConditionsLink": null,
    "paymentMethods": [ … ]
  },
  "order": {
    "totalPrice": { … },
    "insuranceId": null,
    "parcels": [ … ],
    "paymentDiscount": { … },
    "addOns": "flexibleChanges",
    "serviceType": "string",
    "serviceSubtype": "string",
    "minPickupDate": "2019-08-24T14:15:22Z",
    "estimatedDeliveryTime": "string",
    "courierId": null,
    "courierTag": null,
    "calculatedDistance": 0
  },
  "warnings": [
    { … }
  ]
}

Order Endpoints

The Order section of the Eurosender API offers a full set of endpoints to manage every step of the shipping lifecycle. From orders creation and rder validating orders, scheduling pickups, accessing shipping documents, and tracking deliveries—this section provides the tools needed to integrate smooth, automated logistics operations into your system.

Key capabilities include:

Order Creation: Easily create orders and generate shipment labels
Order Validation: Validate your order data before submission to prevent errors
Pickup Scheduling: Schedule and manage pickup timeframes for your shipments
Order Cancellation: Cancel orders when allowed, before they enter shipping
Order Tracking: Monitor shipment status and delivery progress in real time
Document Retrieval: Access essential documents such as invoices, labels, and tracking codes
Proforma Invoice Management: Create and upload proforma invoices for customs clearance
Order Details Retrieval: Retrieve comprehensive status and information for a specific order using its order code.

By leveraging these endpoints, businesses can automate workflows, reduce manual errors, and ensure efficient, reliable delivery service for their customers.

Operations

Proforma Endpoints

The Proforma endpoints enable you to handle all necessary customs documentation required for shipments involving exports or imports. When an order status indicates Awaiting customs documentation, you can use these endpoints to create and upload proforma invoices, ensuring smooth customs clearance and uninterrupted shipment processing.

This functionality is critical for compliance with international shipping regulations and helps avoid delays at customs by providing accurate and timely documentation. You can create proforma documents via the API, submit the required data, and upload PDF invoices encoded in base64 format when necessary.

Key features include:

Creating and managing proforma invoices tied to specific orders.
Uploading PDF proforma invoices securely through the API.
Ensuring compliance with customs requirements to prevent shipment delays.
Streamlining the documentation workflow as part of your shipping process automation.

Integrating proforma management into your system guarantees a seamless customs clearance experience, saving time and reducing administrative overhead.

Operations

Country Endpoints

The Country endpoints deliver comprehensive geographic data necessary for precise and compliant shipment handling with the Eurosender API. These endpoints return lists of supported countries, cities, and regions used to define shipment origins and destinations.

Certain countries—such as Ireland, Romania, Italy, the USA, and Canada—require specifying the region (by ID, name, or code) when placing orders. For some of these countries, providing the exact city name or city ID is also mandatory. These requirements are flagged within the country data payload to guide proper order submission.

The response also includes associated region IDs accessible via the /v1/countries/{countryCode}/regions endpoint, allowing for structured regional selection.

Using these endpoints helps ensure your system validates location data accurately, prevents order errors, and complies with local shipping regulations.

Operations

Pickup Endpoints

The Pickup endpoints enable precise management of shipment pickups within the Eurosender API ecosystem. These endpoints support:

Initiating pickup requests for orders marked with independentPickup: true, allowing users to control pickup scheduling manually.
Retrieving available pickup time slots for orders, contingent on the availability flag options.serviceTypes.pickupTimeFrameSelectionPossible set to true in the quote response.
Automatic pickup scheduling if a manual pickup request is not triggered within 30 minutes after order placement, using default pickup time windows.

This functionality ensures your shipments are collected efficiently, providing flexibility to tailor pickup timings while automating routine scheduling. Proper use of these endpoints helps streamline logistics operations and improve delivery reliability.

Operations

Pudo List Endpoint

This endpoint retrieves a list of available Pick-Up Drop-Off (PUDO) points based on the shipment criteria provided. It is designed for service types that involve delivery to or from a designated pick-up location, including:

door_to_shop: home collection to a PUDO point
shop_to_door: PUDO drop-off to a home delivery
shop_to_shop: PUDO drop-off to another PUDO location

Use this endpoint to present users with a selection of eligible PUDO points near the sender's or recipient’s address, enabling flexible and convenient shipping arrangements.

Operations

Webhooks

You can subscribe to a set of events sent by our webhooks. Log in to your Eurosender business account. Navigate to User dashboard → New order → Public API tab. Here you can enable webhooks and see their status. Supported webhooks:

Label(s) ready id: 1 code: order_label_ready Trigger: When label(s) for an order become available (only for orders that require label printing).
Order was submitted to courier id: 2 code: order_submitted_to_courier Trigger: When shipping is booked in the courier's system.
Tracking code(s) ready id: 3 code: order_tracking_ready Trigger: When tracking codes become available for the order, but only if they weren't already available when submitted.
Order was cancelled id: 4 code: order_cancelled Trigger: When (or if) an order is cancelled.
Delivery status id: 5 code: delivery_status_updated Trigger: When a new delivery status event is dispatched.

Webhooks 1–4 send data in the request headers using the pattern below:

Headers:

Webhook-Id: unique_id_for_each_webhook_sent
Webhook-Event: code
Webhook-Signature:...

Body:

{ 'triggerId': id, 'orderCode': '123456-12', 'courierId': 23, # only for webhhok 2 'trackingCodes': [	# only for webhooks 2, 3 { 'orderCode': '123456-12', 'trackingNumber': '11111111', 'trackingUrl': 'https://demo.com/?track=1111111' } ] }

Webhook Delivery status sends data in request header as per pattern below (same payload as GET /v1/orders/{orderCode}/tracking endpoint).

Example:

{ 'notifications': [ { 'trackingDetails': { 'parcels': [ { 'parcelId': 'ebbfce6a-000e-00b4-99aa-004dc9b3ee9a', 'orderCode': '011231-24', 'trackingNumber': '10000010007', 'currentStatus': 'InfoReceived', 'currentSubstatus': 'InfoReceived_001', 'updatedDate': '2024-06-11T09:55:47+02:00', 'expectedDeliveryDate': null, 'pickupDate': '2024-06-10T14:34:31+02:00', 'deliveryDate': null, 'signedBy': null, 'checkpoints': [ { 'eventDate': '2024-06-10T14:34:31+02:00', 'status': 'InTransit', 'substatus': 'InTransit_001', 'location': null, 'countryCode': null, 'message': 'Data sent' }, { 'eventDate': '2024-06-11T11:18:24+02:00', 'status': 'InfoReceived', 'substatus': 'InfoReceived_001', 'location': 'LJUBLJANA', 'countryCode': null, 'message': 'P&S/P&R picked up' } ] } ] }, 'orderCode': '736361-24', 'triggerId': 5 } ] }

Eurosender API (2025-03.1)

Quote Endpoints

Get Quote

RequestExpand all

Responses

Was this helpful?

Order Endpoints

Proforma Endpoints

Country Endpoints

Pickup Endpoints

Pudo List Endpoint

Webhooks

Request