Skip to main content
GET
/
v1
/
metrics
curl "https://api.telzino.com/v1/metrics?startDate=2025-01-01T00:00:00.000Z&endDate=2025-12-31T23:59:59.000Z" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by organization
curl "https://api.telzino.com/v1/metrics?startDate=2025-01-01T00:00:00.000Z&endDate=2025-12-31T23:59:59.000Z&organizationId=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by reseller
curl "https://api.telzino.com/v1/metrics?startDate=2025-01-01T00:00:00.000Z&endDate=2025-12-31T23:59:59.000Z&resellerId=123e4567-e89b-12d3-a456-426614174999" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": {
    "metrics": {
      "totalCalls": 1250,
      "totalMinutes": 3420.5,
      "resolutionRate": 78.4,
      "avgDuration": 164.2,
      "activeAgents": 12
    },
    "dailyVolume": [
      {
        "date": "2025-01-01",
        "totalCalls": 45,
        "resolvedCalls": 36
      },
      {
        "date": "2025-01-02",
        "totalCalls": 52,
        "resolvedCalls": 41
      }
    ],
    "hourlyDistribution": [
      { "hour": "00:00", "calls": 5, "minutes": 12.3 },
      { "hour": "01:00", "calls": 2, "minutes": 4.1 },
      { "hour": "09:00", "calls": 85, "minutes": 230.5 },
      { "hour": "10:00", "calls": 92, "minutes": 248.7 }
    ],
    "resolutionBreakdown": {
      "resolved": 980,
      "transferred": 150,
      "abandoned": 80,
      "other": 40
    },
    "agentPerformance": [
      {
        "agentId": "123e4567-e89b-12d3-a456-426614174000",
        "agentName": "Customer Support Agent",
        "totalCalls": 450,
        "resolved": 360,
        "transferred": 50,
        "abandoned": 25,
        "other": 15,
        "resolvedPercent": 80.0,
        "transferredPercent": 11.1,
        "abandonedPercent": 5.6,
        "otherPercent": 3.3
      }
    ]
  }
}

​
Query Parameters

​
startDate
string
required
Start of the date range in ISO 8601 format (e.g., 2025-01-01T00:00:00.000Z)
​
endDate
string
required
End of the date range in ISO 8601 format (e.g., 2025-12-31T23:59:59.000Z)
​
organizationId
string
Filter metrics by organization ID (UUID format). If omitted, returns metrics across all accessible organizations.
​
resellerId
string
Filter metrics by reseller ID (UUID format). Returns the same metrics fields, structure, and data types as the organization response, aggregated across all organizations under that reseller.
curl "https://api.telzino.com/v1/metrics?startDate=2025-01-01T00:00:00.000Z&endDate=2025-12-31T23:59:59.000Z" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by organization
curl "https://api.telzino.com/v1/metrics?startDate=2025-01-01T00:00:00.000Z&endDate=2025-12-31T23:59:59.000Z&organizationId=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by reseller
curl "https://api.telzino.com/v1/metrics?startDate=2025-01-01T00:00:00.000Z&endDate=2025-12-31T23:59:59.000Z&resellerId=123e4567-e89b-12d3-a456-426614174999" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": {
    "metrics": {
      "totalCalls": 1250,
      "totalMinutes": 3420.5,
      "resolutionRate": 78.4,
      "avgDuration": 164.2,
      "activeAgents": 12
    },
    "dailyVolume": [
      {
        "date": "2025-01-01",
        "totalCalls": 45,
        "resolvedCalls": 36
      },
      {
        "date": "2025-01-02",
        "totalCalls": 52,
        "resolvedCalls": 41
      }
    ],
    "hourlyDistribution": [
      { "hour": "00:00", "calls": 5, "minutes": 12.3 },
      { "hour": "01:00", "calls": 2, "minutes": 4.1 },
      { "hour": "09:00", "calls": 85, "minutes": 230.5 },
      { "hour": "10:00", "calls": 92, "minutes": 248.7 }
    ],
    "resolutionBreakdown": {
      "resolved": 980,
      "transferred": 150,
      "abandoned": 80,
      "other": 40
    },
    "agentPerformance": [
      {
        "agentId": "123e4567-e89b-12d3-a456-426614174000",
        "agentName": "Customer Support Agent",
        "totalCalls": 450,
        "resolved": 360,
        "transferred": 50,
        "abandoned": 25,
        "other": 15,
        "resolvedPercent": 80.0,
        "transferredPercent": 11.1,
        "abandonedPercent": 5.6,
        "otherPercent": 3.3
      }
    ]
  }
}

​
Response Fields

​
metrics

FieldTypeDescription
totalCallsnumberTotal number of calls in the date range
totalMinutesnumberTotal call minutes
resolutionRatenumberPercentage of calls resolved (0–100)
avgDurationnumberAverage call duration in seconds
activeAgentsnumberNumber of agents that handled calls

​
dailyVolume

Array of daily call counts:
FieldTypeDescription
datestringDate in YYYY-MM-DD format
totalCallsnumberTotal calls on this date
resolvedCallsnumberCalls resolved on this date

​
hourlyDistribution

Array of 24 entries (one per hour of the day):
FieldTypeDescription
hourstringHour in HH:00 format (e.g., "09:00")
callsnumberNumber of calls during this hour
minutesnumberTotal minutes during this hour

​
resolutionBreakdown

FieldTypeDescription
resolvednumberCalls successfully resolved by the agent
transferrednumberCalls transferred to a human
abandonednumberCalls abandoned by the caller
othernumberCalls with other outcomes

​
agentPerformance

Array of per-agent metrics:
FieldTypeDescription
agentIdstringAgent UUID
agentNamestringAgent display name
totalCallsnumberTotal calls handled
resolvednumberCalls resolved
transferrednumberCalls transferred
abandonednumberCalls abandoned
othernumberOther outcomes
resolvedPercentnumberPercentage resolved
transferredPercentnumberPercentage transferred
abandonedPercentnumberPercentage abandoned
otherPercentnumberPercentage other