API v2 (Latest)

Version 2 (v2) of the Analytics API provides programmatic access to the AI usage data for your organization. Use it to retrieve metrics on AI adoption, activity, credits consumption, and other metrics that may be relevant across your teams and tools.

The following groups of endpoints are available:

AI adoption and usage: Number of users who have AI enabled and active, quota consumption over time, and data on principals who have hit their usage limits.
AI activity and impact: Suggested and accepted lines of code, as well as the number of invocations of AI tools.
AI credits consumption: AI credits consumption data grouped by AI tool, with an optional per-principal breakdown.
Code provenance: Lines of code generated by humans or AI tools and the time saved by AI, broken down by feature.
AI token usage: Number of tokens used over time, broken down by AI provider, with an optional per-model breakdown.
Principals: Search the principals (users and service accounts) you are authorized to view.
Groups: List the groups you are authorized to view, look them up by ID, or get the groups a set of users belong to.

API reference

AI adoption and usage

Get AI adoption metrics by date

/api/v2/adoption/users-adoption/group-by/date

Returns AI adoption and usage data for the specified date range, grouped by date. The returned data includes both metrics by day and total numbers for the date range. Filters for principalFilter, principalType, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/adoption/users-adoption/group-by/date
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "principalType": "user",
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/adoption/users-adoption/group-by/date" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "principalType": "user",
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "enabled": 15,
      "active": 15,
      "date": "2026-02-01"
    },
    {
      "enabled": 15,
      "active": 15,
      "date": "2026-03-01"
    }
  ],
  "totalEnabled": 15,
  "totalActive": 15
}
                        

Get quota consumption metrics by date

/api/v2/adoption/quota-consumption/group-by/date

Returns quota consumption data for the specified date range, grouped by date. The consumption information includes both built-in quota and top-up AI credits. Filters for tools, principalFilter, principalType, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/adoption/quota-consumption/group-by/date
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "tools": ["aia", "junie", "claude_agent"],
  "principalType": "user",
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/adoption/quota-consumption/group-by/date" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "tools": ["aia", "junie", "claude_agent"],
    "principalType": "user",
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "limit": 618.30,
      "topup": 673.09,
      "date": "2026-02-01"
    },
    {
      "limit": 561.88,
      "topup": 730.10,
      "date": "2026-03-01"
    }
  ],
  "totalLimit": 1180.18,
  "totalTopup": 1403.19
}
                        

Get quota consumption metrics by date and tool

/api/v2/adoption/quota-consumption/group-by/date-tool

Returns quota consumption data for the specified date range, grouped by date, with a per-AI tool breakdown for each period and per-AI tool totals for the entire date range. All filters are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/adoption/quota-consumption/group-by/date-tool
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "tools": ["aia", "junie", "claude_agent"],
  "principalType": "user",
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/adoption/quota-consumption/group-by/date-tool" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "tools": ["aia", "junie", "claude_agent"],
    "principalType": "user",
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "date": "2026-02-01",
      "tools": [
        {
          "tool": "aia",
          "consumption": 669.75
        },
        {
          "tool": "claude_agent",
          "consumption": 1538.91
        },
        {
          "tool": "junie",
          "consumption": 374.71
        }
      ]
    },
    {
      "date": "2026-03-01",
      "tools": [
        {
          "tool": "aia",
          "consumption": 723.18
        },
        {
          "tool": "claude_agent",
          "consumption": 1492.30
        },
        {
          "tool": "junie",
          "consumption": 401.05
        }
      ]
    }
  ],
  "totals": [
    {
      "tool": "aia",
      "consumption": 1392.93
    },
    {
      "tool": "claude_agent",
      "consumption": 3031.21
    },
    {
      "tool": "junie",
      "consumption": 775.76
    }
  ]
}
                        

Get limit hit metrics by date

/api/v2/adoption/limit-hits/group-by/date

Returns data about the number of principals who hit their AI credit limits in the specified date range, grouped by date. Filters for principalFilter and principalType are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/adoption/limit-hits/group-by/date
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-03-01",
  "toDate": "2026-04-20",
  "groupBy": "month",
  "principalType": "user"
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/adoption/limit-hits/group-by/date" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-03-01",
    "toDate": "2026-04-20",
    "groupBy": "month",
    "principalType": "user"
  }'
                        

Responses

{
  "items": [
    {
      "count": 15,
      "date": "2026-03-01"
    },
    {
      "count": 15,
      "date": "2026-04-01"
    }
  ],
  "maximumDaily": 15,
  "totalHits": 15
}
                        

Get limit hit metrics by principal and date

/api/v2/adoption/limit-hits/group-by/date-principal.cursor

Returns a cursor-paginated list of limit hits for each date and principal within a specified date range. When sortKey is date (default), sorting is done by date first, then by principal ID. When sortKey is name, sorting is done by principal name first, then by date. Filters for principalFilter and principalType are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/adoption/limit-hits/group-by/date-principal.cursor
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-03-01",
  "toDate": "2026-04-20",
  "principalType": "user",
  "sortKey": "date",
  "sortOrder": "desc",
  "limit": 50
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/adoption/limit-hits/group-by/date-principal.cursor" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-03-01",
    "toDate": "2026-04-20",
    "principalType": "user",
    "sortKey": "date",
    "sortOrder": "desc",
    "limit": 50
  }'
                        

Responses

{
  "items": [
    {
      "date": "2026-04-16",
      "principal": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "John Doe",
        "typeDiscriminator": "user",
        "email": "john.doe@jetbrains.com"
      }
    },
    {
      "date": "2026-04-05",
      "principal": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "Jane Smith",
        "typeDiscriminator": "user",
        "email": "jane.smith@jetbrains.com"
      }
    }
  ],
  "nextCursor": {
    "date": "2026-04-05",
    "principalId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "principalType": "user",
    "cursor": null
  }
}
                        

AI activity and impact

Get total AI activity and impact metrics

/api/v2/effectiveness/totals

Returns total AI activity and impact metrics for the specified date range. The metrics include suggested and accepted lines of code, as well as the number of invocations of AI tools. Filters for tools, principalFilter, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/effectiveness/totals
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "tools": ["aia", "junie", "claude_agent"],
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/effectiveness/totals" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "tools": ["aia", "junie", "claude_agent"],
    "ides": ["idea"]
  }'
                        

Responses

{
  "suggested": 152653,
  "accepted": 68422,
  "invocations": 19410
}
                        

Get AI activity and impact metrics by date

/api/v2/effectiveness/group-by/date

Returns AI activity and impact metrics for the specified date range, grouped by date. The metrics include suggested and accepted lines of code, as well as the number of invocations of AI tools. Filters for tools, principalFilter, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/effectiveness/group-by/date
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "tools": ["aia", "junie", "claude_agent"],
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/effectiveness/group-by/date" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "tools": ["aia", "junie", "claude_agent"],
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "date": "2026-02-01",
      "metrics": {
        "suggested": 9807,
        "accepted": 4094,
        "invocations": 1261
      }
    },
    {
      "date": "2026-03-01",
      "metrics": {
        "suggested": 142846,
        "accepted": 64328,
        "invocations": 18149
      }
    }
  ],
  "totals": {
    "suggested": 152653,
    "accepted": 68422,
    "invocations": 19410
  }
}
                        

Get AI activity and impact metrics by date and feature

/api/v2/effectiveness/group-by/date-feature

Returns AI activity and impact metrics for the specified date range, grouped by date and feature. The metrics include suggested and accepted lines of code, as well as the number of invocations of AI tools. Filters for tools, principalFilter, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/effectiveness/group-by/date-feature
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "tools": ["aia", "junie", "claude_agent"],
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/effectiveness/group-by/date-feature" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "tools": ["aia", "junie", "claude_agent"],
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "date": "2026-02-01",
      "tools": [
        {
          "feature": "aia",
          "metrics": {
            "suggested": 3434,
            "accepted": 1573,
            "invocations": 427
          }
        },
        {
          "feature": "claude_agent",
          "metrics": {
            "suggested": 3148,
            "accepted": 1137,
            "invocations": 419
          }
        },
        {
          "feature": "junie",
          "metrics": {
            "suggested": 3225,
            "accepted": 1384,
            "invocations": 415
          }
        }
      ]
    },
    {
      "date": "2026-03-01",
      "tools": [
        {
          "feature": "aia",
          "metrics": {
            "suggested": 49057,
            "accepted": 22248,
            "invocations": 6068
          }
        },
        {
          "feature": "claude_agent",
          "metrics": {
            "suggested": 46021,
            "accepted": 19984,
            "invocations": 6021
          }
        },
        {
          "feature": "junie",
          "metrics": {
            "suggested": 47768,
            "accepted": 22096,
            "invocations": 6060
          }
        }
      ]
    }
  ],
  "totals": [
    {
      "feature": "aia",
      "metrics": {
        "suggested": 52491,
        "accepted": 23821,
        "invocations": 6495
      }
    },
    {
      "feature": "claude_agent",
      "metrics": {
        "suggested": 49169,
        "accepted": 21121,
        "invocations": 6440
      }
    },
    {
      "feature": "junie",
      "metrics": {
        "suggested": 50993,
        "accepted": 23480,
        "invocations": 6475
      }
    }
  ]
}
                        

AI credits consumption

Get AI credits consumption by AI tool

/api/v2/credits-usage/group-by/tool

Returns AI credits consumption data for the specified date range, grouped by AI tool. The consumption information includes both built-in quota and top-up AI credits. Filters for tools, principalFilter, principalType, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/credits-usage/group-by/tool
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "tools": ["aia", "junie", "claude_agent"],
  "principalType": "user",
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/credits-usage/group-by/tool" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "tools": ["aia", "junie", "claude_agent"],
    "principalType": "user",
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "tool": "aia",
      "tariff": 288.47,
      "topup": 381.28
    },
    {
      "tool": "claude_agent",
      "tariff": 748.72,
      "topup": 790.19
    },
    {
      "tool": "junie",
      "tariff": 142.99,
      "topup": 231.72
    }
  ]
}
                        

Get AI credits consumption by principal with a per-tool breakdown

/api/v2/credits-usage/group-by/date-principal-tool.cursor

Returns a cursor-paginated list of AI credits consumption data per principal, with a per-AI tool breakdown for each principal. When sortKey is usage (default), sorting is done by total AI credits used first, then by principal ID and principal type. When sortKey is name, sorting is done by principal name. Filters for tools, principalFilter, principalType, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/credits-usage/group-by/date-principal-tool.cursor
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "tools": ["aia", "junie", "claude_agent"],
  "principalType": "user",
  "ides": ["idea"],
  "sortKey": "usage",
  "sortOrder": "desc",
  "limit": 50
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/credits-usage/group-by/date-principal-tool.cursor" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "tools": ["aia", "junie", "claude_agent"],
    "principalType": "user",
    "ides": ["idea"],
    "sortKey": "usage",
    "sortOrder": "desc",
    "limit": 50
  }'
                        

Responses

{
  "items": [
    {
      "principal": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Jane Smith",
        "typeDiscriminator": "user",
        "email": "jane.smith@jetbrains.com"
      },
      "items": [
        {
          "tool": "junie",
          "tariff": 15.75,
          "topup": 53.12
        },
        {
          "tool": "aia",
          "tariff": 44.08,
          "topup": 81.04
        },
        {
          "tool": "claude_agent",
          "tariff": 43.71,
          "topup": 59.61
        }
      ]
    },
    {
      "principal": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "John Doe",
        "typeDiscriminator": "user",
        "email": "john.doe@jetbrains.com"
      },
      "items": [
        {
          "tool": "aia",
          "tariff": 7.98,
          "topup": 19.48
        },
        {
          "tool": "claude_agent",
          "tariff": 67.66,
          "topup": 43.85
        },
        {
          "tool": "junie",
          "tariff": 66.30,
          "topup": 76.68
        }
      ]
    }
  ],
  "nextCursor": null
}
                        

Code provenance

Get code provenance metrics by date and feature

/api/v2/code-provenance/group-by/date-feature

Returns the number of lines of code generated by humans or AI tools, as well as the time saved by AI within the specified date range, grouped by date and feature. Filters for features, principalFilter, and ides are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/code-provenance/group-by/date-feature
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "features": ["human", "aia", "junie", "claude_agent"],
  "ides": ["idea"]
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/code-provenance/group-by/date-feature" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "features": ["human", "aia", "junie", "claude_agent"],
    "ides": ["idea"]
  }'
                        

Responses

{
  "items": [
    {
      "date": "2026-02-01",
      "features": [
        {
          "feature": "human",
          "loc": 0,
          "timeSavedS": 0
        },
        {
          "feature": "junie",
          "loc": 0,
          "timeSavedS": 0
        },
        {
          "feature": "claude_agent",
          "loc": 0,
          "timeSavedS": 0
        },
        {
          "feature": "aia",
          "loc": 0,
          "timeSavedS": 0
        }
      ]
    },
    {
      "date": "2026-03-01",
      "features": [
        {
          "feature": "human",
          "loc": 204648,
          "timeSavedS": 0
        },
        {
          "feature": "junie",
          "loc": 102954,
          "timeSavedS": 261729
        },
        {
          "feature": "claude_agent",
          "loc": 103215,
          "timeSavedS": 246206
        },
        {
          "feature": "aia",
          "loc": 103729,
          "timeSavedS": 243284
        }
      ]
    }
  ],
  "totals": [
    {
      "feature": "human",
      "loc": 204648,
      "timeSavedS": 0
    },
    {
      "feature": "junie",
      "loc": 102954,
      "timeSavedS": 261729
    },
    {
      "feature": "claude_agent",
      "loc": 103215,
      "timeSavedS": 246206
    },
    {
      "feature": "aia",
      "loc": 103729,
      "timeSavedS": 243284
    }
  ]
}
                        

AI token usage

Get token usage metrics by date and provider

/api/v2/token-usage/group-by/date-provider

Returns token usage data for the specified date range, grouped by date, with a per-provider breakdown for each period and per-provider totals for the entire date range. Filters for providers, principalFilter, and principalType are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/token-usage/group-by/date-provider
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "groupBy": "month",
  "providers": [{"type": "jetbrains"}],
  "principalType": "user"
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/token-usage/group-by/date-provider" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "groupBy": "month",
    "providers": [{"type": "jetbrains"}],
    "principalType": "user"
  }'
                        

Responses

{
  "items": [
    {
      "date": "2026-02-01",
      "providers": [
        {
          "provider": {
            "type": "jetbrains"
          },
          "tokens": 39572841
        }
      ]
    },
    {
      "date": "2026-03-01",
      "providers": [
        {
          "provider": {
            "type": "jetbrains"
          },
          "tokens": 42554342
        }
      ]
    }
  ],
  "totals": [
    {
      "provider": {
        "type": "jetbrains"
      },
      "tokens": 82127183,
      "trend": 7.53
    }
  ]
}
                        

Get token usage metrics by model

/api/v2/token-usage/group-by/model.cursor

Returns a cursor-paginated list of token usage per model, with the AI provider each model belongs to. Sorting is done by the sortKey (totalTokens by default). Filters for providers, principalFilter, and principalType are applied together (the API returns only records that match all criteria).

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/token-usage/group-by/model.cursor
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "fromDate": "2026-02-01",
  "toDate": "2026-03-31",
  "providers": [{"type": "jetbrains"}],
  "principalType": "user",
  "sortKey": "totalTokens",
  "sortOrder": "desc",
  "limit": 50
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/token-usage/group-by/model.cursor" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "fromDate": "2026-02-01",
    "toDate": "2026-03-31",
    "providers": [{"type": "jetbrains"}],
    "principalType": "user",
    "sortKey": "totalTokens",
    "sortOrder": "desc",
    "limit": 50
  }'
                        

Responses

{
  "items": [
    {
      "model": "anthropic-claude-4-6-sonnet",
      "provider": {
        "type": "jetbrains"
      },
      "tokens": 28215071
    },
    {
      "model": "openai-gpt-5-5",
      "provider": {
        "type": "jetbrains"
      },
      "tokens": 18297355
    },
    {
      "model": "anthropic-claude-4-6-opus",
      "provider": {
        "type": "jetbrains"
      },
      "tokens": 15286203
    }
  ],
  "nextCursor": null
}
                        

Principals

Search principals

/api/v2/principals/search

Returns a cursor-paginated list of principals (users and service accounts) you are authorized to view.

Unauthorized principals are excluded. Principals listed explicitly in the principalIds filter that you are not authorized to view are also excluded from the result. If no principals remain viewable after exclusion, the result is empty.

Multiple filters are combined to match all criteria.

Use the limit field in the request body to set the maximum number of results per page.

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/principals/search
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "principalType": "user",
  "nameOrEmailContains": "smith",
  "sortKey": "name",
  "sortOrder": "asc",
  "limit": 50
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/principals/search" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "principalType": "user",
    "nameOrEmailContains": "smith",
    "sortKey": "name",
    "sortOrder": "asc",
    "limit": 50
  }'
                        

Responses

{
  "items": [
    {
      "principalType": "user",
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
        "deleted": false,
        "type": "member",
        "name": "Jane Smith",
        "email": "jane.smith@jetbrains.com",
        "jbaAccountId": 12345678,
        "jbaLogin": "jane.smith@jetbrains.com"
      },
      "serviceAccount": null
    },
    {
      "principalType": "user",
      "user": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
        "deleted": false,
        "type": "member",
        "name": "John Smith",
        "email": "john.smith@jetbrains.com",
        "jbaAccountId": 23456789,
        "jbaLogin": "john.smith@jetbrains.com"
      },
      "serviceAccount": null
    }
  ],
  "nextCursor": null
}
                        

Groups

List groups

/api/v2/groups/list

Returns a cursor-paginated list of groups you are authorized to view. Groups you are not authorized to view are excluded from the results. Each page includes the number of results defined by limit. Results are always returned in ascending order.

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/groups/list
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "sortKey": "name",
  "limit": 50,
  "withMembersCount": true,
  "withParentGroups": true,
  "withHasChildren": true
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/groups/list" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "sortKey": "name",
    "limit": 50,
    "withMembersCount": true,
    "withParentGroups": true,
    "withHasChildren": true
  }'
                        

Responses

{
  "items": [
    {
      "id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
      "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
      "type": "local",
      "name": "Backend Engineers",
      "description": "Backend engineering team",
      "parentId": null,
      "membersCount": {
        "directMembersCount": 12,
        "transitiveMembersCount": 18
      },
      "parentGroups": [],
      "hasChildren": true
    },
    {
      "id": "d2e3f4a5-b6c7-8901-defa-234567890abc",
      "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
      "type": "local",
      "name": "Backend Engineers - Payments",
      "description": "Payments squad",
      "parentId": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
      "membersCount": {
        "directMembersCount": 6,
        "transitiveMembersCount": 6
      },
      "parentGroups": [
        {
          "id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
          "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
          "type": "local",
          "name": "Backend Engineers",
          "description": "Backend engineering team",
          "parentId": null
        }
      ],
      "hasChildren": false
    }
  ],
  "nextCursor": null
}
                        

Get groups by IDs

/api/v2/groups/by-ids

Returns the groups you are authorized to view. If the request includes groups you are not authorized to view, they are excluded from the result.

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/groups/by-ids
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "groupIds": [
    "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
    "d2e3f4a5-b6c7-8901-defa-234567890abc"
  ],
  "withMembersCount": true,
  "withParentGroups": true,
  "withHasChildren": true
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/groups/by-ids" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "groupIds": [
      "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
      "d2e3f4a5-b6c7-8901-defa-234567890abc"
    ],
    "withMembersCount": true,
    "withParentGroups": true,
    "withHasChildren": true
  }'
                        

Responses

{
  "items": [
    {
      "id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
      "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
      "type": "local",
      "name": "Backend Engineers",
      "description": "Backend engineering team",
      "parentId": null,
      "membersCount": {
        "directMembersCount": 12,
        "transitiveMembersCount": 18
      },
      "parentGroups": [],
      "hasChildren": true
    },
    {
      "id": "d2e3f4a5-b6c7-8901-defa-234567890abc",
      "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
      "type": "local",
      "name": "Backend Engineers - Payments",
      "description": "Payments squad",
      "parentId": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
      "membersCount": {
        "directMembersCount": 6,
        "transitiveMembersCount": 6
      },
      "parentGroups": [
        {
          "id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
          "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
          "type": "local",
          "name": "Backend Engineers",
          "description": "Backend engineering team",
          "parentId": null
        }
      ],
      "hasChildren": false
    }
  ]
}
                        

Get groups by user IDs

/api/v2/groups/by-user

Returns the groups that the specified users belong to, narrowed to the groups you are authorized to view. The result is returned per requested user.

Request parameters

POST https://api.jetbrains.cloud/metrics/api/v2/groups/by-user
Content-Type: application/json
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "userIds": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ],
  "transitive": true
}
                        

curl -X POST "https://api.jetbrains.cloud/metrics/api/v2/groups/by-user" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "userIds": [
      "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    ],
    "transitive": true
  }'
                        

Responses

{
  "items": [
    {
      "userId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "groups": [
        {
          "id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
          "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
          "type": "local",
          "name": "Backend Engineers",
          "description": "Backend engineering team",
          "parentId": null
        },
        {
          "id": "d2e3f4a5-b6c7-8901-defa-234567890abc",
          "orgId": "0fedcba9-8765-4321-fedc-ba9876543210",
          "type": "local",
          "name": "Backend Engineers - Payments",
          "description": "Payments squad",
          "parentId": "c1d2e3f4-a5b6-7890-cdef-1234567890ab"
        }
      ]
    }
  ]
}
                        

06 August 2026