Obtain API credentials from your Playvox account settings; authenticate by passing the credentials in the request headers as required by the Playvox API (consult current Playvox documentation for the exact auth scheme).
Use the Get All Evaluations endpoint to retrieve evaluation records; include the ?include=all query parameter to receive the most complete evaluation data available.
For each evaluation, note the scorecard_id; to retrieve the full scorecard definition (section names, category names, weight configuration), call the Get Scorecards endpoint with that scorecard_id.
Join evaluation records with scorecard definitions by matching the nested category/section IDs in evaluation records to the corresponding objects in the scorecard definition to produce human-readable scored results.
To export reporting data in bulk, use the Playvox Export Reporting API endpoint and poll the export job status until the data file is available for download.
Filter evaluations by agent, team, date range, or queue using the available query parameters to scope exports for downstream analytics or agent coaching workflows.
Known gotchas
Section and category scores inside evaluation records are nested objects identified by numeric IDs; they are not self-describing — omitting the corresponding scorecard definition fetch will leave you with numeric IDs and no labels.
Playvox's API documentation is hosted in the help center rather than a dedicated developer portal; endpoint paths and authentication details are subject to change without a formal deprecation notice — pin to a specific API version if one is available.
Evaluations created manually in the Playvox UI and those created via integration (e.g., from Zendesk or Salesforce) may have different field population patterns; test both paths when building an export pipeline.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp