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

# List the org's Stripe invoices (receipts) with links to their PDFs

> **Token scope:** `account` · `org` — read-only tokens allowed.



## OpenAPI

````yaml /openapi/org.json get /orgs/{orgId}/billing/invoices
openapi: 3.1.0
info:
  title: InstaCloud API — Organization level
  version: 0.1.0
  description: >-
    Endpoints under `/orgs/{orgId}`: members, projects, billing, domains.
    Callable with an account-wide token or a token bound to that organization.


    Generated from the platform's own OpenAPI document
    (https://api.instacloud.com/openapi.json); see the [API
    overview](/reference/api/overview) for authentication and token scopes.
servers:
  - url: https://api.instacloud.com
    description: InstaCloud
security:
  - bearerAuth: []
tags:
  - name: Organization
    description: 'The organization itself: name, members, invitations.'
  - name: Projects
    description: Projects inside an organization.
  - name: Audit
    description: The project's event timeline, including agent-ingested events.
  - name: Domains
    description: >-
      Domains bought through InstaCloud, bring-your-own zones and their DNS
      records.
  - name: Billing
    description: Usage, cycles, invoices and credits.
paths:
  /orgs/{orgId}/billing/invoices:
    get:
      tags:
        - Billing
      summary: List the org's Stripe invoices (receipts) with links to their PDFs
      description: '**Token scope:** `account` · `org` — read-only tokens allowed.'
      operationId: listBillingInvoices
      parameters:
        - schema:
            minimum: 1
            maximum: 100
            default: 50
            type: integer
          in: query
          name: limit
          required: false
        - schema:
            type: string
          in: query
          name: before
          required: false
          description: opaque cursor from a previous page's nextBefore
        - schema:
            format: uuid
            type: string
          in: path
          name: orgId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingInvoiceList'
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Billing (Stripe) not configured
components:
  schemas:
    BillingInvoiceList:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BillingInvoice'
        nextBefore:
          description: >-
            opaque cursor; pass as ?before= for the next page, null when there
            are no more
          type:
            - string
            - 'null'
      required:
        - items
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    BillingInvoice:
      type: object
      properties:
        id:
          description: Stripe invoice id
          example: in_1Ofg…
          type: string
        number:
          description: >-
            the invoice number printed on the PDF; null before Stripe assigns
            one
          anyOf:
            - type: string
            - type: 'null'
        createdAt:
          format: date-time
          type: string
        amountUsd:
          description: invoice total in USD
          type: number
        currency:
          example: usd
          type: string
        status:
          description: >-
            Stripe invoice status — paid, open or uncollectible (drafts and
            voided invoices are never listed)
          example: paid
          type: string
        description:
          description: >-
            the invoice's description, else its first line item — what was
            bought
          anyOf:
            - type: string
            - type: 'null'
        pdfUrl:
          description: >-
            Stripe-hosted, read-only PDF; null until Stripe has rendered it. The
            payable hosted invoice link is deliberately never returned.
          anyOf:
            - type: string
            - type: 'null'
      required:
        - id
        - number
        - createdAt
        - amountUsd
        - currency
        - status
        - description
        - pdfUrl
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session access JWT or an API token (`insta_<prefix>_<secret>`).

````