---
title: "Get inbox response-time stats"
method: GET
path: "/v1/analytics/inbox/response-time"
tags: ["Inbox Analytics"]
---

# Get inbox response-time stats

`GET /v1/analytics/inbox/response-time`

Time-to-first-response stats. Pairs each received message with the
next sent message in the same conversation and reports the delta
as both summary statistics and a fixed-bucket histogram suited
for the analytics page's TTR chart.

`sampleSize` reflects only conversations that received AND got a
reply in the window. Received-but-never-answered conversations
are excluded. Compare against /v1/analytics/inbox/volume's
`summary.received` to compute reply rate.

Max date range is 365 days.

## Query parameters

- `fromDate` string, date, required
- `toDate` string, date
- `profileId` string
- `platform` string
- `accountId` string

## Response `200`

Response-time summary + histogram

- object
  - `success` boolean
  - `from` string, date
  - `to` string, date, nullable
  - `summary` object
    - `sampleSize` integer
    - `medianSeconds` integer
    - `p90Seconds` integer
    - `p99Seconds` integer
    - `meanSeconds` integer
    - `fastestSeconds` integer
    - `slowestSeconds` integer
  - `histogram` object[]
    - `bucket` string — Human label (0-1m, 1-5m, 5-15m, 15-60m, 1-4h, 4-24h, 1d+)
    - `lowerSeconds` integer
    - `upperSeconds` integer, nullable — null on the open-ended last bucket
    - `count` integer

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `500` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `500` status
  - added the optional property `details/quotaScope` to the response with the `500` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/analytics/inbox/response-time/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/be448f13ecdc?raw)