API reference

Get the call report

Paginated, filterable list of outbound calls placed on the account.

POSThttps://nextgenpanelstaging.cloudshope.com/api/v1/outboundCallApis/getOutboundCallReport

Returns outbound call records, most recent first. search matches the report id (exact) or to_number / from_number / from_customer_number; filter narrows by date range, status or agent. Account-owner tokens see every call; agent tokens see only their own calls and their team's. recordsTotal is the number of rows matching the filters; recordsFiltered is the number of rows on this page.

A request body is optional — omit it (or any field) to get the first page with no filters.

Errors on this endpoint return { "success": false, "message": "…" } or { "status": …, "message": "…" }, not the standard problem shape.

Authentication

Send Authorization: Bearer <token>. Any valid API token for the account works.

Body parameters

NameTypeRequiredDescription
pageintegerNo1-based page number. Defaults to 1.
pageSizeintegerNoRows per page, capped at 100. Defaults to 10.
searchstringNoMatches report id, to_number or from_number.
filter.from_datestring · IST date/timeNoStart of the date range, e.g. 2026-09-01 00:00:00.
filter.till_datestring · IST date/timeNoEnd of the date range.
filter.statusstringNoComma-separated statuses to include.
filter.agent_idstringNoComma-separated agent ids to include.
filter.search_agent_idsstringNoComma-separated agent ids matched together with search.

Request

curl -X POST https://nextgenpanelstaging.cloudshope.com/api/v1/outboundCallApis/getOutboundCallReport \
  -H "Authorization: Bearer cs_live_9f2c…" \
  -H "Content-Type: application/json" \
  -d '{ "page": 1, "pageSize": 10, "filter": { "status": "ANSWER" } }'

Response

{
  "status": 200,
  "message": "success",
  "data": [
    {
      "id": 3301,
      "to_number": "9876543210",
      "status": "ANSWER",
      "from_number": "9800000000",
      "from_customer_number": null,
      "credit": 2,
      "duration": 34,
      "recording": 1,
      "link": "https://media.cloudshope.com/recordings/1/…wav",
      "created_at": "2026-09-08T09:20:41.000Z",
      "agent_id": 210,
      "agent_name": "Ravi Menon"
    }
  ],
  "Page": 1,
  "PageSize": 10,
  "recordsFiltered": 1,
  "recordsTotal": 1
}
200 — example response

Errors

StatusTypeWhen
500internal-errorSomething went wrong building the report.
401unauthorizedThe Authorization header is missing, malformed or the token is invalid or expired.
403forbiddenThe token is valid but the account is not allowed to perform this action.