Skip to main content
GET
/
v1
/
sessions
/
{id}
Get session
curl --request GET \
  --url https://api.getdesmo.io/v1/sessions/{id} \
  --header 'Desmo-Key: <api-key>'
{
  "id": "sess_ce7f77e71be24f1b",
  "organizationId": "1428fcc7-119e-4397-9668-d5645b8166a8",
  "deliveryId": "DELIVERY_123",
  "externalRiderId": "DRIVER_42",
  "status": "completed",
  "sessionType": "drop",
  "env": "live",
  "address": {
    "line1": "123 Main St",
    "city": "Bangalore",
    "state": "Karnataka",
    "postalCode": "560001",
    "country": "IN",
    "lat": 12.9716,
    "lng": 77.5946
  },
  "device": {
    "platform": "android",
    "sdkVersion": "1.0.2",
    "model": "Pixel 7",
    "osVersion": "14"
  },
  "startLocation": {
    "lat": 12.945,
    "lng": 77.5795
  },
  "createdAt": "2025-01-15T10:00:00Z",
  "endedAt": "2025-01-15T10:05: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 (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)