Sessions

Server

Call session history and status

List Sessions

GET

https://api.helios.pressone.co/api/v1

/chatterwave/sessions/

Returns a paginated list of call sessions for the authenticated account. Sessions can be filtered by type, status, caller ID, recipient number, batch session ID, and created-at date range.

List Sessions › query Parameters

session_type

string · enum

Filter by session type

Enum values:

otp

tts

status

string · enum

Filter by session status

Enum values:

queued

pending

delivered

failed

from

string

Filter by caller ID (DID phone number in E.164 format)

Example: +14155550100

to

string

Filter by recipient phone number (exact match, E.164 format)

Example: +14155551234

session_id

string · uuid

Filter by batch session ID

start_date

string

Filter sessions created on or after this timestamp. Accepts RFC3339 datetime (for example 2026-02-01T00:00:00Z) or date-only (YYYY-MM-DD).

end_date

string

Filter sessions created on or before this timestamp. Accepts RFC3339 datetime (for example 2026-02-10T23:59:59Z) or date-only (YYYY-MM-DD).

page

integer · min: 0

Page number (zero-indexed)

Default: 0

page_size

integer · min: 1 · max: 100

Number of results per page

Default: 50

List Sessions › Responses

Session list

SessionListResponse

SessionResponse[]

uri

string

Current request URI

Example: /v1/chatterwave/sessions/

page

integer

Current page number

Example: 0

page_size

integer

Results per page

Example: 50

first_page_uri

string

URI for the first page

Example: /v1/chatterwave/sessions/?page=0&page_size=50

next_page_uri

string | null

URI for the next page

Example: /v1/chatterwave/sessions/?page=1&page_size=50

previous_page_uri

string | null

URI for the previous page

Example: null

GET/chatterwave/sessions/

curl https://api.helios.pressone.co/api/v1/chatterwave/sessions \
  --header 'Authorization: Basic <credentials>'

Example Responses

{
  "sessions": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "session_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "session_type": "otp",
      "from": "+14155550100",
      "to": "+14155551234",
      "status": "delivered",
      "call_status": "completed",
      "cost": 0.05,
      "queued_at": "2024-01-15T10:30:00Z",
      "initiated_at": "2024-01-15T10:30:01Z",
      "answered_at": "2024-01-15T10:30:05Z",
      "completed_at": "2024-01-15T10:30:25Z"
    }
  ],
  "uri": "/v1/chatterwave/sessions/",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/v1/chatterwave/sessions/?page=0&page_size=50",
  "next_page_uri": "/v1/chatterwave/sessions/?page=1&page_size=50",
  "previous_page_uri": null
}

json

application/json

Get Session

GET

https://api.helios.pressone.co/api/v1

/chatterwave/sessions/{session_id}/

Returns details for a specific call session.

Get Session › path Parameters

session_id

string · uuid · required

Unique identifier of the session

Get Session › Responses

Session details

SessionResponse

id

string · uuid

Unique identifier for this call record

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

session_id

string | null · uuid

Batch session ID (for TTS with multiple recipients)

Example: b2c3d4e5-f6a7-8901-bcde-f12345678901

session_type

string · enum

Type of session

Enum values:

otp

tts

Example: otp

from

string

Caller ID (DID phone number)

Example: +14155550100

to

string

Recipient phone number

Example: +14155551234

status

string · enum

Session status

Enum values:

queued

pending

delivered

failed

Example: delivered

call_status

string | null

Underlying call status from the telephony provider

Example: completed

cost

number | null · decimal

Cost of the call in account currency

Example: 0.05

queued_at

string | null · date-time

Timestamp when the session was queued

Example: 2024-01-15T10:30:00Z

initiated_at

string | null · date-time

Timestamp when the call was initiated

Example: 2024-01-15T10:30:01Z

answered_at

string | null · date-time

Timestamp when the call was answered

Example: 2024-01-15T10:30:05Z

completed_at

string | null · date-time

Timestamp when the call completed

Example: 2024-01-15T10:30:25Z

Text-to-Speech Resources

List Sessions

GET

https://api.helios.pressone.co/api/v1

/chatterwave/sessions/

Returns a paginated list of call sessions for the authenticated account. Sessions can be filtered by type, status, caller ID, recipient number, batch session ID, and created-at date range.

List Sessions › query Parameters

session_type

string · enum

Filter by session type

Enum values:

otp

tts

status

string · enum

Filter by session status

Enum values:

queued

pending

delivered

failed

from

string

Filter by caller ID (DID phone number in E.164 format)

Example: +14155550100

to

string

Filter by recipient phone number (exact match, E.164 format)

Example: +14155551234

session_id

string · uuid

Filter by batch session ID

start_date

string

Filter sessions created on or after this timestamp. Accepts RFC3339 datetime (for example 2026-02-01T00:00:00Z) or date-only (YYYY-MM-DD).

end_date

string

Filter sessions created on or before this timestamp. Accepts RFC3339 datetime (for example 2026-02-10T23:59:59Z) or date-only (YYYY-MM-DD).

page

integer · min: 0

Page number (zero-indexed)

Default: 0

page_size

integer · min: 1 · max: 100

Number of results per page

Default: 50

List Sessions › Responses

Session list

SessionListResponse

SessionResponse[]

uri

string

Current request URI

Example: /v1/chatterwave/sessions/

page

integer

Current page number

Example: 0

page_size

integer

Results per page

Example: 50

first_page_uri

string

URI for the first page

Example: /v1/chatterwave/sessions/?page=0&page_size=50

next_page_uri

string | null

URI for the next page

Example: /v1/chatterwave/sessions/?page=1&page_size=50

previous_page_uri

string | null

URI for the previous page

Example: null

Get Session

GET

https://api.helios.pressone.co/api/v1

/chatterwave/sessions/{session_id}/

Returns details for a specific call session.

Get Session › path Parameters

session_id

string · uuid · required

Unique identifier of the session

Get Session › Responses

Session details

SessionResponse

id

string · uuid

Unique identifier for this call record

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

session_id

string | null · uuid

Batch session ID (for TTS with multiple recipients)

Example: b2c3d4e5-f6a7-8901-bcde-f12345678901

session_type

string · enum

Type of session

Enum values:

otp

tts

Example: otp

from

string

Caller ID (DID phone number)

Example: +14155550100

to

string

Recipient phone number

Example: +14155551234

status

string · enum

Session status

Enum values:

queued

pending

delivered

failed

Example: delivered

call_status

string | null

Underlying call status from the telephony provider

Example: completed

cost

number | null · decimal

Cost of the call in account currency

Example: 0.05

queued_at

string | null · date-time

Timestamp when the session was queued

Example: 2024-01-15T10:30:00Z

initiated_at

string | null · date-time

Timestamp when the call was initiated

Example: 2024-01-15T10:30:01Z

answered_at

string | null · date-time

Timestamp when the call was answered

Example: 2024-01-15T10:30:05Z

completed_at

string | null · date-time

Timestamp when the call completed

Example: 2024-01-15T10:30:25Z