Skip to main content
GET
/
v1
/
api
/
calls
Search Calls
curl --request GET \
  --url https://api.withallo.com/v1/api/calls \
  --header 'Authorization: <api-key>'
{
  "data": {
    "results": [
      {
        "id": "call_abc123",
        "from_number": "+1234567890",
        "to_number": "+0987654321",
        "length_in_minutes": 5.5,
        "type": "INBOUND",
        "summary": "Customer called about order status.",
        "tag": "support",
        "recording_url": "https://storage.withallo.com/recordings/abc123.mp3",
        "start_date": "2024-01-15T10:30:00",
        "transcript": [
          {
            "source": "AGENT",
            "text": "Hello, how can I help you today?",
            "time": "2024-01-15T10:30:05",
            "start_seconds": 5,
            "end_seconds": 8.5
          },
          {
            "source": "EXTERNAL",
            "text": "Hi, I'm calling about my order status.",
            "time": "2024-01-15T10:30:10",
            "start_seconds": 10,
            "end_seconds": 14
          }
        ]
      }
    ],
    "metadata": {
      "total_pages": 5,
      "current_page": 0
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

Scope needed: CONVERSATIONS_READ

Query Parameters

​
size
integer
default:10

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

Required range: 1 <= x <= 100
​
page
integer
default:0

Page number (0-indexed).

Required range: x >= 0
​
allo_number
string
required

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

Example:

"+1234567890"

​
contact_number
string

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

Example:

"+0987654321"

Response

Calls retrieved successfully

Standard response wrapper for paginated call results

​
data
object