Allo

Outbound metrics

Returns outbound call metrics: dial funnel (dials → connected → conversations → conversions), time series, heatmap, leaderboard, and time spent metrics.

POST/v2/api/analytics/outbound

Extend parameter

Use extend=items with a stage to include the actual list of outbound calls behind the funnel numbers in the response.

ValueRequiresEffect
itemsstageIncludes a paginated items field with the calls for the specified funnel stage

Stages

StageCalls included
DIALAll outbound dials
CONNECTEDCalls where the recipient picked up
CONVERSATIONConnected calls longer than 1 minute
CONVERSIONCalls tagged with one of the specified tags

Example with drilldown

{
  "date": { "from": "2026-04-14", "to": "2026-04-21" },
  "tags": ["meeting_booked"],
  "granularity": "DAY",
  "extend": "items",
  "stage": "CONVERSION",
  "page": 1,
  "size": 20
}

The response includes the full funnel metrics plus an items field with the paginated call list for the requested stage.

Passing extend=items without stage returns a 400 error with code MISSING_PARAMETER.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Body

dateobjectrequired
2 fields
fromstring<date>required

Start date

tostring<date>required

End date

compare_dateobject
2 fields
fromstring<date>required

Start date

tostring<date>required

End date

user_idsstring[]

Filter by user IDs. Cannot be combined with allo_numbers.

allo_numbersstring[]

Filter by Allo numbers (E.164). Cannot be combined with user_ids.

tagsstring[]

Tag keys that define a conversion (e.g. ['meeting_booked', 'demo_scheduled'])

granularityenum<string>

Time series granularity

DAYWEEKMONTH

extendenum<string>

Include the list of outbound calls behind the funnel numbers. Requires stage.

items

stageenum<string>

Filter drilldown items by funnel stage. Only used when extend=items.

DIALCONNECTEDCONVERSATIONCONVERSION

pageinteger

Page number for drilldown items. Only used when extend=items.

sizeinteger

Page size for drilldown items. Only used when extend=items.

Responses

200Outbound analytics
dataobject
9 fields
dateobject
2 fields
fromstring<date>required

Start date

tostring<date>required

End date

compare_dateobject
2 fields
fromstring<date>required

Start date

tostring<date>required

End date

funnelobject
4 fields
dialsobject
2 fields
countobject
ratenumber | null

Percentage of total dials (e.g. 0.29 = 29%)

connectedobject
2 fields
countobject
ratenumber | null

Percentage of total dials (e.g. 0.29 = 29%)

conversationsobject
2 fields
countobject
ratenumber | null

Percentage of total dials (e.g. 0.29 = 29%)

conversionsobject
2 fields
countobject
ratenumber | null

Percentage of total dials (e.g. 0.29 = 29%)

time_seriesobject
4 fields
dialsobject[]
2 fields
datestring<date>
valuenumber
connectedobject[]
2 fields
datestring<date>
valuenumber
connection_rateobject[]
2 fields
datestring<date>
valuenumber
conversionsobject[]
2 fields
datestring<date>
valuenumber
heatmapobject
3 fields
dialsobject[]
3 fields
dayenum<string>

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

hourinteger

Hour of day (0-23)

valueinteger
connectedobject[]
3 fields
dayenum<string>

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

hourinteger

Hour of day (0-23)

valueinteger
connection_rateobject[]
3 fields
dayenum<string>

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

hourinteger

Hour of day (0-23)

valueinteger
leaderboardobject[]
2 fields
userobject
3 fields
idstring
namestring
emailstring
connectedinteger
time_spentobject
3 fields
avg_ringing_time_secondsobject
3 fields
valuenumber

Current period value

previousnumber | null

Previous period value

changenumber | null

Percentage change vs previous period (e.g. 0.15 = +15%)

avg_conversation_time_secondsobject
3 fields
valuenumber

Current period value

previousnumber | null

Previous period value

changenumber | null

Percentage change vs previous period (e.g. 0.15 = +15%)

total_conversation_time_secondsobject
3 fields
valuenumber

Current period value

previousnumber | null

Previous period value

changenumber | null

Percentage change vs previous period (e.g. 0.15 = +15%)

last_updatedstring<date-time>

When the metrics were last updated

itemsobject | null

Drilldown call list. Only present when extend=items is set.

2 fields
dataobject[]
9 fields
idstring

Call ID

userobject
allo_numberstring
allo_number_labelstring
contact_numberstring
stageenum<string>

DIALCONNECTEDCONVERSATIONCONVERSION

voicemailboolean
durationinteger

Duration in seconds

datestring<date-time>
paginationobject
5 fields
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
400
401
429