---
title: "Get organization transaction history"
method: GET
path: "/orgs/v1/{org_id}/billing/history"
tags: ["Billing"]
---

# Get organization transaction history

`GET /orgs/v1/{org_id}/billing/history`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/{org_id}/billing/history`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - API key in header `x-admin-key`

Returns the allowance ledger for an organization. Requires an admin key or an authenticated SIWX/control-plane-session principal with an active org role of billing or higher.

## Path parameters

- `org_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Transaction history

- object
  - `org_id` string
  - `entries` object[]

## Other responses

- `401`: Missing or invalid SIWX/control-plane-session credential (and no admin key)
- `403`: Active organization role of billing or higher required

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)