{"info":{"_postman_id":"a4a2baf7-b87e-4252-ac12-a55856903bea","name":"ClearSense Reporting","description":"

Description

The ClearTrust Report API allows authorized customers to programmatically retrieve report data for their business.
This document describes two reporting endpoints used to fetch Threat reports breakdowns for a business over a date range:

Overview (aggregated for the full range)
\n
Datewise (daily breakdown inside the range)
\n

Base URL

https://{business_id}-rpt.cleartrust.app/api/v2/businesses/{business_id}/reports/overview?sdate={yyyy-mm-dd}&edate={yyyy-mm-dd}&dims={input_dimensions,output_dimensions}

Replace the following placeholders in the Base URL:

{business_id} — Your assigned Business ID. Must appear in both the subdomain and the URL path.
\n
{input_dimensions} — Parameters from s1 to s10. These correspond to the columns defined in your business's report template. The meaning of each s parameter varies per customer.
\n
You may request one or more, separated by commas.
\n
- Threat Name
  \n
- Threat Type
  \n
- Threat Category
  \n
\n
The dims parameter accepts a comma-separated combination of input dimensions and output dimensions.
\n

Authentication

All requests must include an Authorization header with a valid Bearer token.

\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Value
Authorization	Bearer {your_token}

Endpoints uses:

sdate — start date (inclusive)
\n
edate — end date (inclusive)
\n
Format: YYYY-M-D (as shown in your examples). Confirm with your integration whether zero-padded YYYY-MM-DD is also accepted.
\n

Endpoint 1: Reports Overview (Aggregated)

Purpose -

Returns the Type distribution aggregated across the entire date range for given dimensions for each shortcode.

Endpoint 2: Reports Datewise (Daily Breakdown)

Purpose -

Returns the daily Threat Type distribution for given dimensions for each shortcode for each date.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"30356706","collectionId":"a4a2baf7-b87e-4252-ac12-a55856903bea","publishedId":"2sBXitDnWb","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-13T07:40:50.000Z"},"item":[{"name":"EXAMPLE OVERVIEW REPORTS","id":"ed10274f-8a2f-400f-8334-f7ab35b24903","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer 16e6250a57b3c4733ce7fa0362708fd107d2d050","type":"text"}],"url":"https://adt-rpt.cleartrust.app/api/v2/businesses/400017/reports/overview?sdate=2026-4-12&edate=2026-4-15&dims=Threat%20Type","urlObject":{"protocol":"https","path":["api","v2","businesses","400017","reports","overview"],"host":["adt-rpt","cleartrust","app"],"query":[{"key":"sdate","value":"2026-4-12"},{"key":"edate","value":"2026-4-15"},{"key":"dims","value":"Threat%20Type"}],"variable":[]}},"response":[{"id":"5727bb79-648f-45a6-9135-982cdc29570f","name":"SUCCESS - Overview","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"16e6250a57b3c4733ce7fa0362708fd107d2d050","type":"text"}],"url":{"raw":"https://adt-rpt.cleartrust.app/api/v2/businesses/400017/reports/overview?sdate=2026-3-24&edate=2026-3-26&dims=Threat%20Type","protocol":"https","host":["adt-rpt","cleartrust","app"],"path":["api","v2","businesses","400017","reports","overview"],"query":[{"key":"sdate","value":"2026-3-24"},{"key":"edate","value":"2026-3-26"},{"key":"dims","value":"Threat%20Type"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Apr 2026 06:49:39 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"vary","value":"accept-encoding"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Authorization, Content-Type, X-Requested-With, cc-api-access-token, x-access-tokens"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9eb8881aaedb8826-MAA"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": {\n \"data\": {\n \"ctnp1COt5Kwe\": {\n \"High Risk\": 1091,\n \"Clean\": 3385,\n \"Low Risk\": 2643,\n \"Medium Risk\": 2093\n }\n },\n \"label\": {\n \"dim1\": \"shortcode\",\n \"dim2\": \"Threat Type\"\n },\n \"start_date\": \"2026-03-24\",\n \"end_date\": \"2026-03-26\",\n \"totalcount\": 9212,\n \"totalriskcount\": 5827,\n \"hashquery\": \"0c7e547a0b27c230f0a58d926efccc40\",\n \"total_items\": 1\n }\n}"},{"id":"847aa7b6-629c-48d9-ad5b-8c4e6889ae22","name":"SUCCESS - Combination dims","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"16e6250a57b3c4733ce7fa0362708fd107d2d050","type":"text"}],"url":{"raw":"https://adt-rpt.cleartrust.app/api/v2/businesses/400017/reports/overview?sdate=2026-3-24&edate=2026-3-26&dims=Threat%20Type,Threat%20Name","protocol":"https","host":["adt-rpt","cleartrust","app"],"path":["api","v2","businesses","400017","reports","overview"],"query":[{"key":"sdate","value":"2026-3-24"},{"key":"edate","value":"2026-3-26"},{"key":"dims","value":"Threat%20Type,Threat%20Name"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Apr 2026 06:49:39 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"vary","value":"accept-encoding"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Authorization, Content-Type, X-Requested-With, cc-api-access-token, x-access-tokens"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9eb8881aaedb8826-MAA"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": {\n \"data\": {\n \"ctnp1COt5Kwe\": {\n \"High Risk\": 1091,\n \"Clean\": 3385,\n \"Low Risk\": 2643,\n \"Medium Risk\": 2093\n }\n },\n \"label\": {\n \"dim1\": \"shortcode\",\n \"dim2\": \"Threat Type\"\n },\n \"start_date\": \"2026-03-24\",\n \"end_date\": \"2026-03-26\",\n \"totalcount\": 9212,\n \"totalriskcount\": 5827,\n \"hashquery\": \"0c7e547a0b27c230f0a58d926efccc40\",\n \"total_items\": 1\n }\n}"}],"_postman_id":"ed10274f-8a2f-400f-8334-f7ab35b24903"},{"name":"EXAMPLE DATEWISE REPORTS","id":"07643e0e-1540-4d32-8fe9-631b09e2a074","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer 16e6250a57b3c4733ce7fa0362708fd107d2d050","type":"text"}],"url":"https://adt-rpt.cleartrust.app/api/v2/businesses/400017/reports/datewise?sdate=2026-3-24&edate=2026-3-26&dims=Threat%20Type","urlObject":{"protocol":"https","path":["api","v2","businesses","400017","reports","datewise"],"host":["adt-rpt","cleartrust","app"],"query":[{"key":"sdate","value":"2026-3-24"},{"key":"edate","value":"2026-3-26"},{"key":"dims","value":"Threat%20Type"}],"variable":[]}},"response":[{"id":"a86a78d4-3cef-4b9e-9f76-fb6e43a08020","name":"SUCCESS - Datewise","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"16e6250a57b3c4733ce7fa0362708fd107d2d050","type":"text"}],"url":{"raw":"https://adt-rpt.cleartrust.app/api/v2/businesses/400085/reports/datewise?sdate=2026-3-24&edate=2026-3-26&dims=Threat%20Type","protocol":"https","host":["adt-rpt","cleartrust","app"],"path":["api","v2","businesses","400085","reports","datewise"],"query":[{"key":"sdate","value":"2026-3-24"},{"key":"edate","value":"2026-3-26"},{"key":"dims","value":"Threat%20Type"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Apr 2026 06:52:04 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"vary","value":"accept-encoding"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Authorization, Content-Type, X-Requested-With, cc-api-access-token, x-access-tokens"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9eb88ba65cfc7f00-MAA"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": {\n \"data\": {\n \"2026-03-24\": {\n \"ctnp1COt5Kwe\": {\n \"High Risk\": 545,\n \"Clean\": 1392,\n \"Low Risk\": 1150,\n \"Medium Risk\": 845\n }\n },\n \"2026-03-25\": {\n \"ctnp1COt5Kwe\": {\n \"Low Risk\": 995,\n \"Medium Risk\": 820,\n \"High Risk\": 298,\n \"Clean\": 1284\n }\n },\n \"2026-03-26\": {\n \"ctnp1COt5Kwe\": {\n \"High Risk\": 248,\n \"Medium Risk\": 428,\n \"Clean\": 709,\n \"Low Risk\": 498\n }\n }\n },\n \"label\": {\n \"dim1\": \"shortcode\",\n \"dim2\": \"Threat Type\"\n },\n \"start_date\": \"2026-03-24\",\n \"end_date\": \"2026-03-26\",\n \"totalcount\": 1883,\n \"totalriskcount\": 5827,\n \"daywiseriskcount\": {\n \"2026-03-24\": 2540,\n \"2026-03-25\": 2113,\n \"2026-03-26\": 1174\n },\n \"hashquery\": \"0c7e547a0b27c230f0a58d926efccc40\",\n \"total_items\": 0\n }\n}"},{"id":"3550f0db-d7cb-414d-a0f7-108be73db5b3","name":"SUCCESS - Combination dims","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"16e6250a57b3c4733ce7fa0362708fd107d2d050","type":"text"}],"url":{"raw":"https://adt-rpt.cleartrust.app/api/v2/businesses/400085/reports/datewise?sdate=2026-3-24&edate=2026-3-26&dims=Threat%20Type","protocol":"https","host":["adt-rpt","cleartrust","app"],"path":["api","v2","businesses","400085","reports","datewise"],"query":[{"key":"sdate","value":"2026-3-24"},{"key":"edate","value":"2026-3-26"},{"key":"dims","value":"Threat%20Type"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Apr 2026 06:52:04 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"vary","value":"accept-encoding"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Authorization, Content-Type, X-Requested-With, cc-api-access-token, x-access-tokens"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9eb88ba65cfc7f00-MAA"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": {\n \"data\": {\n \"2026-03-24\": {\n \"ctnp1COt5Kwe\": {\n \"High Risk\": 545,\n \"Clean\": 1392,\n \"Low Risk\": 1150,\n \"Medium Risk\": 845\n }\n },\n \"2026-03-25\": {\n \"ctnp1COt5Kwe\": {\n \"Low Risk\": 995,\n \"Medium Risk\": 820,\n \"High Risk\": 298,\n \"Clean\": 1284\n }\n },\n \"2026-03-26\": {\n \"ctnp1COt5Kwe\": {\n \"High Risk\": 248,\n \"Medium Risk\": 428,\n \"Clean\": 709,\n \"Low Risk\": 498\n }\n }\n },\n \"label\": {\n \"dim1\": \"shortcode\",\n \"dim2\": \"Threat Type\"\n },\n \"start_date\": \"2026-03-24\",\n \"end_date\": \"2026-03-26\",\n \"totalcount\": 1883,\n \"totalriskcount\": 5827,\n \"daywiseriskcount\": {\n \"2026-03-24\": 2540,\n \"2026-03-25\": 2113,\n \"2026-03-26\": 1174\n },\n \"hashquery\": \"0c7e547a0b27c230f0a58d926efccc40\",\n \"total_items\": 0\n }\n}"}],"_postman_id":"07643e0e-1540-4d32-8fe9-631b09e2a074"}]}