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

# Daily Usage Data

> Retrieve daily usage statistics for your organization



## OpenAPI

````yaml /api-reference/openapi-org.yaml post /v2/organization/daily-usage-data
openapi: 3.0.3
info:
  title: Firebender Organization API
  description: Organization usage analytics API
  version: 0.1.0
  contact:
    email: help@firebender.com
servers:
  - url: https://api.firebender.com
    description: Organization API
security:
  - apiKeyAuth: []
  - bearerAuth: []
paths:
  /v2/organization/daily-usage-data:
    post:
      summary: Daily Usage Data
      description: Retrieve daily usage statistics for your organization
      operationId: getDailyUsageData
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DailyUsageRequest'
      responses:
        '200':
          description: Usage data retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DailyUsageResponse'
        '400':
          description: Invalid request - bad date parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden - insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    DailyUsageRequest:
      type: object
      required:
        - startDate
        - endDate
      properties:
        startDate:
          type: integer
          format: int64
          description: Unix timestamp in milliseconds for the start date
          example: 1752227938831
        endDate:
          type: integer
          format: int64
          description: Unix timestamp in milliseconds for the end date
          example: 1752227938831
    DailyUsageResponse:
      type: object
      required:
        - data
        - period
      properties:
        data:
          type: array
          description: Array of daily usage records
          items:
            $ref: '#/components/schemas/DailyUsageRecord'
        period:
          type: object
          required:
            - startDate
            - endDate
          properties:
            startDate:
              type: integer
              format: int64
              description: Requested start date timestamp
              example: 1752227938831
            endDate:
              type: integer
              format: int64
              description: Requested end date timestamp
              example: 1752227938831
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message
          example: Invalid API key
    DailyUsageRecord:
      type: object
      properties:
        date:
          type: integer
          format: int64
          description: Unix timestamp for the day
          example: 1752192000000
        ideOpened:
          type: boolean
          description: Whether the IDE was opened that day
          example: true
        agentPrompts:
          type: integer
          description: Number of agent prompts sent
          example: 4
        agentAccepts:
          type: integer
          description: >-
            Number of agent suggestions accepted (file accepted, individual hunk
            accepted)
          example: 3
        agentFullAccepts:
          type: integer
          description: >-
            Number of full agent suggestions accepted (user accepted all changes
            at once)
          example: 1
        agentAcceptedLinesAdded:
          type: integer
          description: Lines added through agent accepts
          example: 134
        agentAcceptedLinesRemoved:
          type: integer
          description: Lines removed through agent accepts
          example: 37
        inlineEdits:
          type: integer
          description: Number of inline edits performed
          example: 0
        inlineEditAccepts:
          type: integer
          description: Number of inline edit accepts
          example: 0
        inlineAcceptedLinesAdded:
          type: integer
          description: Lines added through inline accepts
          example: 23
        inlineAcceptedLinesRemoved:
          type: integer
          description: Lines removed through inline accepts
          example: 12
        autocompleteAccepts:
          type: integer
          description: Number of autocomplete accepts
          example: 2
        autocompleteShown:
          type: integer
          description: Number of times autocomplete was shown
          example: 6
        autocompleteAcceptedCharactersAdded:
          type: integer
          description: Characters added through autocomplete
          example: 237
        autocompleteAcceptedCharactersRemoved:
          type: integer
          description: Characters removed through autocomplete
          example: 0
        email:
          type: string
          format: email
          description: User email address
          example: user1@firebender.com
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Organization API key. Create API Key
        [here](https://firebender.com/settings?tab=settings)
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Signed-in user authorization token for a user who belongs to the
        organization

````