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

# Consumo giornaliero

> Restituisce il consumo giornaliero per il ciclo di fatturazione in corso

Richiede una API key personale di un amministratore Enterprise.

Restituisce i dati relativi al consumo giornaliero di ACU per il tuo account Enterprise, suddivisi per data e organizzazione.

<div id="timezone-behavior">
  ## Comportamento del fuso orario
</div>

I cicli di fatturazione utilizzano **la mezzanotte PST (Pacific Standard Time)** come delimitazione della giornata, che corrisponde a **08:00:00 UTC**. Per allineare i dati di consumo a quelli mostrati nella dashboard di Devin, devi passare i timestamp con questo offset di fuso orario.

Ad esempio, per richiedere i dati di consumo per un ciclo di fatturazione dal 5 dicembre 2025 al 5 gennaio 2026:

```bash theme={null}
curl "https://api.devin.ai/v2/enterprise/consumption/daily?start_date=2025-12-05T08:00:00Z&end_date=2026-01-05T08:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Se fornisci date senza il suffisso `T08:00:00Z` (ad esempio `2025-12-05`), l'API utilizzerà la mezzanotte UTC, il che potrebbe comportare totali di consumo leggermente diversi rispetto alla dashboard.

<div id="filtering-by-organization">
  ## Filtraggio per organizzazione
</div>

Quando si filtra per `org_ids`, i risultati includeranno solo gli ACU delle sessioni Devin. Gli ACU consumati da Cascade e Terminal vengono omessi, poiché l'utilizzo di questi prodotti non è associato a nessuna organizzazione.


## OpenAPI

````yaml it/v2-openapi.yaml GET /v2/enterprise/consumption/daily
openapi: 3.1.0
info:
  description: API Devin v2 con Personal API Keys per gli amministratori Enterprise
  title: Devin API v2
  version: 2.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v2/enterprise/consumption/daily:
    get:
      tags:
        - consumption
      summary: Endpoint per il consumo giornaliero
      description: >-
        Restituisce il consumo giornaliero per il ciclo di fatturazione in
        corso.


        **Comportamento del fuso orario**: i cicli di fatturazione usano la
        mezzanotte PST (Pacific Standard Time)

        come delimitazione della giornata, che corrisponde alle 08:00:00 UTC.
        Per allineare i dati di consumo

        a quelli mostrati nella dashboard di Devin, fornisci dei timestamp con
        questo offset di fuso orario

        (ad esempio, `2025-12-05T08:00:00Z` per il 5 dicembre 2025 PST).
      operationId: daily_consumption_endpoint_v2_enterprise_consumption_daily_get
      parameters:
        - in: query
          name: start_date
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: Start Date
        - in: query
          name: end_date
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: End Date
        - in: query
          name: start
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: Start
        - in: query
          name: end
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: End
        - in: query
          name: org_ids
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            title: Org Ids
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConsumptionResponse'
          description: Risposta corretta
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Errore di validazione
components:
  schemas:
    ConsumptionResponse:
      properties:
        consumption_by_date:
          additionalProperties:
            type: number
          propertyNames:
            format: date
          title: Consumption By Date
          type: object
        consumption_by_org_id:
          additionalProperties:
            type: number
          title: Consumption By Org Id
          type: object
        consumption_by_user:
          anyOf:
            - additionalProperties:
                type: number
              type: object
            - type: 'null'
          title: Consumption By User
        total_acus:
          title: Total Acus
          type: number
      required:
        - total_acus
        - consumption_by_date
        - consumption_by_org_id
      title: ConsumptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    bearerAuth:
      description: API key personale (apk_user_*) riservata agli amministratori Enterprise
      scheme: bearer
      type: http

````