Extension Summary

📘 Looking for live/real-time queue, agent or call-level data? See Work Analytics — Overview.

8x8 Work Analytics Historical access is via this multi step process. For any of the endpoints the same process is followed.

📘 You will need a working API key to begin

You can generate API credentials from How to get API Keys

The 8x8-api-key will be the Key generated. For Work Analytics the Secret from Admin Console is not required.

📘

Note: This API provides access to data from the past 2 years only in accordance with Analytics for Work data compliance policies; queries spanning more than 2 years will return only the most recent 2 years of data, and queries outside this range will return no results

Use the following base URL during this process:

• https://api.8x8.com/analytics/work

Run Report

Parameters

Method: GET

Headers

Name	Required	Description	Example
8x8-apikey	✓	The 8x8-api key provided	test_key_kjdfidj238jf9123df221
Authorization	✓	Pass the access_token returned from the authentication request as a Bearer token Bearer {access_token}	Bearer eyJhbGciOiJSUzI1NiJ9.yyyyyyyyyyy.zzzzzzzzzzzz

Path

Name	Required	Description	Example
version	✓	The current version for extension summary is v2	v2

Query

Name	Required	Description	Example
pbxId	✓	Pass the pbxId (PBX Name) of the requested pbx or comma separated list of pbxIds or allpbxes for all of the pbxs in the customer account. PBX names can be found here in Admin Console	acmecorp,acmecorp2
startTime	✓	The interval start time for CDR searches - the format is YYYY-MM-DD HH:MM:SS.	2022-10-20 08:30:00
endTime	✓	The interval end time for CDR searches - the format is YYYY-MM-DD HH:MM:SS.	2022-10-20 19:00:00
timeZone	✓	IANA Time Zones. Examples America/New_York, Europe/London Wikipedia Time Zone List	America/New_York

Extension Summary Request

📘 Try out the Extension Summary

Try it out @ Extension Summary Reference and see who's made more calls.

curl --location --request GET 'https://api.8x8.com/analytics/work/v{version}/extsum?pbxId={pbxId here}&startTime=2022-02-03 00:00:00&endTime=2022-02-03 10:00:00&timeZone=America/New_York' \
--header 'Authorization: Bearer {access_token here}' \
--header '8x8-apikey: {8x8-apikey input here}'

Extension Summary Response

For details on the company summary metrics please refer to Extension Summary Glossary

📘 Durations are in milliseconds

[
    {
        "PbxId": "acmecorp",
        "Extension": "8885",
        "ServiceType": "UE",
        "FirstName": "Alice",
        "LastName": "Smith",
        "Branch": "East Coast",
        "Department": "Marketing",
        "External_Inbound_Total": 1,
        "External_Inbound_Answered": 0,
        "External_Inbound_Abandoned": 1,
        "Percent_External_Inbound_Answered": 0,
        "External_Inbound_Missed": 1,
        "External_Outbound_Total": 0,
        "External_Outbound_Answered": 0,
        "Percent_External_Outbound_Answered": 0,
        "External_Outbound_Abandoned": 0,
        "Internal_Inbound_Total": 0,
        "Internal_Inbound_Answered": 0,
        "Internal_Inbound_Abandoned": 0,
        "Internal_Inbound_Missed": 0,
        "Internal_Outbound_Total": 0,
        "Internal_Outbound_Answered": 0,
        "Internal_Outbound_Abandoned": 0,
        "Inbound_Total": 1,
        "Inbound_Answered": 0,
        "Inbound_Abandoned": 1,
        "Inbound_Missed": 1,
        "Total_Calls_To_VM": 0,
        "Outbound_Total": 0,
        "Outbound_Answered": 0,
        "Outbound_Abandoned": 0,
        "Total_Answered": 0,
        "Total_Abandoned": 1,
        "Total_Missed": 1,
        "Total_Ring_Time": 1195,
        "Total_Talk_Time": 0,
        "Total_Abandoned_Time": 0,
        "Total_Call_Time": 19048,
        "Avg_Ring_Time": 1195,
        "Avg_Talk_Time": 0,
        "Inbound_Talk_Time": 0,
        "Outbound_Talk_Time": 0,
        "Avg_Abandoned_Time": 0,
        "Email": "alice.smith",
        "UserName": "user@example.com"
    },
    {
        "PbxId": "acmecorp2",
        "Extension": "441001",
        "ServiceType": "UE",
        "FirstName": "Li",
        "LastName": "Chan",
        "Branch": "Remote",
        "Department": "HR",
        "External_Inbound_Total": 1,
        "External_Inbound_Answered": 1,
        "External_Inbound_Abandoned": 0,
        "Percent_External_Inbound_Answered": 100,
        "External_Inbound_Missed": 0,
        "External_Outbound_Total": 0,
        "External_Outbound_Answered": 0,
        "Percent_External_Outbound_Answered": 0,
        "External_Outbound_Abandoned": 0,
        "Internal_Inbound_Total": 0,
        "Internal_Inbound_Answered": 0,
        "Internal_Inbound_Abandoned": 0,
        "Internal_Inbound_Missed": 0,
        "Internal_Outbound_Total": 0,
        "Internal_Outbound_Answered": 0,
        "Internal_Outbound_Abandoned": 0,
        "Inbound_Total": 1,
        "Inbound_Answered": 1,
        "Inbound_Abandoned": 0,
        "Inbound_Missed": 0,
        "Total_Calls_To_VM": 0,
        "Outbound_Total": 0,
        "Outbound_Answered": 0,
        "Outbound_Abandoned": 0,
        "Total_Answered": 1,
        "Total_Abandoned": 0,
        "Total_Missed": 0,
        "Total_Ring_Time": 5160,
        "Total_Talk_Time": 2248,
        "Total_Abandoned_Time": 0,
        "Total_Call_Time": 7408,
        "Avg_Ring_Time": 5160,
        "Avg_Talk_Time": 2248,
        "Inbound_Talk_Time": 0,
        "Outbound_Talk_Time": 0,
        "Avg_Abandoned_Time": 0,
        "Email": "user@example.com",
        "UserName": "li.chan"
    }
]

Fields not defined in glossary

Name	Description
UserName	8x8 username of the user, or "N/A" for non users
Email	Configured email address of the user, or "N/A" for non users