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

# La consommation du client sur une fenêtre (auth : clé lsk_)

> Réponses servies, comptes actifs, coût, latences, pouces — sur les `days` derniers jours. C'est ce que montre la console du client, et c'est ce qui se facture.

Réservée à la clé : un poste n'a pas à lire la consommation du parc. `client` permet à une clé `platform` de lire celle d'un autre — c'est le tableau de bord que la console sert à un partenaire.

`truncated: true` signale une fenêtre trop large pour être totalisée honnêtement — réduisez `days` plutôt que de croire le total.



## OpenAPI

````yaml /openapi.json get /v2/usage
openapi: 3.1.0
info:
  title: Locus API
  description: >-
    Locus knowledge layer — REST over a clinical knowledge graph.


    Two categories of surface:

    - **query** (read) — `/v2/retrieve` and `/v2/retrieve/stream`
    (knowledge-graph retrieval, MKF 0.1.3), `/v2/drugs/*` (the full text of an
    SmPC section a retrieval truncated) and `/v2/feedback` (a thumb on a traced
    answer);

    - **ops** — `/health`.


    The write plane (PDF → Neo4j graph: ingest, summarize, MKU extraction) is
    NOT exposed over HTTP — it is a batch pipeline driven by the `locus` CLI,
    which runs where the source PDFs are.
  version: 0.5.0
servers:
  - url: https://core.locusmedical.fr
    description: Production
security: []
paths:
  /v2/usage:
    get:
      tags:
        - b2b
      summary: 'La consommation du client sur une fenêtre (auth : clé lsk_)'
      description: >-
        Réponses servies, comptes actifs, coût, latences, pouces — sur les
        `days` derniers jours. C'est ce que montre la console du client, et
        c'est ce qui se facture.


        Réservée à la clé : un poste n'a pas à lire la consommation du parc.
        `client` permet à une clé `platform` de lire celle d'un autre — c'est le
        tableau de bord que la console sert à un partenaire.


        `truncated: true` signale une fenêtre trop large pour être totalisée
        honnêtement — réduisez `days` plutôt que de croire le total.
      operationId: usage_v2_usage_get
      parameters:
        - name: days
          in: query
          required: false
          schema:
            type: integer
            maximum: 365
            minimum: 1
            default: 30
            title: Days
        - name: accounts
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 0
            description: Combien de comptes en tête de liste.
            default: 10
            title: Accounts
          description: Combien de comptes en tête de liste.
        - name: client
          in: query
          required: false
          schema:
            type: string
            maxLength: 200
            description: >-
              Agir au nom d'un AUTRE client, par son `slug` ou son identifiant.
              Réservé aux clés `platform` — la console que nous servons, où
              c'est une personne qui se connecte et non une clé. Omis : le
              client de la clé présentée, comme toujours.
            default: ''
            title: Client
          description: >-
            Agir au nom d'un AUTRE client, par son `slug` ou son identifiant.
            Réservé aux clés `platform` — la console que nous servons, où c'est
            une personne qui se connecte et non une clé. Omis : le client de la
            clé présentée, comme toujours.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Usage V2 Usage Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - lsk: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    lsk:
      type: http
      description: >-
        Locus API key — paste the raw `lsk_…` value (no 'Bearer ' prefix) — or a
        B2B session token minted by `POST /v2/session-token`.
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.