Public API (v1)
Sessions

Get Session By Caller

Get the most recent session for a phone number.

Returns the most recent active session, or falls back to the latest terminal session.

Authentication: API Key (Bearer token)

get/v1/sessions

Request

  • Base URL: https://api.trymaven.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trymaven.com/v1/sessions
  • Auth: HTTP bearer

Query parameters

callerstring required

Phone number in E.164 format

Response

Successful Response

session_idstring required

Session UUID

statusstring required

Session status

is_terminalboolean required

Whether the session has reached a final state

amountstring required

Amount to charge

currencystring required

Currency code

modestring required

Payment mode

descriptionstring nullable

Charge description

callerstring nullable

Phone number in E.164 format (voice sessions). Null for chat/widget sessions, which have no caller.

project_slugstring required

Project slug

gatewaystring required

Payment gateway

callbackstring nullable

Callback phone number

memorystring nullable

Call context passed back on transfer

transfer_statusstring nullable

Outcome of post-payment transfer-back dial

created_atstring date-time required

Creation timestamp

updated_atstring date-time required

Last update timestamp

expires_atstring date-time nullable

When the session expires if unused

completed_atstring date-time nullable

When the session reached a terminal state

Changes

No recorded changes to this operation across all 1 revision of this API.