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
API Token
Id of the delivery is been looked for
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
SiG Internal ID
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.
This is the ID reference from the sender. It is used normally as mapping between both platforms.
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.
If a good is considered hazardous and needs special treatment then we advise to set this as true
This ID is used as part of the Pubic Access for the customer. It is a unique identifier to avoid collision.
Receiver's address where the package/s will be dropped off.
Receiver's postalcode 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
If the agreement allows this service, this field will indicate what's the safeplace designated by the customer
Quantity of parcels within this delivery
Field to host the weight of the delivery when is known. The standard units are Kg or lbs
Last update received or produced in our system for a given delivery
This is the unique link identifier for a customer to access our Customer Portal. This portal allows the customer to modify the delivery and schedule returns (in case this is available in the contract)
After a delivery is planned this is the first estimate for arrival.
{
"status": "string",
"delivery": {
"id": "string",
"sender_external_id": "string",
"sender_status": "string",
"sender": "string",
"dispatcher_status": "string",
"pickup_date_start": "string",
"pickup_hour_start": "string",
"pickup_hour_end": "string",
"pickup_date_end": "string",
"dangerous_good": true,
"public_id": "string",
"proof_of_delivery": "string",
"proof_of_delivery_signature": "string",
"dropoff_date_start": "string",
"dropoff_hour_start": "string",
"dropoff_hour_end": "string",
"dropoff_date_end": "string",
"dropoff_address": "string",
"dropoff_postalcode": "string",
"dropoff_comments": "string",
"dropoff_neighbour_allowed": true,
"dropoff_neighbour": "string",
"dropoff_safeplace_allowed": true,
"dropoff_safeplace": "string",
"status_delivered_at": "string",
"status_cancelled_at": "string",
"quantity": 0,
"weight": 0,
"lastmodifieddate": "string",
"public_link": "string",
"planned_arrival": "string"
}
}
{
"status": "ok",
"delivery": {
"id": "a0000000000",
"sender_external_id": "111test",
"sender_status": "dispatched",
"sender": "00000000000AOaaAAA",
"dispatcher_status": "cancelled",
"pickup_date_start": "2020-12-18",
"pickup_hour_start": "08:30",
"pickup_hour_end": "09:30",
"pickup_date_end": "2020-12-18",
"dangerous_good": false,
"public_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"proof_of_delivery": null,
"proof_of_delivery_signature": null,
"dropoff_date_start": "2020-12-19",
"dropoff_hour_start": "08:00",
"dropoff_hour_end": "20:00",
"dropoff_date_end": "",
"dropoff_address": "Hafenweg 16, 48155, Münster",
"dropoff_postalcode": "48155",
"dropoff_comments": "please enter the red gateway and turn left",
"dropoff_neighbour_allowed": false,
"dropoff_neighbour": null,
"dropoff_safeplace_allowed": false,
"dropoff_safeplace": "At the front door",
"status_delivered_at": "2020-12-21T12:24:40.000+0000",
"status_cancelled_at": "2020-12-22T10:08:39.000+0000",
"quantity": 1,
"weight": 4.99,
"lastmodifieddate": "2020-12-22T10:35:26.000+0000",
"public_link": "https://dashboard.sendit.green/tracking?public_id=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&postalcode=48155",
"planned_arrival": null
}
}
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 sender_external_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"
}