Calls

List calls with filters

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/calls/

Query call entities with date range, status, and duration filters.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Query parameters

date_fromany ofOptional

Start date (inclusive)

string · dateOptional

or

nullOptional

date_toany ofOptional

End date (inclusive)

string · dateOptional

or

nullOptional

statusany ofOptional

Filter by call status (completed, in_progress, escalated)

stringOptional

or

nullOptional

directionany ofOptional

Filter by direction (inbound, outbound)

stringOptional

or

nullOptional

min_durationany ofOptional

Minimum duration in seconds

integerOptional

or

nullOptional

max_durationany ofOptional

Maximum duration in seconds

integerOptional

or

nullOptional

limitinteger · min: 1 · max: 100OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

totalintegerRequired

has_morebooleanRequired

422

Validation Error

application/json

get

/v1/{workspace_id}/calls/

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/calls/ HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "entity_id": "text",
      "call_sid": "text",
      "direction": "text",
      "phone_number": "text",
      "caller_id": "text",
      "started_at": "2026-03-22T05:27:56.940Z",
      "duration_seconds": 1,
      "status": "text",
      "escalation_status": "text",
      "turns": 1,
      "has_recording": true
    }
  ],
  "total": 1,
  "has_more": true
}

Call volume per phone number

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/calls/phone-volume

Aggregated call counts and durations grouped by phone number.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Query parameters

daysinteger · min: 1 · max: 90OptionalDefault: 30

Responses

200

Successful Response

application/json

phone_numberstringRequired

total_callsintegerRequired

inboundintegerRequired

outboundintegerRequired

avg_duration_secondsany ofRequired

numberOptional

or

nullOptional

422

Validation Error

application/json

get

/v1/{workspace_id}/calls/phone-volume

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/calls/phone-volume HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "phone_number": "text",
    "total_calls": 1,
    "inbound": 1,
    "outbound": 1,
    "avg_duration_seconds": 1,
    "by_date": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ]
  }
]