Skip to main content
GET
/
v1
/
usage
cURL
curl --request GET \
  --url https://api.surnex.io/v1/usage \
  --header 'Authorization: Bearer <token>'
{
  "account_id": "0f1ce1f3-d6fc-4f1e-9d31-2ed5b1f6ef34",
  "range": {
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-02-01T00:00:00Z"
  },
  "provider": "dataforseo",
  "totals": {
    "calls_total": 12,
    "calls_by_operation": {
      "llm_mentions_aggregated_metrics_live": 5,
      "llm_mentions_top_domains_live": 4,
      "llm_mentions_search_live": 3
    },
    "avg_latency_ms": 190.5,
    "p95_latency_ms": 320,
    "http_status_counts": {
      "2xx": 11,
      "4xx": 1,
      "5xx": 0
    },
    "estimated_cost_usd": 0.19
  },
  "providers": {
    "dataforseo": {
      "calls_total": 12,
      "calls_by_operation": {
        "llm_mentions_aggregated_metrics_live": 5,
        "llm_mentions_top_domains_live": 4,
        "llm_mentions_search_live": 3
      },
      "avg_latency_ms": 190.5,
      "p95_latency_ms": 320,
      "http_status_counts": {
        "2xx": 11,
        "4xx": 1,
        "5xx": 0
      },
      "estimated_cost_usd": 0.19
    }
  },
  "snapshots": {
    "snapshots_total": 4,
    "snapshots_by_status": {
      "queued": 0,
      "running": 0,
      "complete": 3,
      "partial": 1,
      "failed": 0
    }
  }
}

Authorizations

Authorization
string
header
required

Authorization: Bearer sk_...

Query Parameters

project_id
string<uuid>
provider
string
Minimum string length: 1
from
string
Minimum string length: 1
to
string
Minimum string length: 1

Response

Usage + cost rollups

UsageRollupsResponse

account_id
string<uuid>
required
range
object
required
provider
string
required
totals
object
required
providers
object
required
snapshots
object
required