---
title: "Attempt cohort analysis"
method: GET
path: "/analytics/attempt-cohort"
tags: ["Analytics"]
---

# Attempt cohort analysis

`GET /analytics/attempt-cohort`

Returns cohort analysis of call attempt numbers, showing how pickup rate changes across the 1st, 2nd, 3rd (etc.) attempts to reach the same number, including cumulative rates and marginal gain per additional attempt.

## Query parameters

- `agentId` string
- `campaignId` string
- `callType` string
- `dateFrom` string, date-time
- `dateTo` string, date-time

## Response `200`

Attempt cohort data

- object
  - `success` boolean
  - `data` object
    - `orgId` string
    - `cohorts` object[]
      - `attemptNumber` number
      - `totalCalls` number
      - `answeredCalls` number
      - `pickupRate` number
      - `cumulativeAnswered` number
      - `cumulativeRate` number
      - `marginalGain` number
    - `totalUniqueNumbers` number
    - `maxAttemptsSeen` number
    - `avgAttemptsToPickup` number
    - `period` AnalyticsDateRange
      - `from` string, date
      - `to` string, date

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/versions/6d1036a76fbc/schema)