Passer au contenu principal
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
    }
  }
}

Autorisations

Authorization
string
header
requis

Scope needed: CONVERSATIONS_READ

Paramètres de requête

size
integer
défaut:10

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

Plage requise: 1 <= x <= 100
page
integer
défaut:0

Page number (0-indexed).

Plage requise: x >= 0
allo_number
string
requis

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

Exemple:

"+1234567890"

Réponse

Calls retrieved successfully

Standard response wrapper for paginated call results

data
object