> ## 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 credit transactions

> The organization's credit ledger, newest first: top-ups, monthly allowances, refunds and corrections, each with its payment status. Only `completed` entries count towards the balance; a `pending` top-up is a checkout that has not been paid yet.

Requires your organization API key, from your backend.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/billing/transactions
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/transactions:
    get:
      tags:
        - Billing
      summary: List credit transactions
      description: >-
        The organization's credit ledger, newest first: top-ups, monthly
        allowances, refunds and corrections, each with its payment status. Only
        `completed` entries count towards the balance; a `pending` top-up is a
        checkout that has not been paid yet.


        Requires your organization API key, from your backend.
      parameters:
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - completed
              - pending
              - cancelled
              - failed
          description: Only entries in this status.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 200
      responses:
        '200':
          description: The transactions
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: The transaction id.
                        amount:
                          type: number
                          description: >-
                            Credits added (negative for a refund or correction),
                            in USD.
                        type:
                          type: string
                          nullable: true
                          description: >-
                            `topup`, `monthly_allowance`, or another ledger
                            entry kind.
                        status:
                          type: string
                          enum:
                            - completed
                            - pending
                            - cancelled
                            - failed
                          description: Only `completed` entries count towards the balance.
                        service_charge:
                          type: number
                          nullable: true
                          description: Service charge paid on a top-up, in USD.
                        total_paid:
                          type: number
                          nullable: true
                          description: >-
                            What was actually charged for a top-up (credits +
                            service charge), in USD.
                        invoice_id:
                          type: string
                          nullable: true
                          description: >-
                            The monthly statement that counted this entry; null
                            while the month is still open.
                        created_at:
                          type: string
                          format: date-time
              example:
                transactions:
                  - id: '812'
                    amount: 100
                    type: topup
                    status: completed
                    service_charge: 45
                    total_paid: 145
                    invoice_id: null
                    created_at: '2026-10-19T08:41:12.004Z'
                  - id: '790'
                    amount: 250
                    type: topup
                    status: completed
                    service_charge: 112.5
                    total_paid: 362.5
                    invoice_id: '57'
                    created_at: '2026-09-03T15:02:48.311Z'
        '400':
          description: Unknown status
        '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.