Skip to main content
Usage Report›Get org-wide product usage totals.
TestMu AI
StatusCommunityBlog
Selenium Automation API
Automated Screenshots API
App Automation API (Real Devices)
Smart UI
Cypress Automation
User Management
Test Manager
HyperExecute
Accessibility Testing
Analytics
Performance Testing
Audit logs
Usage Report

Get org-wide product usage totals.

Returns aggregate test-usage totals broken down by product for the authenticated caller's organization over the requested date range and user-type population. Authentication: Basic Auth (username + Access Key). The calling account must be an org admin. For RBAC-enabled organizations the caller must hold the Admin role with analytics permissions. User type: account-user returns counts for human accounts; service-user returns counts for service/API accounts. Date range: Both from and to are required wall-clock datetimes (YYYY-MM-DD HH:MM:SS) interpreted in the specified timezone. Maximum span is 90 days. Smart UI note: Smart UI counts compared screenshots, not test executions. Its product key carries totalScreenshots only — no totalTests or totalDuration. Partial responses: When one product's data fetch fails the endpoint still returns 200 with the others populated. The failed product's counts are zero and metadata.partial is true — treat this as incomplete data, not a real zero.

GET
/usage-report/summary
Get org-wide product usage totals.
curl --request GET \
  --url "https://api.lambdatest.com/insights/api/v3/public/usage-report/summary" \
  --header "Authorization: Basic <encoded-value>"
{
  "status": "success",
  "data": {
    "metadata": {
      "type": "account-user",
      "totalUsers": 12,
      "from": "2026-06-23 00:00:00",
      "to": "2026-06-23 23:59:59",
      "timezone": "+00:00",
      "organization": {
        "id": "12345",
        "name": "Acme Corp"
      }
    },
    "products": {
      "automation": {
        "totalTests": 8450,
        "totalDuration": 312540
      },
      "app-automation": {
        "totalTests": 1200,
        "totalDuration": 98400
      },
      "hyperexecute": {
        "totalTests": 3100,
        "totalDuration": 210000
      },
      "realtime": {
        "totalTests": 540,
        "totalDuration": 43200
      },
      "realdevice": {
        "totalTests": 275,
        "totalDuration": 22000
      },
      "smartui": {
        "totalScreenshots": 6800
      }
    }
  }
}

Authorizations

Authorizationstringheaderrequired

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

typestringrequired

User population to include. account-user for human accounts; service-user for service/API accounts.

fromstringrequired

Range start as a wall-clock datetime: YYYY-MM-DD HH:MM:SS, interpreted in the timezone offset. Example: 2026-06-23 00:00:00.

tostringrequired

Range end as a wall-clock datetime: YYYY-MM-DD HH:MM:SS, interpreted in the timezone offset. Must be after from. Maximum span from from is 90 days.

timezonestring

UTC offset for interpreting from and to. Two formats accepted: - ISO offset ±HH:MM (e.g. +05:30, -08:00, +00:00). - Raw minutes from JS Date.getTimezoneOffset() (e.g. -330 for IST, 300 for US Eastern) — sign-inverted vs ISO. The API converts automatically. Note: + must be percent-encoded as %2B in URLs. A leading space is also accepted and normalized to +. Defaults to +00:00 (UTC) when omitted.

Response

application/json

Successful operation. Returns per-product usage totals. When `metadata.partial` is true one product group's fetch failed — treat those zero counts as unavailable, not real.

statusstring
dataobject
data.metadataobject
data.productsobject
Get org-wide product usage totals.
curl --request GET \
  --url "https://api.lambdatest.com/insights/api/v3/public/usage-report/summary" \
  --header "Authorization: Basic <encoded-value>"
{
  "status": "success",
  "data": {
    "metadata": {
      "type": "account-user",
      "totalUsers": 12,
      "from": "2026-06-23 00:00:00",
      "to": "2026-06-23 23:59:59",
      "timezone": "+00:00",
      "organization": {
        "id": "12345",
        "name": "Acme Corp"
      }
    },
    "products": {
      "automation": {
        "totalTests": 8450,
        "totalDuration": 312540
      },
      "app-automation": {
        "totalTests": 1200,
        "totalDuration": 98400
      },
      "hyperexecute": {
        "totalTests": 3100,
        "totalDuration": 210000
      },
      "realtime": {
        "totalTests": 540,
        "totalDuration": 43200
      },
      "realdevice": {
        "totalTests": 275,
        "totalDuration": 22000
      },
      "smartui": {
        "totalScreenshots": 6800
      }
    }
  }
}