Get Scored Calls Report

GET

https://platform-api.convirza.com/v3/scorecards/report/scored-calls

Scorecards

Last modified:2026-07-24 13:10:44

Returns aggregated scorecard reporting data including outcome percentages, average scores, and criteria-level breakdowns.

Access Control

Requires Admin role

Returns data within user's organizational scope

Report Sections

Outcome Percent vs Average Score: Group-level aggregations showing scored calls, outcomes, average scores, and review rates

Average Criteria Score: Scorecard criteria performance broken down by group and criteria

Filtering

start_date — Filter calls from this date (YYYY-MM-DD)

end_date — Filter calls until this date (YYYY-MM-DD)

show_by — Group results by "Group Name" or "User Name" (default: "Group Name")

Pagination

limit — Records per page (max 200, default 100)

offset — Number of records to skip (default 0)

Example Request

GET /v3/scorecards/report/scored-calls?start_date=2026-01-01&end_date=2026-03-31&show_by=Group Name&limit=50

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Report data retrieved successfully

Bodyapplication/json

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/scorecards/report/scored-calls?limit=&offset=&start_date=&end_date=&show_by=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Scored calls report retrieved successfully",
    "data": [
        {
            "outcome_percent_vs_average_score": [
                {
                    "group_name": "Sales Team|70035",
                    "final_score_sum": 8523.5,
                    "highest_score": 100,
                    "lowest_score": 45,
                    "average_score": 85.24,
                    "scored_calls": 100,
                    "outcome": 72,
                    "outcome_rate": 72,
                    "reviewed_calls": 45,
                    "reviewed_calls_percentage": "45.00%"
                }
            ]
        },
        {
            "average_criteria_score": [
                {
                    "group_name": "Sales Team|70035",
                    "scorecard_title": "Quality Scorecard",
                    "display_order": 1,
                    "criteria_title": "Greeting",
                    "average_criteria_grid_score": "92"
                }
            ]
        }
    ],
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-04-22T10:30:00.000Z"
}

Modified at 2026-07-24 13:10:44

List Scorecards

Create Scorecard