---
title: "List top-ups"
method: GET
path: "/customers/{customer_id}/credits/top_ups"
tags: ["Credit"]
---

# List top-ups

`GET /customers/{customer_id}/credits/top_ups`

## Path parameters

- `customer_id` string, nullable, required

## Query parameters

- `limit` integer — The number of items to fetch. Defaults to 20.
- `cursor` string, nullable — Cursor for pagination. This can be populated by the `next_cursor` value returned from the initial request.

## Response `200`

OK

- TopUps
  - `data` TopUp[], required
    - `id` string, required
    - `currency` string, required — The currency or custom pricing unit to use for this top-up. If this is a real-world currency, it must match the customer's invoicing currency.
    - `threshold` string, required — The threshold at which to trigger the top-up. If the balance is at or below this threshold, the top-up will be triggered.
    - `amount` string, required — The amount to increment when the threshold is reached.
    - `per_unit_cost_basis` string, required — How much, in the customer's currency, to charge for each unit.
    - `invoice_settings` TopUpInvoiceSettings, required
      - `auto_collection` boolean, required — Whether the credits purchase invoice should auto collect with the customer's saved payment method.
      - `net_terms` integer, required — The net terms determines the difference between the invoice date and the issue date for the invoice. If you intend the invoice to be due on issue, set this to 0.
      - `memo` string, nullable — An optional memo to display on the invoice.
      - `require_successful_payment` boolean — When true, credit blocks created by this top-up will require that the corresponding invoice is paid before they are drawn down from. If any topup block is pending payment, further automatic top-ups will be paused until the invoice is paid or voided.
    - `expires_after` integer, nullable — The number of days or months after which the top-up expires. If unspecified, it does not expire.
    - `expires_after_unit` 'day' | 'month', nullable — The unit of expires_after.
  - `pagination_metadata` PaginationMetadata, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `413` — Content Too Large
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/withorb/apis/api-reference.md) · [All operations](https://skmtc.dev/withorb/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withorb/api-reference/revisions/816dfe734e2e/schema)