Skip to main content
GET
Get session

Authorizations

Desmo-Key
string
header
required

Secret API key (starts with sk_sandbox_ or sk_live_)

Path Parameters

id
string
required

The session ID (e.g., sess_abc123def456)

Response

Session details

id
string
required

Unique session ID (format: sess_xxx)

organizationId
string
required

Your organization ID

deliveryId
string
required

Your internal delivery/order ID

status
enum<string>
required

Current status of the session

Available options:
recording,
completed,
failed
sessionType
enum<string>
required

Type of delivery session

Available options:
pickup,
drop,
transit
env
enum<string>
required

Environment the session belongs to

Available options:
sandbox,
live
createdAt
string<date-time>
required

When the session started

externalRiderId
string | null

External rider/driver ID from customer's system

address
object
device
object
startLocation
object
sensorAvailability
object

Reports which sensors are available on the device

endedAt
string<date-time> | null

When the session ended (null if still recording)