FIfish
Agent Sessions

Get Agent Session

Changed on

Fetch one session's full detail: status, timing, and the conversation timeline (transcript turns interleaved with tool calls, in order).

get/v1/agent/sessions/{session_id}

Request

  • Base URL
    https://api.fish.audio
  • URL
    https://api.fish.audio/v1/agent/sessions/{session_id}
  • Auth
    HTTP bearer

Path parameters

session_idstring required

Response

Request fulfilled, document follows

session_idstring required
agent_idstring required
agent_namestring required
namestring nullable
end_user_idstring nullable
status'pending' | 'active' | 'completed' | 'failed' | 'unknown' required
end_reason'user_hangup' | 'agent_hangup' | 'escalated' | 'conversation_timeout' | 'heartbeat_timeout' | 'agent_join_timeout' | 'internal_error' | 'llm_endpoint_failure' | 'room_join_timeout' | 'cancelled' | 'dial_failed' nullable
source'api_key' | 'dashboard' | 'public' | 'phone' | 'whatsapp' required
direction'inbound' | 'outbound'
dial_status'answered' | 'busy' | 'no_answer' | 'failed' nullable
answered_by'human' | 'voicemail' | 'unknown' nullable
caller_numberstring nullable
dialed_numberstring nullable
sip_call_idstring nullable
call_sidstring nullable
timezonestring nullable
created_atstring required
started_atstring nullable
ended_atstring nullable
duration_secondsinteger nullable
participant_identitystring nullable
agent_participant_identitystring nullable
agent_joined_atstring nullable
metadataobject
content_purged_atstring nullable

Changes