GET
/v1/reports/slabetaSLA report
- Needs
- Read your data
(mcp:read) - Plan
- Any plan with API access
- Limits
- 300 a minute per key
- Undo
- Nothing to undo: this only reads.
SLA breaches in a period by metric (first response, next response, resolution), by day and by staff member. Needs a key made by someone with report permission.
A metric this workspace cannot answer is null and listed in unavailable[] with the reason. Never read `null` as zero.
Try it
Query (5)
A named period. Default `last_7_days`. Weeks start on Monday.
First day, YYYY-MM-DD. Give `from` and `to` together; they override `preset`. Up to 186 days.
Last day (inclusive), YYYY-MM-DD.
IANA time zone, e.g. `Asia/Dubai`. Default: your workspace time zone.
This only reads. It uses your real data and changes nothing.
Code and response
curl -X GET 'https://mcp.wa-api.cloud/v1/reports/sla' \ -H "Authorization: Bearer $API_KEY"
The code reads your key from $API_KEY.
Parameters
| Field | Type | What it is |
|---|---|---|
| preset | string · query | A named period. Default last_7_days. Weeks start on Monday.one of: today, yesterday, last_7_days, last_14_days, last_30_days, this_month, last_month, this_week, last_week |
| from | string · query | First day, YYYY-MM-DD. Give from and to together; they override preset. Up to 186 days.pattern ^\d{4}-\d{2}-\d{2}$ |
| to | string · query | Last day (inclusive), YYYY-MM-DD.pattern ^\d{4}-\d{2}-\d{2}$ |
| timezone | string · query | IANA time zone, e.g. Asia/Dubai. Default: your workspace time zone.1–64 characters |
| metric_types | array of string · query | Only these metrics.1–3 items |
Headers
| Field | Type | What it is |
|---|---|---|
| Authorizationrequired | header | Bearer $API_KEY — your API key. |
| Api-Version | header | The API version to use, e.g. 2026-10-01. Default: the version your key is pinned to.one of: 2026-10-01 · pattern ^\d{4}-\d{2}-\d{2}$ |
Response 200
The report.
| Field | Type | What it is |
|---|---|---|
| rangerequired | object | The range and timezone these numbers were counted in — always state it when reporting them. |
| fromrequired | string | First local day (YYYY-MM-DD), inclusive. |
| torequired | string | Last local day (YYYY-MM-DD), inclusive. |
| daysrequired | integer | Number of local days in the range.-9007199254740991–9007199254740991 |
| timezonerequired | string | IANA timezone the days were counted in. |
| started_atrequired | string | Range start as a UTC instant (ISO-8601). |
| ended_atrequired | string | Range end as a UTC instant (ISO-8601), exclusive. |
| presetrequired | string or null | The named range used, if any. |
| sla_runningrequired | boolean or null | Is SLA actually running for this workspace (plan entitlement AND the module switch)? null = unknown. |
| totalsrequired | object | |
| breachesrequired | integer or null | All breaches in the range (The platform's own count, even when the row scan was capped).-9007199254740991–9007199254740991 |
| by_metricrequired | object | |
| first_responserequired | integer | -9007199254740991–9007199254740991 |
| next_responserequired | integer | -9007199254740991–9007199254740991 |
| resolutionrequired | integer | -9007199254740991–9007199254740991 |
| totalrequired | integer | -9007199254740991–9007199254740991 |
| unresolvedrequired | integer | Breaches whose clock had still not been satisfied when scanned.-9007199254740991–9007199254740991 |
| acknowledgedrequired | integer | -9007199254740991–9007199254740991 |
| avg_breach_secondsrequired | number or null | Average working-time lateness across the scanned breaches. |
| compliance_raterequired | null | Always null here: "met" counts exist only inside a generated staff report. |
| by_policyrequired | array of object | Most breaches first. policyId null = no policy recorded on the breach. |
| policy_idrequired | string or null | |
| namerequired | string or null | |
| activerequired | boolean or null | |
| breachesrequired | object | |
| first_responserequired | integer | -9007199254740991–9007199254740991 |
| next_responserequired | integer | -9007199254740991–9007199254740991 |
| resolutionrequired | integer | -9007199254740991–9007199254740991 |
| totalrequired | integer | -9007199254740991–9007199254740991 |
| by_dayrequired | array of object | Breaches per day, keyed on the day the platform rendered the breach time in. |
| daterequired | string | |
| breachesrequired | integer | -9007199254740991–9007199254740991 |
| worst_offendersrequired | array of object | |
| staff_idrequired | string or null | null = nobody was assigned when the clock stopped. |
| namerequired | string or null | |
| breachesrequired | object | |
| first_responserequired | integer | -9007199254740991–9007199254740991 |
| next_responserequired | integer | -9007199254740991–9007199254740991 |
| resolutionrequired | integer | -9007199254740991–9007199254740991 |
| totalrequired | integer | -9007199254740991–9007199254740991 |
| avg_breach_secondsrequired | number or null | Average working-time lateness of their breaches. |
| unresolvedrequired | integer | -9007199254740991–9007199254740991 |
| config_problemsrequired | array of object | Why SLA timers do or do not run (from the platform's SLA diagnosis). |
| severityrequired | string | |
| coderequired | string | |
| messagerequired | string | |
| fix_hintrequired | string | |
| scannedrequired | integer | Breach rows read to build the groupings.-9007199254740991–9007199254740991 |
| truncatedrequired | boolean | true = the row scan hit its cap or the time budget; groupings cover only the rows scanned (totals.breaches is still the platform's full count). |
| notesrequired | array of string | |
| unavailablerequired | array of object | Metrics that are UNKNOWN (missing data source), not zero. Say so when reporting; do not fill them in with 0. |
| metricrequired | string | Which metric or section is missing, e.g. "messages.read". |
| reasonrequired | string | Why it is missing (not supported by this server version, service not configured, forbidden, temporarily unavailable…). |
Errors
Errors are application/problem+json. Branch on code.
| Status | Code | When |
|---|---|---|
| 400 | invalid_input | A field is missing or has the wrong format. |
| 401 | unauthenticated | The Authorization header is missing, the key is unknown, expired or revoked. |
| 403 | entitlement_required | The workspace's plan does not include API access ( |
| 403 | forbidden | The key owner has no report permission. |
| 403 | insufficient_scope | The key does not have the permission this operation needs. |
| 429 | rate_limited | The key or workspace went over its rate limit. Wait for |
| 503 | upstream_unavailable | A service behind the API is briefly unavailable. Safe to retry with backoff. |
Examples
Last 7 days
Response 200
{
"range": {
"from": "2026-09-17",
"to": "2026-09-23",
"days": 7,
"timezone": "Asia/Dubai",
"started_at": "2026-09-16T20:00:00Z",
"ended_at": "2026-09-23T20:00:00Z",
"preset": "last_7_days"
},
"sla_running": true,
"totals": {
"breaches": 7,
"unresolved": 1,
"by_metric": {
"first_response": -9007199254740991,
"next_response": -9007199254740991,
"resolution": -9007199254740991,
"total": -9007199254740991
},
"acknowledged": -9007199254740991,
"avg_breach_seconds": null,
"compliance_rate": null
},
"by_day": [
{
"date": "2026-09-23",
"breaches": 2
}
],
"worst_offenders": [
{
"staff_id": "1203",
"name": "Priya Nair",
"breaches": {
"first_response": -9007199254740991,
"next_response": -9007199254740991,
"resolution": -9007199254740991,
"total": -9007199254740991
},
"avg_breach_seconds": null,
"unresolved": -9007199254740991
}
],
"notes": [],
"unavailable": [],
"by_policy": [],
"config_problems": [],
"scanned": -9007199254740991,
"truncated": false
}Operation path
The same operation is also at POST /v1/ops/reports_sla, with every field in the JSON body.