---
title: "Top-up records (paginated)"
method: GET
path: "/topups"
tags: ["Billing"]
---

# Top-up records (paginated)

`GET /topups`

## Request

- Base URL: `https://console-api.blockvectra.com/v1`
- URL: `https://console-api.blockvectra.com/v1/topups`
- Auth: HTTP bearer

Sorted in descending order of `topup_id`.

## Query parameters

- `limit` integer
- `before` string

## Response `200`

Page of top-up records.

- TopupListResponse
  - `items` TopupView[], required
    - `topup_id` string, required
    - `amount_units` integer, required
    - `created_at` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.
    - `kind` 'signup_grant' | 'free_refill' | 'promo_grant' | 'paid', required: Top-up type (signup_grant for sign-up grant, free_refill for periodic refill, promo_grant for reset chance credit, paid for paid top-up).
    - `amount_usd` string: Fiat amount of paid top-up (present only for paid top-ups with fiat records).
    - `currency` string: Settlement currency (present only for paid top-ups with fiat records).
  - `next_before` string, nullable, required

## Other responses

- `400`: Invalid `limit` or `before`.
- `401`: Missing or invalid session (without distinguishing cause).
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

[API](https://skmtc.dev/blockvectra/apis/blockvectra-console-api.md) · [All operations](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/revisions/28c91298f433?raw)