API Reference
API Reference

Get A Single Session By Id

GET/api/v1/sessions/{session_id}

Authentication

Syllable-API-Keyrequired

Send Syllable-API-Key in the header.

Need a credential? Create or manage an API token in the Syllable Console.

Parameters

Path parameters

session_id string path required

Responses

200Successful Response

application/json

response Session required
24 fields
timestampstring (date-time)required

Timestamp of the session

session_idstring | nulloptional

Internal ID of the session, generated based on interaction details

conversation_idstring | nulloptional

ID of the conversation of which the session is a part

channel_manager_servicestring | nulloptional

Name of the service used to facilitate the session

channel_manager_typestring | nulloptional

Type of the service used to facilitate the session

channel_manager_sidstring | nulloptional

Channel-manager-side ID of the session (different from session_id)

agent_idstring | nulloptional

ID of the agent with which the session occurred

agent_namestring | nulloptional

Name of the agent with which the session occurred

agent_typestring | nulloptional

Type of the agent with which the session occurred

agent_timezonestring | nulloptional

Timezone of the agent with which the session occurred

prompt_idstring | nulloptional

ID of the prompt used by the agent with which the session occurred

prompt_namestring | nulloptional

Name of the prompt used by the agent with which the session occurred

prompt_versionstring | nulloptional

Legacy prompt version timestamp used by the agent with which the session occurred

prompt_version_numberinteger | nulloptional

Prompt version number used by the agent with which the session occurred (new system)

durationnumber | nulloptional

Duration of the session in seconds

session_label_idstring | nulloptional

ID of the label (listing the quality of the session and any issues that occurred) associated with the session

sourcestring | nulloptional

Source of the session (e.g., for an inbound session, the user's phone number/username/email)

targetstring | nulloptional

The name of the channel target associated with the agent at the time of the session (see ChannelTargetResponse.target)

is_legacyboolean | nulloptional

Whether the session occurred on the legacy Syllable system

is_testboolean | nulloptional

Whether the session is a test session

is_outboundboolean | nulloptional

Whether the session direction is outbound (true) or inbound (false).

user_terminatedboolean | nulloptional

Whether the voice session was ended by the recipient (outbound) / caller (inbound). False if the user was transferred or there was an error. Unset if the session was not a voice session.

transfer_voicemail_detectedboolean | nulloptional

Whether a voicemail was detected during the transfer leg of the session

override_timestampstring | nulloptional

ISO 8601 datetime used to override the session's current time. Set only for test sessions that supplied a datetime override; otherwise null.

Response example
{
  "timestamp": "string",
  "session_id": "string",
  "conversation_id": "string",
  "channel_manager_service": "string",
  "channel_manager_type": "string",
  "channel_manager_sid": "string",
  "agent_id": "string",
  "agent_name": "string",
  "agent_type": "string",
  "agent_timezone": "string",
  "prompt_id": "string",
  "prompt_name": "string",
  "prompt_version": "string",
  "prompt_version_number": "string",
  "duration": "string",
  "session_label_id": "string",
  "source": "string",
  "target": "string",
  "is_legacy": "string",
  "is_test": "string",
  "is_outbound": "string",
  "user_terminated": "string",
  "transfer_voicemail_detected": "string",
  "override_timestamp": "string"
}
422Validation Error

application/json

response HTTPValidationError required
1 field
detailValidationError[]optional
Item schema
itemsValidationErrorrequired
3 fields
locstring | integer[]required
Item schema
itemsstring | integerrequired
2 options
Option 1stringrequired
Option 2integerrequired
msgstringrequired
typestringrequired
Response example
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}