> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Consulter la consommation quotidienne de l’organisation
> Récupère la consommation quotidienne d’ACU pour une organisation spécifique.
Renvoie le total d’ACU et la consommation ventilée par date pour l’organisation.
**Comportement lié au fuseau horaire** : les cycles de facturation utilisent minuit, heure normale du Pacifique (PST),
comme limite de journée, ce qui correspond à 08:00:00 UTC. Pour faire correspondre les données
de consommation affichées dans le tableau de bord Devin, transmettez des timestamps Unix alignés sur ce
fuseau horaire (par exemple 1733385600 pour le 5 décembre 2025 à minuit PST).
L'API de consommation est réservée aux comptes disposant du plan **Enterprise**. Les organisations Teams et
self-serve reçoivent une réponse `403` ; il n'existe aucune option par compte que le support pourrait activer.
Répartition par produit
Chaque entrée de date de la réponse comporte un objet `acus_by_product` qui ventile la consommation totale d'ACU par produit : `devin`, `automation`, `cascade`, `terminal` et `review` (Devin Review). Vous pouvez ainsi voir comment la consommation se répartit entre les produits pour chaque jour. Lorsque les données par produit ne sont pas disponibles pour `devin`, `cascade` ou `terminal`, la valeur par défaut est `0.0`. Les champs `automation` et `review` valent `null` lorsque les données de consommation spécifiques à leur produit ne sont pas disponibles.
* `devin` : sessions lancées par une personne ou par un utilisateur de service, y compris les sessions d'analyse de code et d'astreinte.
* `automation` : sessions et étapes de code exécutées par des [automatisations](/fr/product-guides/automations). Avant l'ajout de ce champ, cette utilisation était comptabilisée sous `devin`.
Autorisations
Nécessite un [utilisateur de service](/fr/api-reference/v3/service-users/members-service-users) ou un [jeton d’accès personnel](/fr/api-reference/personal-access-tokens) avec l’autorisation `ViewAccountConsumption` au niveau Enterprise.
## OpenAPI
````yaml fr/v3-openapi.yaml GET /v3/enterprise/consumption/daily/organizations/{org_id}
openapi: 3.1.0
info:
description: API Devin v3 avec authentification par compte de service et RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/enterprise/consumption/daily/organizations/{org_id}:
get:
tags:
- consumption
summary: Consulter la consommation quotidienne de l’organisation
description: >-
Récupère la consommation quotidienne d’ACU pour une organisation
spécifique.
Renvoie le total d’ACU et la consommation ventilée par date pour
l’organisation.
**Comportement lié au fuseau horaire** : les cycles de facturation
utilisent minuit, heure normale du Pacifique (PST),
comme limite de journée, ce qui correspond à 08:00:00 UTC. Pour faire
correspondre les données
de consommation affichées dans le tableau de bord Devin, transmettez des
timestamps Unix alignés sur ce
fuseau horaire (par exemple 1733385600 pour le 5 décembre 2025 à minuit
PST).
operationId: >-
handle_get_org_consumption_daily_v3_enterprise_consumption_daily_organizations__org_id__get
parameters:
- description: "ID de l’organisation (préfixe\_: org-)"
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
- in: query
name: time_before
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time Before
- in: query
name: time_after
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time After
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ConsumptionResponse'
description: Réponse en cas de succès
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non authentifié
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Accès interdit
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non trouvé
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflit
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenu non traitable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Trop de requêtes
components:
schemas:
ConsumptionResponse:
properties:
consumption_by_date:
items:
$ref: '#/components/schemas/ConsumptionByDateResponse'
title: Consumption By Date
type: array
total_acus:
title: Total Acus
type: number
required:
- total_acus
- consumption_by_date
title: ConsumptionResponse
type: object
ProblemDetail:
description: "Corps d’erreur RFC 9457 application/problem+json pour l’API v3.\n\ndetail est conservé de l’ancien corps {\"detail\": ...} pour assurer la rétrocompatibilité\_; les\nautres membres sont ajoutés de manière additive. errors contient les échecs de validation\nau niveau des champs (422 uniquement)."
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explication en langage clair, spécifique à cette occurrence.
title: Detail
error_code:
anyOf:
- type: string
- type: 'null'
description: >-
Code exploitable par machine indiquant le refus d’une action bloquée
(p. ex. "user_frozen", "migrated_session").
title: Error Code
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Erreurs de validation par champ (réponses 422 uniquement).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Une référence d’URI (le chemin de la requête) pour cette occurrence.
title: Instance
status:
description: Le code d’état HTTP.
title: Status
type: integer
title:
description: Un bref résumé du type de problème, compréhensible par un humain.
title: Title
type: string
type:
default: about:blank
description: Une référence d’URI identifiant le type de problème.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
ConsumptionByDateResponse:
properties:
acus:
title: Acus
type: number
acus_by_product:
$ref: '#/components/schemas/AcusByProduct'
date:
title: Date
type: integer
required:
- date
- acus
- acus_by_product
title: ConsumptionByDateResponse
type: object
AcusByProduct:
description: "ACU par produit pour une journée\_; la somme des catégories correspond aux ``acus`` de la journée.\n\n``devin`` correspond aux ACU des sessions Devin lancées par une personne ou un utilisateur de service,\ny compris les sessions d’analyse de code et d’astreinte. ``automation`` correspond aux ACU consommées par\nles automatisations\_: les sessions lancées par une automatisation et ses étapes de code qui s’exécutent\nsans session. ``automation`` vaut ``null`` lorsque la répartition par produit\nn’est pas disponible."
properties:
automation:
anyOf:
- type: number
- type: 'null'
title: Automation
cascade:
title: Cascade
type: number
devin:
title: Devin
type: number
review:
anyOf:
- type: number
- type: 'null'
title: Review
terminal:
title: Terminal
type: number
required:
- devin
- cascade
- terminal
title: AcusByProduct
type: object
securitySchemes:
bearerAuth:
description: "Identifiant de compte de service (préfixe\_: cog_)"
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.