Get latest call by phone number

GET

api

calls

latest-by-phone

curl --request GET \
  --url https://enterprise-api.avoca.ai/api/calls/latest-by-phone \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "call_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "duration_seconds": 123,
    "call_reason": "<string>",
    "call_outcome": "<string>",
    "is_booked": true,
    "is_bookable": true,
    "is_transferred": true,
    "first_name": "<string>",
    "last_name": "<string>",
    "phone_number": "<string>"
  }
}

Authorizations

Authorization

string

header

required

API key in the format avoca_<64 hex characters>

Headers

x-team-id

integer

Target team ID. Required for multi-team (enterprise_all_teams / portfolio_all_teams) keys on v0 endpoints; single-team keys are locked to their team and omit it.

Query Parameters

phone

string

required

Phone number to search

Response

The most recent matching call

data

object

A call record. The exact columns returned on list endpoints are governed by the team's configured column allowlist; the fields below are the standard set.

Show child attributes

List pre-call transfersList inbound calls that were forwarded to a configured destination *before* the AI agent picked up, based on the team's pre-call transfer rules. These calls have `duration_seconds: 0` because the AI never engaged. Returns a fixed shape and does not honor the team's column allowlist. Requires the `read:calls` permission.

⌘I

Get latest call by phone number

curl --request GET \
  --url https://enterprise-api.avoca.ai/api/calls/latest-by-phone \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "call_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "duration_seconds": 123,
    "call_reason": "<string>",
    "call_outcome": "<string>",
    "is_booked": true,
    "is_bookable": true,
    "is_transferred": true,
    "first_name": "<string>",
    "last_name": "<string>",
    "phone_number": "<string>"
  }
}