Agent API/Analytics

Daily Conversation Trend

Returns a day-by-day breakdown of conversations for the requested period. Every calendar day in the range is included — days with no activity return zeros. Useful for building charts or automating periodic reports.

GET

https://agent.askhandle.com/api/v1/public/analytics/conversations/daily

Requires X-API-Key — Your agent API key (pk_live_...)

Request

Headers

X-API-Key

stringrequired

Your agent API key (pk_live_...)

Query Parameters

month

string

Calendar month in YYYY-MM format (e.g. "2026-03"). Preferred over start/end.

start

string

Start date ISO string. Requires end.

end

string

End date ISO string. Requires start.

Response

Success 200

JSON

{
  "workflow": {
    "id": "wf_xyz789",
    "name": "Customer Support Bot"
  },
  "range": {
    "startDate": "2026-03-01",
    "endDate": "2026-03-31",
    "month": "March 2026"
  },
  "totals": {
    "conversations": 142,
    "messages": 1087,
    "completed": 97,
    "timeout": 23
  },
  "daily": [
    {
      "date": "2026-03-01",
      "conversations": 5,
      "messages": 38,
      "completed": 3,
      "timeout": 1
    },
    {
      "date": "2026-03-02",
      "conversations": 0,
      "messages": 0,
      "completed": 0,
      "timeout": 0
    },
    {
      "date": "2026-03-03",
      "conversations": 8,
      "messages": 61,
      "completed": 6,
      "timeout": 1
    }
  ]
}

Errors

401

API key missing or invalid

Error

{
  "error": "Missing API key. Include X-API-Key header."
}

Code examples

const res = await fetch(
  'https://agent.askhandle.com/api/v1/public/analytics/conversations/daily?month=2026-03',
  { headers: { 'X-API-Key': 'pk_live_your_api_key_here' } }
);
const { daily, totals } = await res.json();
console.log('Total this month:', totals.conversations);
daily.forEach(d => {
  if (d.conversations > 0) {
    console.log(d.date, '—', d.conversations, 'conversations');
  }
});

Response

Success 200

JSON

{
  "workflow": {
    "id": "wf_xyz789",
    "name": "Customer Support Bot"
  },
  "range": {
    "startDate": "2026-03-01",
    "endDate": "2026-03-31",
    "month": "March 2026"
  },
  "totals": {
    "conversations": 142,
    "messages": 1087,
    "completed": 97,
    "timeout": 23
  },
  "daily": [
    {
      "date": "2026-03-01",
      "conversations": 5,
      "messages": 38,
      "completed": 3,
      "timeout": 1
    },
    {
      "date": "2026-03-02",
      "conversations": 0,
      "messages": 0,
      "completed": 0,
      "timeout": 0
    },
    {
      "date": "2026-03-03",
      "conversations": 8,
      "messages": 61,
      "completed": 6,
      "timeout": 1
    }
  ]
}

Errors

401

API key missing or invalid

Error

{
  "error": "Missing API key. Include X-API-Key header."
}

const res = await fetch( 'https://agent.askhandle.com/api/v1/public/analytics/conversations/daily?month=2026-03', { headers: { 'X-API-Key': 'pk_live_your_api_key_here' } } ); const { daily, totals } = await res.json(); console.log('Total this month:', totals.conversations); daily.forEach(d => { if (d.conversations > 0) { console.log(d.date, '—', d.conversations, 'conversations'); } });