---
title: Get a top-up
description: Where one top-up of your balance stands.
---
`GET` `/v1/open/top-ups/{id}`

**Host** `https://api.open.sume.com` · **Auth** your open.sume.com API key

Reads one top-up of the balance your key is billed to, by the `id` that [Top up your balance](/docs/reference/billing/top-up) returned. Top-ups made with **Add funds** on the Billing page can be read the same way.

## Request

### Path

| Name | Type | Description |
|---|---|---|
| `id` | string | The top-up `id`. |

## Example

```bash
curl https://api.open.sume.com/v1/open/top-ups/owc_5f2c9a1e0b7d4c3a8e6f1d2b4a9c7e01 \
  -H "Authorization: Bearer $SUME_API_KEY"
```

## Response

`200 OK`

```json
{
  "data": {
    "id": "owc_5f2c9a1e0b7d4c3a8e6f1d2b4a9c7e01",
    "object": "open_top_up",
    "status": "paid",
    "amount_usd_cents": 2000,
    "currency": "USD",
    "checkout_url": null,
    "expires_at": "2026-10-17T02:15:00.000Z",
    "created_at": "2026-10-16T02:15:00.000Z",
    "paid_at": "2026-10-16T02:16:41.000Z"
  }
}
```

`checkout_url` is set only while the top-up is `pending`.

## Errors

| Status | `code` | When |
|---|---|---|
| 403 | `open_key_required` | The key is not an open.sume.com key. |
| 404 | `not_found` | No top-up with that id on your balance. |

[All error codes](/docs/errors)

## Related

- [Top up your balance](/docs/reference/billing/top-up)
- [Billing](/docs/billing)