Skip to main content
GET
/
v1
/
sessions
/
{id}
/
insights
Get session insights
curl --request GET \
  --url https://api.getdesmo.io/v1/sessions/{id}/insights \
  --header 'Desmo-Key: <api-key>'
{
  "sessionId": "sess_ce7f77e71be24f1b",
  "organizationId": "1428fcc7-119e-4397-9668-d5645b8166a8",
  "deliveryId": "DELIVERY_123",
  "status": "ready",
  "summary": {
    "fraudScore": 0.12,
    "frictionScore": 0.35,
    "visibilityScore": 0.92,
    "rightDoorstep": true,
    "suspiciousBehavior": false,
    "floorsClimbed": 4,
    "elevatorUsed": true,
    "totalDurationSec": 245,
    "attemptCycles": 1
  },
  "reasonCodes": [
    "FULL_ATTEMPT",
    "DELIVERED_TO_RIGHT_DOORSTEP"
  ],
  "events": [
    {
      "type": "GATE",
      "tStart": 0,
      "confidence": 0.92
    },
    {
      "type": "WALKING",
      "tStart": 0,
      "tEnd": 15.5,
      "confidence": 0.95
    },
    {
      "type": "ELEVATOR",
      "tStart": 15.5,
      "tEnd": 48,
      "confidence": 0.88,
      "metadata": {
        "floors": 4
      }
    },
    {
      "type": "STOPPED",
      "tStart": 62,
      "tEnd": 95,
      "confidence": 0.97
    }
  ],
  "metrics": {
    "timeFromEntranceToDoorSec": 95,
    "timeAtDoorSec": 33
  },
  "pod": {
    "type": "photo",
    "url": "https://cdn.desmo.io/pod/DELIVERY_123.jpg"
  },
  "pathImageUrl": "https://cdn.desmo.io/paths/sess_ce7f77e71be24f1b.png",
  "createdAt": "2025-01-15T10:06:00Z",
  "updatedAt": "2025-01-15T10:06:00Z"
}

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'