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>'
{
  "visibility_score": 0.9,
  "reason_codes": [
    "REACHED_DOOR_CORRECT"
  ],
  "key_events": [
    {
      "type": "ENTRANCE",
      "t_start": 12.5,
      "t_end": 15,
      "x": 5.2,
      "y": 3.1,
      "z": 0,
      "confidence": 0.8,
      "metadata": {}
    }
  ],
  "path": {
    "t": [
      0,
      0.5,
      1
    ],
    "x": [
      0,
      0.2,
      0.5
    ],
    "y": [
      0,
      0.1,
      0.1
    ],
    "z": [
      0,
      0,
      0
    ]
  },
  "timeline": [],
  "session_meta": {}
}

Authorizations

Desmo-Key
string
header
required

Path Parameters

id
string
required

The session ID

Response

200 - application/json

PoD Insights

visibility_score
number<float>

Confidence score (0.0 - 1.0) indicating the success of the delivery.

Required range: 0 <= x <= 1
reason_codes
string[]

List of codes explaining the score (e.g., REACHED_DOOR_CORRECT).

key_events
object[]

Significant events detected during the session.

path
object

Reconstructed 3D path of the courier.

timeline
object[]

Chronological list of primitive events.

session_meta
object

Metadata about the session context.