Skip to main content
POST
Deposit from the Endl account

Authorizations

Api-Key
string
header
required

Partner API key. Must carry the cards permission.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. 2026-09.1. See Versioning.

Pattern: ^\d{4}-\d{2}\.\d+$
Idempotency-Key
string
required

1 to 64 characters. Required on every POST that creates something. A repeat returns the first result; the same key with a different body returns 409.

Required string length: 1 - 64

Path Parameters

customerId
string
required

An individual, a business or an employee (cus_).

Example:

"cus_1Xb7..."

Body

application/json
walletId
string
required

The customer's wallet (wlt_).

amount
object
required

A decimal string and a currency code.

chain
string

Defaults to the wallet's network. The wallet must hold the token on this chain.

Response

The deposit.

depositId
string
Example:

"cdp_7Hn2..."

customerId
string
method
enum<string>

walletId is set only for endl_account.

Available options:
endl_account,
external
walletId
string
amount
object

A decimal string and a currency code.

chain
string
transactionHash
string | null
fees
object[]

Endl fees on this deposit.

status
enum<string>

An external deposit appears only once completed.

Available options:
pending,
completed,
failed
failureReason
any

Why the deposit failed; null otherwise.

createdAt
string<date-time>
completedAt
string<date-time> | null