---
title: "List payment history"
method: GET
path: "/api/space/payment_history"
tags: ["Space Billing"]
---

# List payment history

`GET /api/space/payment_history`

Lists the balance adjustments recorded for the space: top-ups, auto top-ups, and
credits or debits applied by SignalWire. Narrow the range with `created_after` and
`created_before`. Results are paged; follow the `links.next` URL for the next page,
which carries the filters and the `page_token` for you.

#### Permissions

Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

## Query parameters

- `created_after` string
- `created_before` string
- `page_size` integer
- `page_number` integer
- `page_token` string

## Response `200`

The request has succeeded.

- SpacePaymentHistoryListResponse — A page of balance adjustments.
  - `links` SpaceSpacePaginationLinks, required — Cursor pagination links. Filters given on the request are preserved in every link.
    - `self` string, required — The link to the current page.
    - `first` string, required — The link to the first page.
    - `next` string — The link to the next page. Only present when more results exist.
    - `prev` string — The link to the previous page. Only present when a previous page exists.
  - `data` SpaceBalanceAdjustment[], required — The balance adjustments on this page.
    - `type` 'balance_adjustment', required — The object type. Always `balance_adjustment`.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `kind` string, required — The kind of adjustment, for example `balance_top_up`, `auto_balance_top_up`, `balance_credit_by_signalwire`, `balance_debit_by_signalwire`, `coupon_code_credit`, or `sign_up_free_credit`.
    - `amount_in_microdollars` integer, required — The signed amount in microdollars. Credits and debits carry the sign they were recorded with.
    - `amount` number, double, required — The same amount in US dollars.
    - `created_at` string, date-time, required — The date and time when the adjustment was recorded.
    - `payment_method_last4` string, nullable, required — The last four digits of the card that was charged, or `null` when the adjustment was not charged to a card.

## Other responses

- `401` — The credential is missing, unknown, or revoked; its holder is not a member of the space in the subdomain; the member is not an owner or admin; or billing for this space is not managed in the space itself, which is the case for a space purchased through a cloud marketplace and for a suspended or deactivated space. A space deactivated for nonpayment keeps the billing endpoints so that its outstanding balance can be settled. The body is the plain text `Unauthorized`. An unverified space instead receives the JSON body `{"message": "Please validate a phone number to access your account."}` on every endpoint under `/api/space`.
- `422` — `page_number` is above 0 without a `page_token` (`page_token_required_for_next_page`), or the `page_token` is not one this endpoint issued (`page_token_is_invalid`); or `created_after` or `created_before` is not a date or timestamp.
- `500` — An internal server error occurred.

## Changes

> 161 revisions in range; 3 could not be searched.

- **2026-09-15** `45bac4fd93ab` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/space/payment_history/get.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/20ee0f568ece?raw)