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

# List issued invoices

> The active organization's most recent finalized invoices, newest first, with the payment status and PDF Stripe reports for each.



## OpenAPI

````yaml https://api.twinbay.ai/openapi.json get /organizations/current/billing/invoices
openapi: 3.1.0
info:
  title: Twinbay
  description: Backend API
  version: 0.1.0
servers:
  - url: https://api.twinbay.ai
    description: Production
security: []
tags:
  - name: healthchecks
    description: Healthcheck endpoints
  - name: users
    description: >-
      The current user. Sign-up and sign-in happen in WorkOS AuthKit, which
      issues the access tokens this API accepts.
  - name: organizations
    description: >-
      Organizations the caller belongs to. Every authenticated request acts
      inside exactly one organization — the one its access token names — so
      these routes address it as `current`.
  - name: billing
    description: >-
      The active organization's plan, its limits, and what the current period
      has cost so far.
  - name: api-keys
    description: >-
      Long-lived credentials for callers that cannot hold an AuthKit session —
      agents, SDKs, CI. A key is accepted wherever an access token is, and acts
      with the role its creator holds when the request arrives.
  - name: environments
    description: >-
      Create and edit isolated provider environments. Each environment contains
      behavioural twins from the `twins` package.
  - name: twins
    description: Manage provisioned twins by their IDs.
  - name: catalog
    description: Browse the digital twins available for new environments.
  - name: scenarios
    description: Reusable starting setups of provider twins and optional seeds.
  - name: seeds
    description: >-
      Starting states for a twin. Describe the data you want in your own words,
      and a worker expands it into rows once; pass the seed's id when you create
      an environment to start a twin holding it.
  - name: tests
    description: >-
      Outcomes described in natural language, compiled once into request
      matchers, and evaluated deterministically against the traffic an attempt
      was served.
paths:
  /organizations/current/billing/invoices:
    get:
      tags:
        - billing
      summary: List issued invoices
      description: >-
        The active organization's most recent finalized invoices, newest first,
        with the payment status and PDF Stripe reports for each.
      operationId: list_invoices
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvoicesResponse'
        '401':
          description: The credential is missing, malformed, expired, or not trusted
      security:
        - Access token: []
        - Organization API key: []
components:
  schemas:
    InvoicesResponse:
      properties:
        invoices:
          items:
            $ref: '#/components/schemas/Invoice'
          type: array
          title: Invoices
          description: Issued invoices, newest first
      type: object
      required:
        - invoices
      title: InvoicesResponse
    Invoice:
      properties:
        id:
          type: string
          title: Id
        period_start:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Period Start
        period_end:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Period End
        issued_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Issued At
        total_cents:
          type: number
          title: Total Cents
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
          description: >-
            The payment status Stripe reports, such as `PAID` or
            `PAYMENT_FAILED`, or null when nothing was sent to collect
        pdf_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Pdf Url
      type: object
      required:
        - id
        - period_start
        - period_end
        - issued_at
        - total_cents
        - status
      title: Invoice
  securitySchemes:
    Access token:
      type: http
      description: Access token issued by WorkOS AuthKit.
      scheme: bearer
    Organization API key:
      type: apiKey
      description: >-
        An organization API key. Create one at
        https://console.twinbay.ai/api-keys
      in: header
      name: X-API-Key

````

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