Skip to content

Get parcels

Request

Retrieve a list of parcels associated with the carrier. This endpoint allows fetching detailed information about parcels, including their status and history.

Security
ApiKeyAuth
Query
idsstringrequired

Comma-separated list of parcel IDs to retrieve

Example:ids=12345131,G6789011,A1234511
curl -i -X GET \
  'https://docs.glsnxt.com/_mock/openapi-carrier-integration-api/parcels?ids=12345131%2CG6789011%2CA1234511' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Parcels fetched successfully

Bodyapplication/json
Array [
shipmentUidstring

The unique identifier of the parcel shipment in the GLS/NXT Platform

Example:"anyParcelId123"
lockerUidstring

The unique identifier of the locker in the GLS/NXT Platform

Example:"anyLockerId123"
carrierParcelIdstring

The identifier of the parcel in the carrier's system

Example:"anyCarrierParcelId123"
carrierLockerIdstring or null

The identifier of the locker in the carrier's system

Example:"Locker1"
shipmentTypestring(shipment_type)

The type of shipment.

Enum:"LAST_MILE""ALTERNATIVE_DELIVERY""FIRST_MILE""RETURN"
Example:"LAST_MILE"
dimensionsStatusstring(dimensions_status)

The status of the parcel dimensions.

Enum:"PARCEL_DIMENSIONS_EXCEED""PARCEL_DIMENSIONS_OK""PARCEL_DIMENSIONS_UNKNOWN"
Example:"PARCEL_DIMENSIONS_OK"
shipmentStatusstring(shipment_status)

The status of the shipment.

Enum:"BOOKING_PRE_CHECK""BOOKING_REQUESTED""BOOKING_CREATED""BOOKING_CANCELLED""BOOKING_CANCELLATION_FAILED""BOOKING_EXPIRED""BOOKING_REJECTED_INVALID_LOCKER""BOOKING_REJECTED_PROVIDER_ERROR""BOOKING_REJECTED_LOCKER_IS_FULL""BOOKING_REJECTED_NO_FREE_FITTING_COMPARTMENT"
Example:"CONSIGNEE_COLLECTED"
isFinalboolean
Example:true
accessCodesobject or null(access_codes)

Access codes for the parcel

consigneeobject or null(consignee)

The details of the consignee.

eventsArray of objects(parcel_events)
allocationTypestring(allocation_type)

The allocation type of the shipment.

Enum:"HARD_RESERVATION""SOFT_RESERVATION"
Example:"HARD_RESERVATION"
providerNamestring or null

The name of the locker network provider

Example:"LOCKY_PT"
providerLockerIdstring or null

The identifier of the locker in the provider's system

Example:"1178"
shipmentSignatureobject or null(signature)

A Base64-encoded image representing the consignee's signature, captured upon parcel collection

requiresAccessibleCompartmentboolean
Example:true
labelTypestring or null

Label mode for the shipment. LABELLESS means no printed label is used and LABELED means a printed label is used.

Enum:"LABELLESS""LABELED"null
Example:"LABELLESS"
referenceCodestring or null

Reference code scanned by driver during pickup of the labelless parcel. This field is only relevant for LABELLESS shipments.

Example:"LBL000000018"
secondaryShipmentIdstring or null

A secondary identifier for the shipment, separate from carrierParcelId.

Example:"EXP-CODE-0001"
paymentStatusstring or null

The current cash-on-delivery payment status for the shipment, when applicable. Absent when the shipment carries no CoD payment.

Enum:"EXPECTED""PAID""FAILED"null
Example:"PAID"
codAmountinteger or null, (int64)

Cash-on-delivery amount to collect, expressed in minor units (e.g. cents). Absent when the shipment carries no CoD payment.

Example:2450
codCurrencystring or null

ISO 4217 currency code for codAmount. Absent when the shipment carries no CoD payment.

Example:"EUR"
paymentTypestring or null

The payment method used for a cash-on-delivery parcel, as reported by the locker provider. Absent when the shipment carries no CoD payment.

Enum:"CARD""FLIK"null
Example:"CARD"
lockStatusstring or null

The current provider lock state of the parcel, when known. LOCKED means the consignee cannot collect the parcel (e.g. a cash-on-delivery payment is still pending); UNLOCKED means it can be collected. Absent when the parcel carries no lock state.

Enum:"LOCKED""UNLOCKED"null
Example:"LOCKED"
]
Response
[
  {
    "shipmentUid": "anyParcelId123",
    "lockerUid": "anyLockerId123",
    "carrierParcelId": "anyCarrierParcelId123",
    "carrierLockerId": "Locker1",
    "shipmentType": "LAST_MILE",
    "dimensionsStatus": "PARCEL_DIMENSIONS_OK",
    "shipmentStatus": "CONSIGNEE_COLLECTED",
    "isFinal": true,
    "accessCodes": { … },
    "consignee": { … },
    "events": [ … ],
    "allocationType": "HARD_RESERVATION",
    "providerName": "LOCKY_PT",
    "providerLockerId": "1178",
    "shipmentSignature": { … },
    "requiresAccessibleCompartment": true,
    "labelType": "LABELLESS",
    "referenceCode": "LBL000000018",
    "secondaryShipmentId": "EXP-CODE-0001",
    "paymentStatus": "PAID",
    "codAmount": 2450,
    "codCurrency": "EUR",
    "paymentType": "CARD",
    "lockStatus": "LOCKED"
  }
]