> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Analytics Detailed Usage By User

> Retrieves usage data for a specific user.



## OpenAPI

````yaml get /analytics/detail-usage-user
openapi: 3.0.1
info:
  title: Embedded 2025-09
  version: '5.0'
servers:
  - url: https://production.runalloy.com
security: []
paths:
  /analytics/detail-usage-user:
    get:
      summary: Get Analytics Detailed Usage By User
      description: Retrieves usage data for a specific user.
      operationId: get-detail-usage-user
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            default: bearer YOUR_API_KEY
        - $ref: '#/components/parameters/xApiVersion'
        - name: userId
          in: query
          required: true
          description: The ID of the user.
          schema:
            type: string
            example: y66wqtzdeu94q5xawwjxc
        - name: timePeriod
          in: query
          required: false
          description: The time period for usage data.
          schema:
            type: string
            example: 7-days
            enum:
              - 7-days
              - 30-days
              - 3-months
              - current-billing-cycle
      responses:
        '200':
          description: Success (Example)
          content:
            application/json:
              examples:
                Result:
                  value:
                    data:
                      userName: demo@runalloy.com
                      userId: 659d28e18c35f07db18fcd8c
                      userCreatedDate: '2024-01-09T11:07:13.963Z'
                      isDeleted: false
                      startDate: '2023-12-27'
                      endDate: '2024-12-27'
                      totalActions: 0
                      data:
                        - month: Mar-24
                          userName: demo@runalloy.com
                          isDeleted: false
                          date: '2024-03-10'
                          userId: 659d28e18c35f07db18fcd8c
                          userCreatedDate: '2024-01-09'
                          apiActions: 0
                          count: 7
                          appActions: 7
                        - month: Jun-24
                          userName: demo@runalloy.com
                          isDeleted: false
                          date: '2024-06-30'
                          userId: 659d28e18c35f07db18fcd8c
                          userCreatedDate: '2024-01-09'
                          apiActions: 0
                          count: 2
                          appActions: 2
                        - month: Aug-24
                          userName: demo@runalloy.com
                          isDeleted: false
                          date: '2024-08-05'
                          userId: 659d28e18c35f07db18fcd8c
                          userCreatedDate: '2024-01-09'
                          apiActions: 0
                          count: 22
                          appActions: 22
                        - month: Sep-24
                          userName: demo@runalloy.com
                          isDeleted: false
                          date: '2024-09-29'
                          userId: 659d28e18c35f07db18fcd8c
                          userCreatedDate: '2024-01-09'
                          apiActions: 0
                          count: 2
                          appActions: 2
                      timePeriod: current-billing-cycle
      x-code-samples:
        - lang: cURL
          source: >
            curl -X GET
            "https://production.runalloy.com/analytics/detail-usage-user?userId={{userId}}"
            \
              -H "Authorization: bearer YOUR_API_KEY" \
              -H "x-api-version: 2025-09"
        - lang: Python
          source: |
            import requests

            url = "https://production.runalloy.com/analytics/detail-usage-user"
            params = {"userId": "{{userId}}"}
            headers = {
                "Authorization": "bearer YOUR_API_KEY",
                "x-api-version": "2025-09"
            }

            response = requests.get(url, params=params, headers=headers)
            print(response.json())
        - lang: JavaScript
          source: >
            const userId = "{{userId}}";

            const url =
            `https://production.runalloy.com/analytics/detail-usage-user?userId=${userId}`;


            fetch(url, {
              method: "GET",
              headers: {
                "Authorization": "bearer YOUR_API_KEY",
                "x-api-version": "2025-09"
              }
            })
              .then(response => response.json())
              .then(data => console.log(data))
              .catch(error => console.error("Error:", error));
components:
  parameters:
    xApiVersion:
      name: x-api-version
      in: header
      required: true
      description: The version of the API to use. The current API version is **2025-09**.
      schema:
        type: string
        default: 2025-09

````