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

# List usage invoices

> The organization's monthly usage statements, newest first: one per UTC calendar month, opened with the balance carried in and closed with the balance carried out, with the month's consumption broken down per group. The current month is `open` — its figures are live and keep moving until the month closes.

Requires your organization API key, from your backend.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/billing/invoices
openapi: 3.1.0
info:
  title: Sidenet API
  version: 1.0.0
  description: >-
    Sidenet HTTP endpoints exposed by the Sidenet Studio. All routes require an
    api key that can be generated through the studio in studio.sidenet.ai.
servers:
  - url: https://api.sidenet.ai
security:
  - bearerAuth: []
paths:
  /v1/billing/invoices:
    get:
      tags:
        - Billing
      summary: List usage invoices
      description: >-
        The organization's monthly usage statements, newest first: one per UTC
        calendar month, opened with the balance carried in and closed with the
        balance carried out, with the month's consumption broken down per group.
        The current month is `open` — its figures are live and keep moving until
        the month closes.


        Requires your organization API key, from your backend.
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 12
            maximum: 120
          description: How many months back, newest first.
      responses:
        '200':
          description: The statements
          content:
            application/json:
              schema:
                type: object
                properties:
                  invoices:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: >-
                            The statement id (what a transaction's `invoice_id`
                            points at).
                        period_start:
                          type: string
                          format: date
                          description: First day of the month (UTC).
                        period_end:
                          type: string
                          format: date
                          description: First day of the next month (exclusive).
                        status:
                          type: string
                          enum:
                            - open
                            - closed
                            - finalized
                          description: >-
                            `open` is the current month (figures are live and
                            still moving); `closed` months may still be
                            recomputed for a week while late costs land;
                            `finalized` never changes.
                        opening_balance:
                          type: number
                          description: Credits carried in from the previous statement.
                        credits_added:
                          type: number
                          description: Completed purchases this statement counted.
                        consumed:
                          type: number
                          description: Cost of requests started in the month.
                        closing_balance:
                          type: number
                          nullable: true
                          description: >-
                            opening + credits_added − consumed. For the open
                            month, the balance right now.
                        request_count:
                          type: integer
                          nullable: true
                          description: >-
                            Requests started in the month. Null for the open
                            month.
                        by_group:
                          type: array
                          description: >-
                            The month's consumption per group, largest first. A
                            null id and name is spend that belongs to no group.
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                nullable: true
                                description: >-
                                  Your id for the group (null for legacy groups,
                                  or for unattributed spend).
                              name:
                                type: string
                                nullable: true
                              for_scorers:
                                type: boolean
                                description: True for the organization's scorers group.
                              consumed:
                                type: number
                        closed_at:
                          type: string
                          format: date-time
                          nullable: true
                        finalized_at:
                          type: string
                          format: date-time
                          nullable: true
              example:
                invoices:
                  - id: '61'
                    period_start: '2026-10-01'
                    period_end: '2026-11-01'
                    status: open
                    opening_balance: 259.73
                    credits_added: 100
                    consumed: 41.27
                    closing_balance: 318.46
                    request_count: null
                    by_group:
                      - id: grp_84f20c19
                        name: Acme — production
                        for_scorers: false
                        consumed: 38.1
                      - id: null
                        name: Scorers
                        for_scorers: true
                        consumed: 3.17
                    closed_at: null
                    finalized_at: null
                  - id: '57'
                    period_start: '2026-09-01'
                    period_end: '2026-10-01'
                    status: finalized
                    opening_balance: 97.23
                    credits_added: 250
                    consumed: 87.5
                    closing_balance: 259.73
                    request_count: 1412
                    by_group:
                      - id: grp_84f20c19
                        name: Acme — production
                        for_scorers: false
                        consumed: 87.5
                    closed_at: '2026-10-01T00:05:02.118Z'
                    finalized_at: '2026-10-08T00:20:01.550Z'
        '403':
          description: Not an API key
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Organization API key, generated in studio.sidenet.ai. Backend only —
        never in a browser.

````

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