Skip to main content
GET
/
beta
/
v2
/
enterprise
/
user-usage-analysis
curl -X GET "https://api.devin.ai/beta/v2/enterprise/user-usage-analysis?limit=10&skip=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "items": [
    {
      "user_id": "user_123",
      "email": "john.doe@example.com",
      "name": "John Doe",
      "last_7_days": {
        "average_acus_per_session": 15.5,
        "total_acus_consumed": 155.0,
        "sessions_started": 10,
        "searches_started": 25
      },
      "last_30_days": {
        "average_acus_per_session": 18.2,
        "total_acus_consumed": 728.0,
        "sessions_started": 40,
        "searches_started": 95
      },
      "lifetime": {
        "average_acus_per_session": 20.5,
        "total_acus_consumed": 4100.0,
        "sessions_started": 200,
        "searches_started": 450
      }
    },
    {
      "user_id": "user_456",
      "email": "jane.smith@example.com",
      "name": "Jane Smith",
      "last_7_days": {
        "average_acus_per_session": 12.0,
        "total_acus_consumed": 60.0,
        "sessions_started": 5,
        "searches_started": 12
      },
      "last_30_days": {
        "average_acus_per_session": 14.5,
        "total_acus_consumed": 435.0,
        "sessions_started": 30,
        "searches_started": 68
      },
      "lifetime": {
        "average_acus_per_session": 16.8,
        "total_acus_consumed": 2520.0,
        "sessions_started": 150,
        "searches_started": 340
      }
    }
  ],
  "total": 45,
  "skip": 0,
  "limit": 10,
  "has_more": true,
  "next_cursor": 10
}
Beta Endpoint - This endpoint is currently in beta and may change. While we strive to maintain backward compatibility, the API structure and response format may be updated as we improve the feature.
This endpoint retrieves detailed usage analytics for all users in your enterprise, including ACU consumption patterns, session counts, and search activity across different time periods (last 7 days, last 30 days, and lifetime).

​
Query Parameters

​
skip
integer
default:"0"
Number of items to skip for pagination (minimum: 0)
​
limit
integer
default:"100"
Maximum number of items to return (minimum: 1, maximum: 1000)

​
Response

​
items
array
Array of user usage analysis objects
​
total
integer
Total number of users in the enterprise
​
skip
integer
Number of items skipped
​
limit
integer
Maximum number of items per page
​
has_more
boolean
Whether more items are available
​
next_cursor
integer
Cursor for the next page (if applicable)
curl -X GET "https://api.devin.ai/beta/v2/enterprise/user-usage-analysis?limit=10&skip=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "items": [
    {
      "user_id": "user_123",
      "email": "john.doe@example.com",
      "name": "John Doe",
      "last_7_days": {
        "average_acus_per_session": 15.5,
        "total_acus_consumed": 155.0,
        "sessions_started": 10,
        "searches_started": 25
      },
      "last_30_days": {
        "average_acus_per_session": 18.2,
        "total_acus_consumed": 728.0,
        "sessions_started": 40,
        "searches_started": 95
      },
      "lifetime": {
        "average_acus_per_session": 20.5,
        "total_acus_consumed": 4100.0,
        "sessions_started": 200,
        "searches_started": 450
      }
    },
    {
      "user_id": "user_456",
      "email": "jane.smith@example.com",
      "name": "Jane Smith",
      "last_7_days": {
        "average_acus_per_session": 12.0,
        "total_acus_consumed": 60.0,
        "sessions_started": 5,
        "searches_started": 12
      },
      "last_30_days": {
        "average_acus_per_session": 14.5,
        "total_acus_consumed": 435.0,
        "sessions_started": 30,
        "searches_started": 68
      },
      "lifetime": {
        "average_acus_per_session": 16.8,
        "total_acus_consumed": 2520.0,
        "sessions_started": 150,
        "searches_started": 340
      }
    }
  ],
  "total": 45,
  "skip": 0,
  "limit": 10,
  "has_more": true,
  "next_cursor": 10
}