---
title: "Get prepaid credit"
method: GET
path: "/v2/api/partner/credit"
tags: ["Partner"]
---

# Get prepaid credit

`GET /v2/api/partner/credit`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/partner/credit`
- Auth: API key in header `Authorization`

Returns the prepaid credit you have left and your recent top-ups. Allo pays what you buy through the Partner API from this credit first, then charges your card on file for the rest. Without enough credit and without a card, a request that charges fails with `402 PARTNER_CREDIT_INSUFFICIENT` and nothing is created. Requires the `PARTNER` scope and a Discounted licence (reseller) partner contract.

## Response `200`

Your prepaid credit

- object
  - `data` object
    - `balance_cents` integer: Credit left, in the smallest unit of `currency`. `0` before your first top-up.
    - `currency` string: Lowercase ISO 4217 code of your billing account. Omitted before your first top-up.
    - `prepaid` boolean: `true` once at least one top-up was added to your credit.
    - `last_top_up` object: Your most recent top-up. Omitted when there is none.
      - `amount_cents` integer
      - `currency` string
      - `at` string, date-time
    - `top_ups` object[]: Your 20 most recent top-ups, newest first.
      - `amount_cents` integer: Amount added to your credit, excluding tax.
      - `currency` string
      - `invoice_id` string: The invoice the top-up was paid with.
      - `at` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `403`: The API key lacks the PARTNER scope, your account is not an enabled partner (PARTNER_ACCESS_REQUIRED), or your partner contract cannot create accounts (PARTNER_CONTRACT_CANNOT_PROVISION).
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/partner/credit/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)