Making Your First Request

This guide walks you through querying your first call from the MeetRox API.

Prerequisites

A MeetRox workspace with at least one recorded conversation
An API key (see Authentication)

1. List your calls

Send a GET request to /v1/calls:

curl https://api.meetrox.ai/v1/calls \
  -H "x-api-key: YOUR_API_KEY"

A successful response returns a paginated list of calls:

{
  "data": [
    {
      "id": 42,
      "workspace_id": 7,
      "title": "Demo call with Acme Corp",
      "duration": 1823.4,
      "timestamp": "2026-05-15T14:30:00Z",
      "format": "video",
      "public": false,
      "source": { "system": "google_meet", "system_id": "abc-xyz-123" },
      "url": "https://app.meetrox.com/7/calls/42",
      "agent": {
        "id": 5,
        "name": "Ana Silva",
        "email": "[email protected]"
      },
      "interaction_metrics": {
        "rep_talk_ratio": 0.48,
        "call_exchanges": 32,
        "longest_rep_monologue": 87.2,
        "longest_lead_story": 54.1,
        "silence_percentage": 0.06,
        "ai_score": 82.5,
        "score": 78.0
      },
      "business_info": {
        "lead_name": "John Doe",
        "lead_company": "Acme Corp",
        "won": null
      },
      "type": {
        "id": 3,
        "name": "Demo",
        "description": "Product demonstration calls",
        "association_mode": "crm_deal"
      },
      "associations": {
        "crm_deals": [
          {
            "system": "hubspot",
            "system_id": "98765432",
            "label": "Acme Corp - Enterprise Deal",
            "url": "https://app.hubspot.com/deals/98765432"
          }
        ]
      },
      "attendees": ["[email protected]"],
      "inserted_at": "2026-05-15T14:55:10Z",
      "updated_at": "2026-05-15T15:42:00Z"
    }
  ],
  "meta": {
    "page_size": 50,
    "has_next_page": true,
    "has_previous_page": false,
    "start_cursor": "g2wAAAABaAJtAAAACGNhbGxfaWRhKm4=",
    "end_cursor": "g2wAAAABaAJtAAAACGNhbGxfaWRhMm4=",
    "errors": [],
    "params": {}
  }
}

2. Fetch a specific call

Use the id from the list to retrieve full details — including AI summary and transcription:

curl https://api.meetrox.ai/v1/calls/42 \
  -H "x-api-key: YOUR_API_KEY"

The detail response includes the analysis object with the call summary and full transcription.

3. Paginate through results

Use first and after to move through pages:

curl "https://api.meetrox.ai/v1/calls?first=20&after=CURSOR_FROM_PREVIOUS_RESPONSE" \
  -H "x-api-key: YOUR_API_KEY"

The end_cursor value from each response is the cursor for the next page.

What's next?

Calls — full parameter and response reference
Call Types — query the conversation categories in your workspace
Users — list agents and their roles