Skip to main content
GET
/
api
/
calls
List Calls
curl --request GET \
  --url https://api.userintuition.ai/api/calls \
  --header 'Authorization: Bearer <token>'
{
  "calls": [
    {
      "id": "call-db-id-123",
      "call_id": "vapi-call-id-456",
      "assistant_id": "550e8400-e29b-41d4-a716-446655440000",
      "invite_id": "invite-id-789",
      "user_id": "user_123",
      "app_id": "user-intuition",
      "transcript": "AI: Hello! Thank you for joining...\nUser: Hi, glad to be here...",
      "messages": [
        {
          "role": "assistant",
          "message": "Hello! Thank you for joining..."
        },
        {
          "role": "user",
          "message": "Hi, glad to be here..."
        }
      ],
      "status": "ended",
      "success_evaluation": "Excellent",
      "success_evaluation_details": {
        "score": 9,
        "label": "Excellent",
        "reasoning": "Comprehensive and insightful responses throughout the interview."
      },
      "ended_reason": "completed",
      "started_at": "2024-01-15T14:00:00Z",
      "ended_at": "2024-01-15T14:07:30Z",
      "recording_url": "https://storage.example.com/recordings/call-456.mp3",
      "analysis": {
        "summary": "Great customer feedback session...",
        "overall": {
          "rating": 9,
          "possible_rating": 10
        }
      },
      "is_visible": true,
      "created_at": "2024-01-15T14:00:00Z",
      "updated_at": "2024-01-15T14:07:35Z",
      "invite": {
        "id": "invite-id-789",
        "assistant_id": "550e8400-e29b-41d4-a716-446655440000",
        "email": "customer@example.com",
        "company_name": "Example Corp",
        "name": "John Doe",
        "created_at": "2024-01-15T10:00:00Z",
        "updated_at": "2024-01-15T10:00:00Z"
      }
    }
  ],
  "total_count": 1,
  "page": 1,
  "page_size": 10
}

Documentation Index

Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate with an API key (prefixed ui_sk_) or a JWT token from the dashboard.

Query Parameters

​
page
integer
default:1

Page number (default: 1)

Required range: x >= 1
​
page_size
integer
default:10

Number of items per page (default: 10, max: 100)

Required range: 1 <= x <= 100
​
status
string

Filter by call status (e.g., started, ended, failed)

​
invite_id
string

Filter by invite ID

​
assistant_id
string

Filter by assistant ID

​
success_evaluation
string

Filter by success evaluation (e.g., Excellent, Good, Poor)

​
app_id
string

Filter by app ID - defaults to user-intuition if not provided

Response

Successful response with list of calls

​
calls
object[]
required
​
total_count
integer
required

Total number of calls

​
page
integer | null

Current page number

​
page_size
integer | null

Number of items per page