Skip to content

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 hasDeliveryProof in AWBStandardStatus before calling this method: when it is true, the image is available.

Migrating from the base64 field

If your integration read the image from awbImage:

  1. Call AWBStandardStatus as usual.
  2. If header.hasDeliveryProof is true, call this method with the same token and the shippingId.
  3. Save the response body as the image. Do not decode it: it is already the binary file.
  4. Stop reading awbImage as base64: it now contains a text, or null.

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.