Statistics
Reporting over your shipments, as data you can chart or export. Requires the statistics read permission.
Each endpoint covers a period set by dateFrom and dateTo, and returns the totals for that period together with the usual breakdowns: by courier, by country, by source and so on. One call gives you every breakdown for the period, so there is nothing to page through and no query to put together.
To list the shipments themselves rather than count them, use GET /v2/shipments. A period can cover up to one year and is filtered on the date each shipment was created.
Figures are current, not frozen. Every count reflects each shipment's status at generatedAt, not at the end of the period. Re-running a past period returns different numbers until every shipment in it has stopped moving.
Breakdowns are independent of one another: there is no way to combine two of them, such as one courier's shipments to one country. For that, list shipments with GET /v2/shipments and aggregate them yourself.
For short conversational answers inside an AI assistant rather than a full data set, see the MCP server.
Get shipment statistics
Returns how many shipments you sent in a period and what happened to them, broken down by courier, source, destination country, delivery type and payment type.
Courier figures come at two levels: byCourier totals each courier across all its profiles, and byCourierProfile splits the same numbers per configured service.
Status figures come in two forms. byStatus lists each tracking status on its own. buckets gives four broader groupings, combining the two pickup-point statuses and the two failure statuses — use these for an overview, and byStatus when you need the detail behind them.
Use this rather than paging through GET /v2/shipments to count them.
query Parameters
dateFromStart of the period, inclusive (format yyyy-MM-ddTHH:mm:ss.fff), based on the shipment creation date. The period can span up to one year.
dateToEnd of the period, inclusive (format yyyy-MM-ddTHH:mm:ss.fff).
Headers
Accept-LanguageLanguage code for localized responses
Get shipment statistics › Responses
Shipment statistics for the period
Period the figures cover.
generatedAtWhen the figures were worked out (format yyyy-MM-ddTHH:mm:ss.fff)
totalShipmentsAll shipments created in the period
codShipmentsHow many of those were cash on delivery
notDeliveredCodShipmentsCash-on-delivery shipments that failed or came back
Shipment counts per tracking status. Every status is always present, so one with no shipments returns 0 rather than being left out. Anything outside this list is counted as unknown.
Four convenience groupings over byStatus: atPickupPoint combines ready_for_pickup and ready_for_pickup_2_days, and notDelivered combines not_delivered and returned.
They cover six of the eight statuses. created and unknown belong to no grouping, so the four figures sum to at most the shipment total, not exactly — do not use them as the slices of a whole.
One entry per courier, most shipments first
The same figures split by courier profile, most shipments first
One entry per source and profile, most shipments first
One entry per destination country, most shipments first
Address deliveries versus pickup-point deliveries
One entry per payment type, most shipments first
One entry per calendar month in the period, oldest first
Get delivery time statistics
Returns how long deliveries took in a period — average times and how many shipments arrived on each day from D+0 to D+7+, overall and per courier.
Only delivered shipments can be timed, so anything still in transit, returned or failed is left out. measuredShipments is how many the figures are based on — compare it with delivered from GET /v2/statistics/shipments for the same period.
Because a recent period contains shipments that have not arrived yet, its average is based on the faster ones that already have. Expect the figure to rise as the remaining shipments land.
Times are in calendar hours, weekends included. For a parcel sent to a pickup point, the courier's leg ends when it arrives there, not when the recipient collects it.
Two timings are given. avgShipping* covers the courier's leg, from handover to delivery. avgTotal* starts when the order was created, so it also includes your own dispatch time; it covers only shipments whose order creation time is known. Comparing the two shows where a delay is coming from.
query Parameters
dateFromStart of the period, inclusive (format yyyy-MM-ddTHH:mm:ss.fff), based on the shipment creation date. The period can span up to one year.
dateToEnd of the period, inclusive (format yyyy-MM-ddTHH:mm:ss.fff).
Headers
Accept-LanguageLanguage code for localized responses
Get delivery time statistics › Responses
Delivery time statistics for the period
Period the figures cover.
generatedAtWhen the figures were worked out (format yyyy-MM-ddTHH:mm:ss.fff)
measuredShipmentsDelivered shipments the figures are based on. Returns 0 for a period with no deliveries, in which case every average is null.
avgShippingHoursAverage hours from handover to delivery
avgShippingDaysThe same figure in days
avgTotalHoursAverage hours from order creation to delivery
avgTotalDaysThe same figure in days
How all timed shipments spread across D+0 to D+7+, in day order
The same figures per courier, most timed shipments first
The same figures split by courier profile, most timed shipments first
Get cash-on-delivery statistics
Returns the cash-on-delivery money on shipments created in the period, split by whether each shipment was delivered, is still on its way, or came back. Money on a parcel waiting at a pickup point counts as still on its way.
Entries are grouped by country and currency together, since amounts in different currencies cannot be added up. For the same reason only the shipment count is totalled. The currency comes from the shipment itself rather than being guessed from the destination, so shipping two currencies into one country gives you two entries.
query Parameters
dateFromStart of the period, inclusive (format yyyy-MM-ddTHH:mm:ss.fff), based on the shipment creation date. The period can span up to one year.
dateToEnd of the period, inclusive (format yyyy-MM-ddTHH:mm:ss.fff).
Headers
Accept-LanguageLanguage code for localized responses
Get cash-on-delivery statistics › Responses
Cash-on-delivery statistics for the period
Period the figures cover.
generatedAtWhen the figures were worked out (format yyyy-MM-ddTHH:mm:ss.fff)
codShipmentsAll cash-on-delivery shipments in the period
One entry per country and currency, most shipments first