Developers / Agents

Get a conversation

GET https://api.echonova.ai/v1/agents/{agentId}/conversations/{sessionId}

Returns one conversation of the agent: how it ended, how long it took, the tools used and the credits charged. Needs the agents:read scope on the key.

Headers

Authorization string Required

Bearer, a space, then your API key, which starts with ek_. Create keys in the portal under Developers, API Keys.

Path parameters

agentId string Required

The agent id, as GET /v1/agents returned it.

sessionId string Required

The conversation id, as GET /v1/agents/{agentId}/conversations returned it.

Response

200 application/json Every response uses this envelope.

data object

The result.

success boolean

true for a successful call.

statusCode integer

Repeats the HTTP status.

errorMessage string or null

null on success.

Errors

Same envelope, with success false and data null. All errors

GET /v1/agents/{agentId}/conversations/{sessionId}

curl "https://api.echonova.ai/v1/agents/{agentId}/conversations/{sessionId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "6651a1b2c3d4e5f6a7b8c9d0",
    "channel": "web_chat",
    "status": "resolved",
    "startedAt": "2026-11-02T10:00:00.000Z",
    "durationMs": 95000,
    "rating": 5,
    "summary": "The customer asked about the Pro plan price.",
    "closeReason": "end_conversation_tool",
    "turns": 6,
    "toolsUsed": [
      "web_search"
    ],
    "credits": 4
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}