Delivery proof image¶
Downloads the delivery proof image of an AWB (photo or scan provided by the destination operator).
New in November 2026
This method replaces the base64 image that awbImage used to contain in
AWBStandardStatus.
URL¶
GET https://ocelot.servientrega.us/api/DestinationStatus/track/DeliveryProof?awb={shippingId}
GET https://ocelotkiwi.azurewebsites.net/api/DestinationStatus/track/DeliveryProof?awb={shippingId}
Parameters¶
| Name | In | Required | Rules |
|---|---|---|---|
awb |
query string | Yes | AWB number |
Authorization |
header | Yes | Bearer <ACCESS_TOKEN>: the same token as the other methods |
Request example¶
curl "https://ocelot.servientrega.us/api/DestinationStatus/track/DeliveryProof?awb=2290000001" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-o proof-2290000001
curl "https://ocelotkiwi.azurewebsites.net/api/DestinationStatus/track/DeliveryProof?awb=2290000001" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-o proof-2290000001
Response¶
The response is the image file itself, not JSON. Use the Content-Type header to choose the file
extension:
Content-Type |
Extension |
|---|---|
image/jpeg |
.jpg |
image/png |
.png |
| Code | Meaning |
|---|---|
200 |
The body is the image |
404 |
The AWB does not have a delivery image yet |
403 |
The token is missing, invalid or expired, or it does not have access to that AWB |
The 404 and 403 responses have a JSON body (application/problem+json) with title and status.
When is the image available¶
- Only for AWBs delivered in Colombia and Ecuador.
- Usually 24 to 48 hours after the delivery is confirmed by the destination operator.
- Check
hasDeliveryProofin AWBStandardStatus before calling this method: when it istrue, the image is available.
Migrating from the base64 field¶
If your integration read the image from awbImage:
- Call AWBStandardStatus as usual.
- If
header.hasDeliveryProofistrue, call this method with the same token and theshippingId. - Save the response body as the image. Do not decode it: it is already the binary file.
- Stop reading
awbImageas base64: it now contains a text, ornull.
Notes¶
- The response can be cached for 10 minutes (
Cache-Control: private, max-age=600). Download each image once and keep your own copy instead of requesting it every time.