Skip to main content
GET
/
api
/
history
/
{id}
Get Call History
curl --request GET \
  --url https://api.example.com/api/history/{id}

​
Request

curl "https://app.orova.ai/api/history/HISTORY_ID" \
  -H "x-api-key: YOUR_API_KEY"

​
Path parameters

ParameterTypeDescription
idstringHistory record ID

​
Response

{
  "_id": "history_id",
  "agentType": "voice",
  "fullName": "John Doe",
  "mobileNumber": "+1234567890",
  "callDuration": 120,
  "callEndReason": "user_hangup",
  "callTranscript": "Agent: Hi! How can I help?\nUser: I have a billing question...",
  "callSummary": "Customer called about billing. Agent resolved the issue.",
  "callCost": 0.05,
  "callRecordingUrl": "s3://bucket/recording.wav",
  "workspace_id": "WORKSPACE_ID",
  "createdAt": "2025-01-01T00:00:00.000Z"
}

​
Get recording URL

Recordings are stored in S3. To get a presigned download URL: 
curl "https://app.orova.ai/api/history/HISTORY_ID/recording-url" \
  -H "x-api-key: YOUR_API_KEY"
Returns a temporary presigned URL valid for download.