ProofOfDeliveryService: Get Proof of Delivery

client.proofOfDelivery retrieves proof of delivery (POD) records once a shipment has been successfully delivered. POD records are created by the courier at the point of delivery and contain verified evidence — such as a delivery photo, a signed OTP confirmation, or a captured signature — that the parcel reached the intended recipient. Use POD data to resolve delivery disputes, satisfy compliance requirements, or present delivery confirmation to your customers.

Proof of delivery is only available after a shipment’s status reaches delivered. Calling getProofOfDelivery on a shipment in any earlier status returns a 404 error. OTP codes are never returned in the response.

Methods

`getProofOfDelivery`

Retrieve the proof of delivery record for a delivered shipment. Provide the internal shipment ID to look up the associated POD.

string

required

The internal shipment ID (e.g. shp_abc123). This is available in the shipment object as the id field.

import { TLDP } from '@tybrite-labs/tldp-sdk';

const client = new TLDP({ apiKey: 'tybrite_sk_live_YOUR_SECRET_KEY' });

const pod = await client.proofOfDelivery.getProofOfDelivery({
  shipmentId: 'shp_abc123',
});

console.log(pod.shipment_id);      // 'shp_abc123'
console.log(pod.tracking_number);  // 'TLDP-20260608-0001'
console.log(pod.delivered_at);     // '2026-06-08T14:32:00Z'
console.log(pod.pod.type);         // 'photo' | 'otp' | 'signature'
console.log(pod.pod.verified_at);  // '2026-06-08T14:32:05Z'
console.log(pod.pod.data);         // proof payload (URL, OTP string, or signature data)

Response Fields

string

The internal ID of the shipment this proof of delivery belongs to.

string

The public tracking number of the delivered shipment.

string | null

ISO 8601 timestamp of when the shipment was marked as delivered by the courier.

object

The proof of delivery record captured at the point of delivery.

Show pod fields

'photo' | 'otp' | 'signature'

The type of proof captured by the courier. See the POD types table below.

string | null

ISO 8601 timestamp of when the proof was captured and verified by the courier app.

object

The proof payload. Contents vary by type — for photo this is a URL to the delivery image; for otp this is the confirmed one-time passcode; for signature this is the captured signature data.

POD Types

The courier captures one of three proof types at the point of delivery, depending on the courier’s capabilities and the delivery configuration.

Type	Value	Description
Photo	`photo`	The courier photographs the delivered parcel at the drop-off location. The `pod.data` field contains a URL to the image.
OTP	`otp`	The recipient confirms receipt by providing a one-time passcode sent to their phone. OTP codes are never returned in the response — `pod.data` confirms the verified event.
Signature	`signature`	The recipient signs on the courier’s device. The `pod.data` field contains the captured signature data.

Get Started

Core Concepts

Guides

TypeScript SDK

ProofOfDeliveryService: Get Proof of Delivery | TLDP

Methods

`getProofOfDelivery`

Response Fields

POD Types

​Methods

​getProofOfDelivery

​Response Fields

​POD Types

Methods

`getProofOfDelivery`

Response Fields

POD Types