WIwithallo
Calls

Search Calls

Changed on

Deprecated. Use GET /v2/api/conversations to list activity, or POST /v2/api/conversations/items/search to filter and keyword-search calls instead. This endpoint still responds, but it is no longer maintained and is not part of the current API reference.

Search and filter calls for a specific Allo phone number with pagination support.

get/v1/api/calls

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v1/api/calls
  • Auth
    API key in header Authorization

Query parameters

sizeinteger

Number of results per page. Must be between 1 and 100.

pageinteger

Page number (0-indexed).

allo_numberstring required
Example:+1234567890

Your Allo phone number to filter calls by. Must be in E.164 format (e.g., +1234567890).

contact_numberstring
Example:+0987654321

Filter calls by contact phone number. Only returns calls with this specific contact. Must be in E.164 format (e.g., +1234567890).

Response

Calls retrieved successfully

Example response

{
  "data": {
    "results": [
      {
        "id": "call_abc123",
        "from_number": "+1234567890",
        "to_number": "+0987654321",
        "length_in_minutes": 5.5,
        "result": "ANSWERED",
        "summary": "Customer inquired about order status",
        "tag": "support",
        "start_date": "2024-01-15T10:30:00",
        "transcript": [
          {
            "text": "Hello, how can I help you today?",
            "time": "2024-01-15T10:30:15",
            "start_seconds": 15,
            "end_seconds": 18.5
          }
        ]
      }
    ],
    "metadata": {
      "total_pages": 5
    }
  }
}

Changes