---
title: "Get top-up invoice status"
method: GET
path: "/account/topup/{invoice_id}"
tags: ["Account"]
---

# Get top-up invoice status

`GET /account/topup/{invoice_id}`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/account/topup/{invoice_id}`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Poll this endpoint to check if a top-up invoice has been paid.
Returns 404 if the invoice is not an `AddFunds` invoice or does
not belong to the authenticated client.

## Path parameters

- `invoice_id` integer, required

## Response `200`

Top-up invoice status

- object
  - `success` boolean
  - `data` object
    - `invoice_id` integer
    - `amount` number, float
    - `currency` string
    - `method` string, nullable
    - `status` 'pending' | 'paid' | 'cancelled' | 'refunded'
    - `paid_at` string, date-time, nullable
    - `balance_after` number, float: Present only when status is `paid`.
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `403`: IP not whitelisted or resource not owned
- `404`: Resource not found

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)