Get agent analytics section

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public?startEpoch=1784073600000&endEpoch=1784678400000&source=all' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

response = requests.get(
    "https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
    params={
        "startEpoch": 1784073600000,
        "endEpoch": 1784678400000,
        "source": "all",
    },
)
section = response.json()

const params = new URLSearchParams({
  startEpoch: "1784073600000",
  endEpoch: "1784678400000",
  source: "all",
});

const response = await fetch(
  `https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public?${params.toString()}`,
  {
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const section = await response.json();

{
  "id": "escalations",
  "title": "Escalations",
  "value": 223,
  "trend": "down",
  "series": [
    {
      "date": "2026-07-28",
      "value": 12
    }
  ]
}

GET

bots

{id}

hc-analytics

{section}

public

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public?startEpoch=1784073600000&endEpoch=1784678400000&source=all' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

response = requests.get(
    "https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
    params={
        "startEpoch": 1784073600000,
        "endEpoch": 1784678400000,
        "source": "all",
    },
)
section = response.json()

const params = new URLSearchParams({
  startEpoch: "1784073600000",
  endEpoch: "1784678400000",
  source: "all",
});

const response = await fetch(
  `https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public?${params.toString()}`,
  {
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const section = await response.json();

{
  "id": "escalations",
  "title": "Escalations",
  "value": 223,
  "trend": "down",
  "series": [
    {
      "date": "2026-07-28",
      "value": 12
    }
  ]
}

Returns one section of the analytics summary for one agent. The accepted section values are summary, trends, knowledge, rules, and escalations. Use this route when you only need part of the analytics payload. Use Get agent analytics when you need the full summary object. For the analytics endpoint family, see Analytics.

Headers

string

required

Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs read scope.

Path parameters

string

required

Agent ID whose analytics you want to read. Use List agents to get the botId.

string

required

Analytics section to return. Accepted values are summary, trends, knowledge, rules, and escalations.

Query parameters

number

required

Start of the analytics window as a Unix epoch timestamp.

number

required

End of the analytics window as a Unix epoch timestamp.

string | string[]

Conversation source filter. Pass all to include all supported sources, or pass one or more source values accepted by Fini.

string | string[]

Optional channel filter.

string | string[]

Optional latest-status filter.

string | string[]

Optional latest-sentiment filter.

string | string[]

Optional knowledge subfolder IDs to filter by.

string | string[]

Optional tag IDs to filter by.

string | string[]

Optional rule IDs to filter by.

string | string[]

Optional escalation-reason tag IDs to filter by.

number | number[]

Optional CSAT ratings to filter by. Values must be integers from 1 through 5.

string

Optional timezone used for date grouping.

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public?startEpoch=1784073600000&endEpoch=1784678400000&source=all' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

response = requests.get(
    "https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
    params={
        "startEpoch": 1784073600000,
        "endEpoch": 1784678400000,
        "source": "all",
    },
)
section = response.json()

const params = new URLSearchParams({
  startEpoch: "1784073600000",
  endEpoch: "1784678400000",
  source: "all",
});

const response = await fetch(
  `https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/summary/public?${params.toString()}`,
  {
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const section = await response.json();

{
  "id": "escalations",
  "title": "Escalations",
  "value": 223,
  "trend": "down",
  "series": [
    {
      "date": "2026-07-28",
      "value": 12
    }
  ]
}

Response

Returns a partial analytics summary object for the requested section.

Section	Included fields
`summary`	Summary metrics, comparison metrics, summary cards, status breakdown, and usage by channel.
`trends`	Conversation-volume, resolution-rate, response-time, hourly-volume, and CSAT chart data.
`knowledge`	Knowledge usage data.
`rules`	Rule analytics data.
`escalations`	Escalation-reason data.

See Get agent analytics for the field-level analytics schema.

Errors

400 Bad Request

The path ID, section, or query parameters are invalid. startEpoch and endEpoch are required.

401 Unauthorized

The API key is missing, malformed, revoked, or invalid.

403 Forbidden

The API key does not include the read scope required for this route.

406 Not Acceptable

The agent belongs to a different workspace.

500 Internal Server Error

Fini failed while loading analytics.

⌘I

​Headers

​Path parameters

​Query parameters

​Response

​Errors

Headers

Path parameters

Query parameters

Response

Errors