---
title: "Historical organization billing log"
method: GET
path: "/billing/transactions"
tags: ["Billing"]
---

# Historical organization billing log

`GET /billing/transactions`

## Request

- Base URL: `https://cloud-api.voltagepark.com/api/v1`
- URL: `https://cloud-api.voltagepark.com/api/v1/billing/transactions`
- Auth: one of:
  - HTTP bearer
  - API key in header `UI-Authorization`
- TypeScript: <https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/docs/billing/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `offset` integer
- `types` TransactionTypeFilters[], nullable
- `earliest` string, date, nullable
- `latest` string, date, nullable

## Response `200`

Successful Response

- PaginatedResultHistoricalTransactionInTimePeriod
  - `results` HistoricalTransactionInTimePeriod[], required
    - `id` string, uuid, required
    - `total_amount` string, required
    - `timestamp_creation` string, date-time, required
    - `timestamp_completion` string, date-time, nullable, required
    - `details` union, required
      - HistoricalChargeOrPayoutDetails
        - `type` 'charge' | 'payout', required
        - `linked_instance` VMTransactionLinkedInstance, required
          - `type` 'virtual_machine_instance' | 'storage_block_instance', required
          - `id` string, uuid, required
          - `virtual_machine_id` string, uuid, required
          - `timestamp_creation` string, date-time, required
          - `timestamp_deletion` string, date-time, nullable, required
      - HistoricalOtherDetails
        - `type` 'other'
        - `note_public` string, nullable, required
      - HistoricalStripeDepositDetails
        - `type` 'stripe_deposit'
      - HistoricalBaremetalDetails
        - `type` 'baremetal_charge' | 'baremetal_payout', required
        - `linked_instance` BaremetalTransactionLinkedInstance, required
          - `id` string, uuid, required
          - `baremetal_rental_id` string, uuid, required
          - `timestamp_creation` string, date-time, required
          - `timestamp_deletion` string, date-time, nullable, required
      - HistoricalStorageDetails
        - `type` 'storage_charge' | 'storage_payout', required
        - `linked_instance` StorageTransactionLinkedInstance, required
          - `id` string, uuid, required
          - `timestamp_creation` string, date-time, required
          - `timestamp_deletion` string, date-time, nullable, required
    - `period_amount` string, required
  - `total_result_count` integer, required
  - `has_previous` boolean, required
  - `has_next` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api.md) - [All operations](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/revisions/11c2e9146826?raw)