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

​
Request

curl "https://app.orova.ai/api/history?workspaceId=WORKSPACE_ID&page=1&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Query parameters

ParameterTypeDefaultDescription
workspaceIdstring—Filter by workspace
pagenumber1Page number
limitnumber10Items per page
agentTypestring—Filter by type: voice, chat, video
startDatestring—Filter from date (ISO 8601)
endDatestring—Filter to date (ISO 8601)
searchstring—Search by name or phone

​
Response

{
  "data": [
    {
      "_id": "history_id",
      "agentType": "voice",
      "fullName": "John Doe",
      "mobileNumber": "+1234567890",
      "callDuration": 120,
      "callEndReason": "user_hangup",
      "callSummary": "Customer called about billing...",
      "callCost": 0.05,
      "workspace_id": "WORKSPACE_ID",
      "createdAt": "2025-01-01T00:00:00.000Z"
    }
  ],
  "total": 50,
  "page": 1,
  "limit": 10
}