---
title: "Top-up wallet for an account"
method: POST
path: "/accounts/{account_id}/wallet_topup"
tags: ["Wallet"]
---

# Top-up wallet for an account

`POST /accounts/{account_id}/wallet_topup`

Top-up wallet for an account

## Path parameters

- `account_id` string, required

## Request body

- TopupWalletRequest — Payload to topup wallet of an account
  - `topupAmount` number, required

## Response `200`

Response for Credit Balance Request

- WalletBalanceResponse — Wallet Balance response
  - `id` string, required
  - `accountId` string, required
  - `customerId` string, required
  - `balance` number, required — This amount is the difference of total credited amount and sum of consumed, hold amount. ie. credit amount - (consumed amount + hold amount)
  - `creditUnit` string, required
  - `externalId` string
  - `status` 'ACTIVE' | 'INACTIVE', required
  - `holdAmount` number
  - `effectiveFrom` string, date-time, required
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `metadata` object

## Other responses

- `400` — Error response
- `401` — Error response
- `403` — Error response
- `404` — Error response
- `429` — Error response
- `default` — Error response

---

[API](https://skmtc.net/togaihq/apis/togai-apis.md) · [All operations](https://skmtc.net/togaihq/apis/togai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/togaihq/togai-apis/revisions/442f5d8f4aa0/schema)