---
title: "Deposit money into an account through a bank adapter"
method: POST
path: "/v1/account-deposits"
tags: ["Accounts and money"]
---

# Deposit money into an account through a bank adapter

`POST /v1/account-deposits`

## Request

- Base URL: `https://hyperscale0.ai`
- URL: `https://hyperscale0.ai/v1/account-deposits`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Asks the bank adapter to deliver a deposit and posts its credit notification from the company's bank mirror into the account. The fixture bank moves fake money in sandbox, and in live on an estate that declares HYPERSCALE_LIVE_MONEY=fixture.

## Headers

- `X-Hyperscale-Environment` 'sandbox' | 'live'
- `Idempotency-Key` string, required

## Request body

- object
  - `transferId` string: Hyperscale transfer ID
  - `destinationAccountId` string, required: Hyperscale account ID
  - `adapter` string, required: The bank adapter that delivers the deposit, such as `fixture_bank`
  - `amount` string, required: Positive minor-unit integer amount serialized as a string, capped at 15 digits per call
  - `currency` 'SAR', required

## Response `201`

Success

- AccountDepositOutput
  - `transferId` string, required: Hyperscale transfer ID
  - `tenantId` string, required: Organization tenant ID
  - `sourceAccountId` string, required: Hyperscale account ID
  - `destinationAccountId` string, required: Hyperscale account ID
  - `adapter` string, required
  - `bankReference` string, required
  - `amount` string, required: Positive minor-unit integer amount serialized as a string (at most 18 digits)
  - `currency` 'SAR', required
  - `transferStatus` 'posted', required

## Other responses

- `default`: ErrorResponse. See x-error-codes and x-errors for codes, HTTP statuses and retry guidance.

---

[API](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api.md) · [All operations](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api/revisions/e9e8faa044d5?raw)