Fetch a delivery
GET/standard/delivery
This endpoint is meant to be used for querying an existing delivery. [PREMIUM] To have access to this service you need a Premium Account.
Request
Query Parameters
Id of the delivery is been looked for
Header Parameters
Default value: Bearer <token>
Responses
- 200
- 400
- 500
OK
- application/json
- Schema
- Example (from schema)
- sample
Schema
This is the status of the request to the server. Note: do not confuse with status of the delivery.
delivery object
If a good is considered hazardous and needs special treatment then we advise to set this as true
The depth in cm of the parcel. Maximum integer length of 4 and maximum of 2 decimal places
pending
- delivery hasn't been processed by the fleet. scheduled
- delivery has already routing plan. picked
- is already on the vehicle. moving
- routing has started. delivered
- dropoff has been executed. error
- an error has been produced. cancelled
- delivery has been aborted.
Receiver's address where the package/s will be dropped off.
Comments while dropping off the package/s - i.e. please enter the red gateway and turn left
If the agreement allows this service, this field will indicate what's the neighbour's name designated by the customer
Receiver's postalcode where the package/s will be dropped off.
If the agreement allows this service, this field will indicate what's the safeplace designated by the customer
Receiver's what3words encoded location where the package/s will be dropped off
The height in cm of the parcel. Maximum integer length of 4 and maximum of 2 decimal places
SiG Internal ID
Last update received or produced in our system for a given delivery
The length in cm of the parcel. Maximum integer length of 4 and maximum of 2 decimal places
This field can be either an object or a string
After a delivery is planned this is the first estimate for arrival.
This ID is used as part of the Pubic Access for the customer. It is a unique identifier to avoid collision.
This is the unique link identifier for a customer to access our Customer Portal. This portal allows the customer to modify the delivery.
Quantity of parcels within this delivery
This is the ID reference from the sender. It is used normally as mapping between both platforms.
This is the ID reference from the sender. It is used normally as mapping between both platforms.
dispatched
- it has been delivered to the fleet for routing plan. validated
- it's pending to be handed over to the fleet. cancelled
- it has been cancelled and will not be further updates. return
- it's returned to the merchant.
Field to host the weight of the delivery when is known. The standard units are Kg or lbs
{
"status": "string",
"delivery": {
"dangerous_good": true,
"depth": 1234.56,
"dispatcher_status": "string",
"dropoff_address": "string",
"dropoff_comments": "string",
"dropoff_date_end": "string",
"dropoff_date_start": "string",
"dropoff_hour_end": "string",
"dropoff_hour_start": "string",
"dropoff_neighbour": "string",
"dropoff_neighbour_allowed": true,
"dropoff_postalcode": "string",
"dropoff_safeplace": "string",
"dropoff_safeplace_allowed": true,
"dropoff_w3w": "solving.giving.dreamer",
"height": 1234.56,
"id": "string",
"lastmodifieddate": "string",
"length": 1234.56,
"metadata": "string",
"pickup_date_end": "string",
"pickup_date_start": "string",
"pickup_hour_end": "string",
"pickup_hour_start": "string",
"planned_arrival": "string",
"proof_of_delivery": "string",
"proof_of_delivery_signature": "string",
"public_id": "string",
"public_link": "string",
"quantity": 0,
"sender": "string",
"sender_external_id": "string",
"sender_status": "string",
"status_cancelled_at": "string",
"status_delivered_at": "string",
"weight": 0
}
}
{
"status": "ok",
"delivery": {
"dangerous_good": false,
"depth": 1234.45,
"dispatcher_status": "cancelled",
"dropoff_address": "Hafenweg 16, 48155, Münster",
"dropoff_comments": "please enter the red gateway and turn left",
"dropoff_date_end": "",
"dropoff_date_start": "2020-12-19",
"dropoff_hour_end": "20:00",
"dropoff_hour_start": "08:00",
"dropoff_neighbour": null,
"dropoff_neighbour_allowed": false,
"dropoff_postalcode": "48155",
"dropoff_safeplace": "At the front door",
"dropoff_safeplace_allowed": false,
"height": 125,
"id": "DEYDRHWNZGT97KF8",
"lastmodifieddate": "2020-12-22T10:35:26.000+0000",
"length": 123,
"metadata": {
"foo": 1
},
"pickup_date_end": "2020-12-18",
"pickup_date_start": "2020-12-18",
"pickup_hour_end": "09:30",
"pickup_hour_start": "08:30",
"planned_arrival": null,
"proof_of_delivery": null,
"proof_of_delivery_signature": null,
"public_id": "DEYDRHWNZGT97KF8",
"public_link": "https://dashboard.sendit.green/tracking?public_id=DEYDRHWNZGT97KF8&postalcode=48155",
"quantity": 1,
"sender": "00000000000AOaaAAA",
"sender_external_id": "111test",
"sender_status": "dispatched",
"status_cancelled_at": "2020-12-22T10:08:39.000+0000",
"status_delivered_at": "2020-12-21T12:24:40.000+0000",
"weight": 4.99
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
- example-400
Schema
Possible values: non-empty
{
"error": true,
"message": "string"
}
{
"error": true,
"message": "not a valid id"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
- example-500
Schema
Possible values: non-empty
{
"error": true,
"message": "string"
}
{
"error": true,
"message": "Internal error, please contact support@sendit.green"
}