---
title: "GET /v1/agent-session-analytics/jobs"
method: GET
path: "/v1/agent-session-analytics/jobs"
tags: ["Agent Session Analytics"]
---

# GET /v1/agent-session-analytics/jobs

`GET /v1/agent-session-analytics/jobs`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/agent-session-analytics/jobs`
- Auth: one of:
  - API key in header `GREPR-API-KEY`
  - OpenID Connect (`https://grepr-prod.us.auth0.com/.well-known/openid-configuration`)

## Query parameters

- `datasetId` string
- `offset` integer
- `limit` integer

## Response `200`

Analytics runs retrieved

- AgentSessionAnalyticsPage
  - `items` AgentSessionAnalyticsJob[]
    - `analysisVersion` string
    - `analyzedSessionCount` integer
    - `artifactByteSize` integer
    - `clusteringAlgorithmVersion` string
    - `completedAt` string, date-time
    - `createdAt` string, date-time
    - `dashboardSummary` AgentAnalyticsDashboardSummary
      - `dataQuality` DataQuality
        - `embeddingFailures` integer
        - `incompleteContentSessions` integer
        - `labelFailures` integer
        - `metadataOnlyEvents` integer
        - `missingUsageSessions` integer
        - `truncatedEvents` integer
        - `warnings` integer
      - `emitters` Breakdown[]
        - `cacheReadTokens` integer
        - `cacheWriteTokens` integer
        - `calls` integer
        - `callsWithUsage` integer
        - `costReportingComplete` boolean
        - `inputTokens` integer
        - `name` string
        - `outputTokens` integer
        - `reasoningTokens` integer
        - `reportedCostUsd` number, double
        - `sessions` integer
      - `intentToolMatrix` MatrixCell[]
        - `intent` string
        - `operation` string
        - `sessionsUsing` integer
      - `intentUsage` Breakdown[]
        - `cacheReadTokens` integer
        - `cacheWriteTokens` integer
        - `calls` integer
        - `callsWithUsage` integer
        - `costReportingComplete` boolean
        - `inputTokens` integer
        - `name` string
        - `outputTokens` integer
        - `reasoningTokens` integer
        - `reportedCostUsd` number, double
        - `sessions` integer
      - `models` Breakdown[]
        - `cacheReadTokens` integer
        - `cacheWriteTokens` integer
        - `calls` integer
        - `callsWithUsage` integer
        - `costReportingComplete` boolean
        - `inputTokens` integer
        - `name` string
        - `outputTokens` integer
        - `reasoningTokens` integer
        - `reportedCostUsd` number, double
        - `sessions` integer
      - `topIntents` Intent[]
        - `description` string
        - `label` string
        - `miscellaneous` boolean
        - `percentage` number, double
        - `sessions` integer
      - `topTools` Tool[]
        - `calls` integer
        - `costReportingComplete` boolean
        - `durationMs` integer
        - `errors` integer
        - `operation` string
        - `reportedCostUsd` number, double
        - `resultBytes` integer
        - `sessionsUsing` integer
      - `totals` Totals
        - `analyzedSessions` integer
        - `cacheReadTokens` integer
        - `cacheWriteTokens` integer
        - `costReportingComplete` boolean
        - `exportedSessions` integer
        - `inputTokens` integer
        - `matchingSessions` integer
        - `miscellaneousSessions` integer
        - `modelCalls` integer
        - `namedGroupSessions` integer
        - `outputTokens` integer
        - `reasoningTokens` integer
        - `reportedCostUsd` number, double
        - `sessionDurationMs` integer
        - `toolCalls` integer
        - `toolDurationMs` integer
        - `toolErrors` integer
        - `toolResultBytes` integer
    - `datasetId` string
    - `downloadAvailable` boolean
    - `embeddingDimensions` integer
    - `embeddingModel` string
    - `exportedSessionCount` integer
    - `failureReason` string
    - `jobId` string
    - `jobState` 'CREATED' | 'PENDING' | 'INFRA_UPDATE' | 'INFRA_UPDATE_WAIT' | 'VERIFYING' | 'WAITING' | 'RUNNING' | 'STOPPED' | 'FINISHED' | 'FAILED' | 'CANCELLED' | 'DELETED' | 'UPDATING' | 'STARTING' | 'RESTARTING' | 'STOPPING' | 'ROLLING_BACK' | 'DELETING'
    - `labelModel` string
    - `matchingSessionCount` integer
    - `miscellaneousSessionCount` integer
    - `namedGroupCount` integer
    - `request` CreateAgentSessionAnalyticsJob
      - `datasetId` string, required
      - `end` string, date-time, required
      - `maximumNamedGroups` integer
      - `modelIntegrationId` string, required
      - `query` union, required: Predicate applied to rows before analytical aggregation.
        - object
          - `queries` EventPredicate[], required: List of predicates that must all match for this predicate to match.
          - `type` 'and-predicate', required: A predicate that matches when every child predicate matches.
          - `query` string
        - object
          - `query` string, required: The datadog query used by the predicate. See https://docs.datadoghq.com/tracing/trace_explorer/query_syntax
          - `type` 'datadog-query', required: A predicate that checks if an event matches a datadog query.
        - object
          - `filterTags` object: The set of tags to query for. If unspecified, all tags are queried.
          - `metricNames` string[], required: The names of the metrics to query. Must not be empty.
          - `query` string, required
          - `type` 'metric-predicate', required: A predicate that checks if an event matches a metrics query.
        - object
          - `query` string, required: The New Relic query used by the predicate. See https://docs.newrelic.com/docs/logs/ui-data/query-syntax-logs/
          - `type` 'newrelic-query', required: A predicate that checks if an event matches a New Relic query.
        - object
          - `query` string, required: The Nrql query used by the predicate. See https://docs.newrelic.com/docs/nrql
          - `strict` boolean: Whether the query should be parsed in strict mode.
          - `type` 'nrql-query', required: A predicate that checks if an event matches an NRQL query.
      - `sessionCap` integer
      - `start` string, date-time, required
    - `resultWasCapped` boolean
    - `state` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
    - `warningCount` integer
  - `limit` integer
  - `offset` integer
  - `total` integer

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)