Agent Usage API

This API returns aggregated usage analytics for your organization, broken down by AI tools (agent, chat, code completions, instruct) over a time range.

Tools Usage

This allows you to get information on tool status and usage in the Tabnine Agent.

Get organization usage by tools

get

Returns aggregated usage metrics for an organization over a given time range. Includes per-tool metrics for:

• agent

• chat

• codeCompletions

• instruct

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

organizationIdstring · uuidRequired

Organization identifier

Example: c19520dc-be63-4b43-a307-c96fccb68962

fromstring · date-timeRequired

Start of the reporting interval (inclusive), in ISO-8601 UTC.

Example: 2025-03-23T00:00:00Z

tostring · date-timeRequired

End of the reporting interval (exclusive or inclusive depending on backend semantics), in ISO-8601 UTC.

Example: 2026-02-23T00:00:00Z

granularitystring · enumRequired

Aggregation granularity for usage data.

Example: allPossible values:

Responses

200

Organization usage for the requested time range.

application/json

organizationIdstring · uuidRequired

fromstring · date-timeRequired

tostring · date-timeRequired

400

Invalid request (e.g., missing or invalid query parameters).

401

Authentication failed or missing Bearer token.

403

The caller is not authorized to access this organization’s usage data.

500

Server error retrieving usage data.

get

/api/v1/organization/usage

HTTPcURLJavaScriptPython

GET /api/v1/organization/usage?organizationId=c19520dc-be63-4b43-a307-c96fccb68962&from=2025-03-23T00%3A00%3A00Z&to=2026-02-23T00%3A00%3A00Z&granularity=all HTTP/1.1
Host: console.tabnine.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organizationId": "c19520dc-be63-4b43-a307-c96fccb68962",
  "from": "2025-03-23T00:00:00Z",
  "to": "2026-02-23T00:00:00Z",
  "usage": {
    "granularity": "all",
    "data": [
      {
        "from": "2026-02-23T00:00:00Z",
        "to": "2026-02-23T00:00:00Z",
        "activeUsers": 131,
        "instruct": {
          "acceptedCount": 16764
        },
        "productivityFactor": 0.433,
        "codeCompletions": {
          "activeUsers": 75,
          "completions": 7104,
          "charsCompleted": 617672,
          "keystrokes": 831400,
          "lines": 21848,
          "automationFactor": 0.426
        },
        "chat": {
          "activeUsers": 128,
          "interactions": 31336,
          "usefulChatInteractions": 17411,
          "lines": 38495,
          "charsCompleted": 16577,
          "chatConsumptionRate": 0.556
        },
        "agent": {
          "activeUsers": 103,
          "interactions": 11190,
          "linesAdded": 1092933,
          "linesAddedAccepted": 1080333,
          "linesRemoved": 76816,
          "linesRemovedAccepted": 75956
        }
      }
    ]
  }
}