Skip to main content
GET
Get session insights

Authorizations

Desmo-Key
string
header
required

Secret API key (starts with sk_sandbox_ or sk_live_)

Path Parameters

id
string
required

The session ID

Response

PoD Insights

Computed proof-of-delivery intelligence for a session

sessionId
string
required

The session this insight belongs to

organizationId
string
required
deliveryId
string
required
status
enum<string>
required

Processing status of the insight

Available options:
processing,
ready,
failed
reasonCodes
enum<string>[]
required

Codes explaining the delivery outcome

Reason code explaining delivery outcome

Available options:
FULL_ATTEMPT,
DELIVERED_TO_RIGHT_DOORSTEP,
NO_ATTEMPT,
PARTIAL_ATTEMPT,
POSSIBLE_LOBBY_HANDOFF,
POSSIBLE_WRONG_ADDRESS,
POSSIBLE_NO_ATTEMPT,
SESSION_TIMEOUT,
INSUFFICIENT_DATA,
TELEMETRY_STREAM_INTERRUPTED
events
object[]
required

Timeline of detected events during the delivery

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
summary
object

Summary scores and flags for the delivery

metrics
object

Timing metrics for the delivery

pod
object

Proof of Delivery attachment

pathImageUrl
string | null

URL to rendered path visualization

errorMessage
string | null

Error details if status is 'failed'