# Get delivery information

This endpoint provides a comprehensive view of a delivery, either with the delivery identifier or with its reference ID.

## Check delivery information

> Retrieve data for a delivery by its ID or reference.

```json
{"openapi":"3.0.0","info":{"title":"Shippify Api","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Development server"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"getDelivery":{"successfulResponse":{"type":"object","properties":{"id":{"type":"string","description":"Identifier of the delivery in Shippify."},"route":{"type":"object","description":"Information about the route to which the delivery belongs.","properties":{"id":{"type":"string","description":"Identifier of the route in Shippify."},"order":{"description":"Order of the delivery within the route.","type":"integer","minimum":1}}},"recipient":{"description":"Contact information at the warehouse","$ref":"#/components/schemas/delivery/contact"},"pickup":{"type":"object","properties":{"date":{"type":"string","description":"Pickup date."}}},"dropoff":{"description":"Delivery information","type":"object","location":{"$ref":"#/components/schemas/delivery/location"},"date":{"type":"string","description":"Delivery date."}},"courier":{"description":"Driver details","type":"object","properties":{"info":{"type":"object","properties":{"shipperId":{"description":"Identifier of the driver performing the delivery.","type":"integer","minimum":1},"shipperDocId":{"type":"string","description":"Driver's identification, ID card, etc."},"shipperName":{"type":"string","description":"Driver's name."},"shipperCapacity":{"type":"string","description":"Driver's capacity."},"vehicleLicensePlate":{"type":"string","description":"Driver's vehicle license plate."},"vehicleType":{"type":"string","description":"Driver's vehicle brand."},"vehicleModel":{"type":"string","description":"Driver's vehicle model."}}},"location":{"type":"object","description":"Driver's current location.","properties":{"lat":{"type":"string"},"lng":{"type":"string"}}}}},"items":{"description":"Delivery packages","type":"array","items":{"description":"Package information.","type":"array","items":{"$ref":"#/components/schemas/delivery/package"}}},"status":{"description":"Delivery status code","type":"integer","minimum":1},"_status":{"type":"string","description":"Delivery status name"},"status_lang":{"type":"string","description":"Delivery status name in the account's language"},"distance":{"description":"Distance between pickup and delivery points","type":"number","minimum":0},"company":{"type":"string","description":"Task company name"},"referenceId":{"type":"string","description":"External delivery identifier, such as order number"},"reasonId":{"description":"Identifier of the reason for the status change","type":"integer","minimum":1},"reasonText":{"type":"string","description":"Description of the reason for the status change"},"problem_note":{"type":"string","description":"Status change comment"},"lastStatusDate":{"type":"string","description":"Date of the last status change"},"tags":{"description":"Delivery digital tag names.","type":"array","items":{"description":"Digital tag name","type":"string","maxLength":50}}}}},"delivery":{"contact":{"description":"Contact information of the person responsible for delivering the packages at the pickup warehouse.","type":"object","required":["name","email"],"properties":{"name":{"description":"Name of the responsible person.","type":"string"},"email":{"description":"Email of the responsible person.","type":"string","format":"email"},"phonenumber":{"description":"Phone number of the responsible person.","type":"string"}}},"location":{"description":"Address information of the pickup location of the delivery packages.","type":"object","required":["address"],"properties":{"address":{"description":"Delivery address.","type":"string"},"instructions":{"description":"Extra information about the address.","type":"string"},"lat":{"description":"Latitude of the pickup point.","type":"string"},"lng":{"description":"Longitude of the pickup point.","type":"string"}}},"package":{"type":"object","required":["name","qty","size"],"properties":{"id":{"type":"string","description":"Package identifier"},"name":{"type":"string","description":"Package name"},"qty":{"description":"Number of packages in the order (not the number of products inside the package).","type":"integer","minimum":0},"weight":{"description":"Unit weight * quantity in Kg","type":"number","minimum":0},"size":{"description":"Package size","type":"string","enum":["xs","s","m","l","xl"]},"price":{"description":"Unit price * quantity in the currency of the company","type":"number","minimum":0}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}}},"paths":{"/v1/deliveries/{id}/complete":{"get":{"tags":["Deliveries"],"summary":"Check delivery information","description":"Retrieve data for a delivery by its ID or reference.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/getDelivery/successfulResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"parameters":[{"name":"id","in":"path","description":"Identifier or reference ID of the delivery to query.","required":true,"schema":{"type":"string"}}]}}}}
```

## Use cases

<details>

<summary>Retrieve information about a delivery by its ID.</summary>

You can use the delivery ID in the request URL to fetch its information.

</details>

<details>

<summary>Retrieve information about a delivery by its reference ID</summary>

You can use the delivery reference ID in the request URL to fetch its information.

</details>