Usage Metrics API - Organizations

Programmatic access to usage metrics across an organization

The Usage API (released with 5.18.0) provides programmatic access to usage metrics across an organization. It complements existing enterprise reporting options—UI-based usage reports and CSV exports—by enabling integration into internal dashboards and tools via API.

The Usage API is available to all Enterprise customers on both Enterprise SaaS (console.tabnine.com) and Private Installations.

The APIs return JSON with parameter details and example responses.

List of Implemented APIs

APIs return JSON with parameter details and example responses:

Organization-Level Info APIs and Usage APIs

1. GET current organization ID and high-level settings

2. GET list of teams for given organization

3. GET license info

4. GET account utilization info

5. GET account permissions info

6. GET organization-level usage

Organization

Get Current Org ID (and High-Level Settings)

Get current organization ID and high-level settings

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response with organization structure.

application/json

publicKeystringOptional

Public key in PEM format.

samlEnabledbooleanOptional

smtpConfiguredbooleanOptional

usernamePasswordEnabledbooleanOptional

namestringRequired

domainsstring[]Optional

planTypestringOptional

idstringRequired

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/organization

HTTPcURLJavaScriptPython

GET /api/v1/organization HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "publicKey": "-----BEGIN PUBLIC KEY-----\nMIICIXXXXXXAAQ==\n-----END PUBLIC KEY-----\n",
  "samlEnabled": false,
  "smtpConfigured": true,
  "usernamePasswordEnabled": true,
  "name": "Yagel",
  "domains": [
    "tabnine.com"
  ],
  "planType": "Enterprise",
  "id": "9a3895ca-1c27-4231-8978-85ae00267d02"
}

Get List of Teams

Get list of teams for the given organization

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

offsetintegerOptional

Skips a number of items before starting to return results.

Default: 0

limitintegerOptional

Maximum number of items to return.

Default: 0

Responses

200

Successful response with list of teams.

application/json

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/organization/teams

HTTPcURLJavaScriptPython

GET /api/v1/organization/teams HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "text",
      "name": "text",
      "usersCount": 1,
      "isDefaultTeam": true
    }
  ],
  "meta": {
    "count": 1,
    "total": 1,
    "next": {
      "limit": 1,
      "offset": 1
    }
  }
}

Get Account Utilization Info

Get account utilization info (monthly)

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestringOptional

Start date for showing utilization (YYYY-MM). Default: last 12 months.

Example: 2025-01Pattern: ^\d{4}-\d{2}$

Responses

200

Successful response with monthly utilization array.

application/json

yearinteger · min: 1970Required

monthinteger · max: 11Required

Zero-based month (0=January, 11=December).

registeredintegerRequired

deactivatedintegerRequired

activeintegerRequired

pendingintegerRequired

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/organization/account-utilizations

HTTPcURLJavaScriptPython

GET /api/v1/organization/account-utilizations HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "year": 1,
    "month": 1,
    "registered": 1,
    "deactivated": 1,
    "active": 1,
    "pending": 1
  }
]

Get Organization-Level Usage

Get organization-level usage

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

organizationIdstringRequired

The unique identifier of the organization

fromstring · date-timeRequired

Filter usage data from this date (ISO 8601).

tostring · date-timeRequired

Filter usage data until this date (ISO 8601).

granularitystring · enumRequired

Time resolution at which usage data is aggregated and returned.

Possible values:

Responses

200

Successful response with organization usage data.

application/json

organizationIdstringRequired

fromstring · date-timeRequired

tostring · date-timeRequired

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/organization/usage

HTTPcURLJavaScriptPython

GET /api/v1/organization/usage?organizationId=text&from=2026-03-05T06%3A23%3A45.750Z&to=2026-03-05T06%3A23%3A45.750Z&granularity=all HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organizationId": "text",
  "from": "2026-03-05T06:23:45.750Z",
  "to": "2026-03-05T06:23:45.750Z",
  "usage": {
    "granularity": "all",
    "data": [
      {
        "from": "2026-03-05T06:23:45.750Z",
        "to": "2026-03-05T06:23:45.750Z",
        "activeUsers": 1,
        "productivityFactor": 1,
        "instruct": {
          "acceptedCount": 1
        },
        "codeCompletions": {
          "activeUsers": 1,
          "completions": 1,
          "charsCompleted": 1,
          "keystrokes": 1,
          "lines": 1,
          "automationFactor": 1
        },
        "chat": {
          "activeUsers": 1,
          "interactions": 1,
          "usefulChatInteractions": 1,
          "lines": 1,
          "charsCompleted": 1,
          "chatConsumptionRate": 1
        },
        "agent": {
          "activeUsers": 1,
          "interactions": 1,
          "linesAdded": 1,
          "linesAddedAccepted": 1,
          "linesRemoved": 1,
          "linesRemovedAccepted": 1
        }
      }
    ]
  }
}

Get Users Not Assigned to Teams

Get users who are not assigned to a team

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

offsetintegerRequired

Skips a number of items before starting to return results.

limitintegerRequired

Maximum number of items to return.

teamMemberbooleanRequired

Use false for users not assigned to a team.

Example: false

activebooleanRequired

Use true for registered users (false for deactivated users).

Example: true

Responses

200

Successful response with users.

application/json

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/organization/users

HTTPcURLJavaScriptPython

GET /api/v1/organization/users?offset=1&limit=1&teamMember=true&active=true HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "text",
      "username": "text",
      "email": "[email protected]",
      "role": "text",
      "verified": true,
      "deactivatedAt": "2026-03-05T06:23:45.750Z",
      "updatedAt": "2026-03-05T06:23:45.750Z"
    }
  ],
  "meta": {
    "count": 1,
    "total": 1,
    "next": {
      "limit": 1,
      "offset": 1
    }
  }
}