Skip to content
Soljio Docs
Esc
↑↓navigate↵open⌘Jpreview

List sessions

Organization-scoped session read. Requires schedule.read. Unknown or repeated query parameters are rejected. This returns operational occurrences, not a third catalog/setup level.

GET/sessions
Authorization
AuthorizationBearer token (soljio_sk_<secret>) · headerrequired

Organization-scoped service token created by an owner/admin. Scope requirements are in x-required-scopes; these are service-token grants, not OAuth scopes. Revoked, expired, unknown and suspended-organization credentials all return 401.

Query parameters
limitinteger

Maximum records per page. A page may be empty with a non-null cursor; continue until next_cursor is null.

min 1 · max 100 · default: 25
cursorstring

Opaque cursor from this resource and organization. No snapshot isolation across pages.

min length 1 · max length 16384
Responses
200

Successful operation.

dataSession[]required
Show properties
Array of Session
idstringrequired

Opaque Soljio ID. Do not parse or synthesize.

min length 1 · max length 256
organization_idstringrequired

Opaque Soljio ID. Do not parse or synthesize.

min length 1 · max length 256
statusstringrequired
updated_atstring<date-time>required
objectstringrequired
offering_idstringrequired

Opaque Soljio ID. Do not parse or synthesize.

min length 1 · max length 256
created_atstring<date-time>required
starts_atstring<date-time>required
ends_atstring<date-time>required
timezonestring
originstring
capacitynumber
request_idstring<uuid>required
next_cursorstring | nullrequired
400

invalid_request

errorobjectrequired
Show properties
codestringrequired
Allowed:invalid_request
messagestringrequired
request_idstring<uuid>required
401

unauthorized

errorobjectrequired
Show properties
codestringrequired
Allowed:unauthorized
messagestringrequired
request_idstring<uuid>required
403

forbidden

errorobjectrequired
Show properties
codestringrequired
Allowed:forbidden
messagestringrequired
request_idstring<uuid>required
404

not_found

errorobjectrequired
Show properties
codestringrequired
Allowed:not_found
messagestringrequired
request_idstring<uuid>required
405

method_not_allowed

errorobjectrequired
Show properties
codestringrequired
Allowed:method_not_allowed
messagestringrequired
request_idstring<uuid>required
429

rate_limited

errorobjectrequired
Show properties
codestringrequired
Allowed:rate_limited
messagestringrequired
request_idstring<uuid>required
500

internal_error

errorobjectrequired
Show properties
codestringrequired
Allowed:internal_error
messagestringrequired
request_idstring<uuid>required
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.soljio.com/v0/sessions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "data": [
    {
      "id": "string",
      "organization_id": "string",
      "status": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "object": "session",
      "offering_id": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "starts_at": "2019-08-24T14:15:22Z",
      "ends_at": "2019-08-24T14:15:22Z",
      "timezone": "string",
      "origin": "string",
      "capacity": 0
    }
  ],
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
  "next_cursor": "string"
}

Was this page helpful?