Skip to main content
GET
List shipments

Authorizations

Authorization
string
header
required

Access token from POST /v2/oauth2/token, requested with an API credential. See https://api-docs.quivo.co/api-reference/authentication.

Query Parameters

query
string

Elasticsearch query string: field:value, joined with AND by default; AND/OR/NOT in upper case; quotes around values with spaces, / or :; * wildcards; ranges like created:[2026-10-01 TO 2026-10-31] or created:>=now-7d; exists:field. A condition on a wrong field name matches nothing and gives no error, so OR still returns the other matches and NOT drops nothing, which widens the result. Guide: https://api-docs.quivo.co/docs/quivo-guides/using-queries. Fields include: trackingNumber, carrierSlug, direction, reference, sellerId, warehouseId, created, shipmentDate. Addresses are flat and named deliveryAddress*/senderAddress*, not shipTo*/shipFrom* as in the response: deliveryAddressCountryIso2, deliveryAddressZip, senderAddressCountryIso2. Examples: trackingNumber:1234567890; carrierSlug:"dhl-express" AND created:[2026-10-01 TO 2026-11-30].

sort
string

Optional sorting criteria for the results. Format is typically 'field:direction' (e.g., 'created:desc').

page
integer<int64>

The page number to retrieve when using offset-based pagination. Ignored if 'searchAfter' is provided.

searchAfter
string

Used for cursor-based pagination. Pass the 'sort' key value from the last item of the previous page to retrieve the next set of results efficiently. Overrides 'page'.

pageSize
integer<int64>

The maximum number of items to return per page. Used for both offset and cursor-based pagination.

Response

Returns an array of shipment summaries with tracking information and status.

bookedShipmentId
integer<int64>

The unique identifier for the bookedshipment

sellerId
integer<int64>

The unique identifier for the seller

shippingServiceId
integer<int64>

The unique identifier for the shippingservice

trackingNumber
string

Tracking information or tracking enabled status

Tracking information or tracking enabled status

returnTrackingNumber
string

Tracking information or tracking enabled status

Tracking information or tracking enabled status

shipmentIdentifier
string

The unique identifier for the shipmententifier

reference
string

Reference number or identifier for the item

direction
string

The direction value

shipToCountry
string

Country code or name

shipToZip
string

ZIP or postal code

shipToCompany
string

Company name

shipToName1
string

The name of the ship to

shipToName2
string

The name of the ship to

carrierSlug
string

Carrier identifier or information

shipFromCountry
string

Country code or name

shipFromZip
string

ZIP or postal code

shipFromCompany
string

Company name

shipFromName1
string

The name of the ship from

shipFromName2
string

The name of the ship from

piiDataRemoved
boolean

Boolean flag indicating pii data removed

weight
number

The total weight of the shipment in kg, which is the sum of the weight of the main as well as all additional parcels in this shipment.

volume
number

The total volume of the shipment in m3, which is the sum of the volume of the main as well as all additional parcels in this shipment.

lengthM
number

Length of the shipment in meters.

widthM
number

Width of the shipment in meters.

heightM
number

Height of the shipment in meters.

codAmount
number

Amount value

codCurrency
object

Currency information

sort
object

The

trackingEnabled
boolean

Indicates whether tracking is enabled

userIdentifier
string

The unique identifier for the userentifier

shipmentDate
string<date>

The shipment date

warehouseName
string

The name of the warehouse

created
string<date-time>

Timestamp when the item was created

cancelledAt
string<date-time>

The cancelled at timestamp

documents
object[]

Array of document items

exportPositions
object[]

Array of export position