Usage Metrics API

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.

OpenAPI reference

Organization

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 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 (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

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-02-18T20%3A44%3A17.090Z&to=2026-02-18T20%3A44%3A17.090Z&granularity=all HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organizationId": "text",
  "from": "2026-02-18T20:44:17.090Z",
  "to": "2026-02-18T20:44:17.090Z",
  "usage": {
    "granularity": "all",
    "data": [
      {
        "from": "2026-02-18T20:44:17.090Z",
        "to": "2026-02-18T20:44:17.090Z",
        "activeUsers": 1,
        "productivityFactor": 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
        }
      }
    ]
  }
}

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-02-18T20:44:17.090Z",
      "updatedAt": "2026-02-18T20:44:17.090Z"
    }
  ],
  "meta": {
    "count": 1,
    "total": 1,
    "next": {
      "limit": 1,
      "offset": 1
    }
  }
}

License & permissions

Get license info

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response with license info.

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/license

HTTPcURLJavaScriptPython

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

{
  "license": {
    "exp": 1,
    "iat": 1,
    "seats": 1,
    "seatsCap": 1,
    "audience": "text",
    "features": [
      "text"
    ],
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
}

Get account permissions info (list of account admins)

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

rolestringRequiredExample: Admin

Responses

200

Successful response with users for the given role.

application/json

usernamestringRequired

organizationIdstringRequired

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/instance/permissions

HTTPcURLJavaScriptPython

GET /api/v1/instance/permissions?role=text HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "username": "text",
    "organizationId": "text"
  }
]

Team-level

Get users of a given team

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

teamIdstringRequired

Query parameters

offsetintegerRequired

Skips a number of items before starting to return results.

limitintegerRequired

Maximum number of items to return.

Responses

200

Successful response with users for the team.

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/team/{teamId}/users

HTTPcURLJavaScriptPython

GET /api/v1/team/{teamId}/users?offset=1&limit=1 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-02-18T20:44:17.090Z",
      "updatedAt": "2026-02-18T20:44:17.090Z"
    }
  ],
  "meta": {
    "count": 1,
    "total": 1,
    "next": {
      "limit": 1,
      "offset": 1
    }
  }
}

Get current team utilization info

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

teamIdstringRequired

Responses

200

Successful response with team utilization counts.

application/json

registeredintegerRequired

deactivatedintegerRequired

invitedintegerRequired

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/team/account-utilizations

HTTPcURLJavaScriptPython

GET /api/v1/team/account-utilizations?teamId=text HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "registered": 1,
  "deactivated": 1,
  "invited": 1
}

Get team name

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

teamIdstringRequired

Responses

200

Successful response with team info.

application/json

idstringRequired

namestringRequired

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/team/{teamId}

HTTPcURLJavaScriptPython

GET /api/v1/team/{teamId} HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text"
}

Team-level usage

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

organizationIdstringRequired

teamIdstringRequired

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 team usage data.

application/json

organizationIdstringRequired

teamIdstringRequired

fromstring · date-timeRequired

tostring · date-timeRequired

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

403

Forbidden – User lacks permission.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/team/usage

HTTPcURLJavaScriptPython

GET /api/v1/team/usage?organizationId=text&teamId=text&from=2026-02-18T20%3A44%3A17.090Z&to=2026-02-18T20%3A44%3A17.090Z&granularity=all HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organizationId": "text",
  "teamId": "text",
  "from": "2026-02-18T20:44:17.090Z",
  "to": "2026-02-18T20:44:17.090Z",
  "usage": {
    "granularity": "all",
    "data": [
      {
        "from": "2026-02-18T20:44:17.090Z",
        "to": "2026-02-18T20:44:17.090Z",
        "activeUsers": 1,
        "productivityFactor": 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
        }
      }
    ]
  }
}

User-level

User-level info

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

user_idstringRequired

Responses

200

Successful response with user info.

application/json

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

403

Forbidden – User lacks permission.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/user/{user_id}

HTTPcURLJavaScriptPython

GET /api/v1/user/{user_id} HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "user": {
    "organization_id": "text",
    "user_id": "text",
    "email": "[email protected]",
    "role": "text",
    "createdAt": "2026-02-18T20:44:17.090Z",
    "updatedAt": "2026-02-18T20:44:17.090Z"
  },
  "teams": {
    "team_id": "text",
    "team_name": "text"
  }
}

User-level usage

GET

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

organizationIdstringRequired

userIdstringRequired

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 user usage data.

application/json

organizationIdstringRequired

userIdstringRequired

fromstring · date-timeRequired

tostring · date-timeRequired

400

Bad Request – Invalid or missing parameters.

401

Unauthorized – Invalid token.

403

Forbidden – User lacks permission.

404

Not Found – Resource not found.

500

Internal Server Error – Unexpected server error.

GET

/api/v1/user/usage

HTTPcURLJavaScriptPython

GET /api/v1/user/usage?organizationId=text&userId=text&from=2026-02-18T20%3A44%3A17.090Z&to=2026-02-18T20%3A44%3A17.090Z&granularity=all HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organizationId": "text",
  "userId": "text",
  "from": "2026-02-18T20:44:17.090Z",
  "to": "2026-02-18T20:44:17.090Z",
  "usage": {
    "granularity": "all",
    "data": [
      {
        "from": "2026-02-18T20:44:17.090Z",
        "to": "2026-02-18T20:44:17.090Z",
        "activeUsers": 1,
        "productivityFactor": 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
        }
      }
    ]
  }
}

API Categories

The Usage API can retrieve the following information:

• Organization & Teams

  • Get organization and team IDs

  • List organization teams

  • List users from each team

• Usage Metrics

  • Active users

  • Account utilization

  • Productivity factor

  • Automation factor

  • Usage volumes for:

    • Code Completions

    • Chat Interactions

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

Team-Level Info APIs

1. Get users of a given team

2. Get users that aren't assigned to a team

3. Get current utilization info

4. Get team name

5. Team Level Usage API