> ## Documentation Index > Fetch the complete documentation index at: https://docs.endl.io/llms.txt > Use this file to discover all available pages before exploring further. # Deposit from the Endl account > Funds the card balance from the customer's Endl account. The deposit is `pending` until the money reaches the card balance, then `card_deposit.completed` is sent (or `card_deposit.failed`). Deposits for an employee are refused. ## OpenAPI ````yaml api-reference/endl-cards-api.json POST /api/v0/cards/{customerId}/deposits openapi: 3.1.0 info: title: Endl Cards API version: '0' description: >- Issue virtual cards to your customers: enrol the customer, fund the card balance, issue cards, show card details securely, and follow every transaction by webhook. Paths are under `/api/v0`. The key must carry the **`cards`** permission. **This API is not final yet** — see [what may still change](/api-reference/cards/introduction#not-final-yet). servers: - url: https://api-sandbox.endl.io description: Sandbox security: - apiKey: [] tags: - name: Enrolment - name: Cardholders - name: Cards - name: Card details - name: Transactions and balance - name: Deposits - name: Withdrawals paths: /api/v0/cards/{customerId}/deposits: post: tags: - Deposits summary: Deposit from the Endl account description: >- Funds the card balance from the customer's Endl account. The deposit is `pending` until the money reaches the card balance, then `card_deposit.completed` is sent (or `card_deposit.failed`). Deposits for an employee are refused. parameters: - $ref: '#/components/parameters/ApiVersion' - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/CustomerId' requestBody: required: true content: application/json: schema: type: object required: - walletId - amount properties: walletId: type: string description: The customer's wallet (`wlt_`). amount: $ref: '#/components/schemas/Money' chain: type: string description: >- Defaults to the wallet's network. The wallet must hold the token on this chain. example: walletId: wlt_3Kd8... amount: amount: '500.00' currency: USD chain: base responses: '201': description: The deposit. content: application/json: schema: $ref: '#/components/schemas/Deposit' example: depositId: cdp_7Hn2... customerId: cus_1Xb7... method: endl_account walletId: wlt_3Kd8... amount: amount: '500.00' currency: USD chain: base transactionHash: 0x... fees: [] status: completed failureReason: null createdAt: '2026-10-16T09:00:00Z' completedAt: '2026-10-16T09:01:10Z' '400': description: >- A request field is missing or invalid. The customer type can't do this. Deposits for an employee are refused. The wallet isn't the customer's, or its chain isn't supported. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: |- The API key lacks the `cards` permission. The customer isn't enrolled, or the enrolment isn't `active`. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Customer not found. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: |- Not enough funds in the wallet. The `Idempotency-Key` was reused with a different body. content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: ApiVersion: name: Api-Version in: header required: true description: >- The API version this request targets. `2026-09.1`. See [Versioning](/api-reference/versioning). schema: type: string pattern: ^\d{4}-\d{2}\.\d+$ default: 2026-09.1 example: 2026-09.1 IdempotencyKey: name: Idempotency-Key in: header required: true description: >- 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`. schema: type: string minLength: 1 maxLength: 64 CustomerId: name: customerId in: path required: true description: An individual, a business or an employee (`cus_`). schema: type: string example: cus_1Xb7... schemas: Money: type: object required: - amount - currency description: A decimal string and a currency code. properties: amount: type: string description: Decimal string, e.g. `"42.99"`. example: '42.99' currency: type: string description: Currency code, e.g. `USD`. example: USD Deposit: type: object properties: depositId: type: string example: cdp_7Hn2... customerId: type: string method: type: string enum: - endl_account - external description: '`walletId` is set only for `endl_account`.' walletId: type: string amount: $ref: '#/components/schemas/Money' chain: type: string transactionHash: type: - string - 'null' fees: type: array items: $ref: '#/components/schemas/Fee' description: Endl fees on this deposit. status: type: string enum: - pending - completed - failed description: An external deposit appears only once `completed`. failureReason: description: Why the deposit failed; `null` otherwise. createdAt: type: string format: date-time completedAt: type: - string - 'null' format: date-time Error: type: object description: >- The standard Endl error body. `errors[].code` is an `ERRCRD_` code — **the code numbers are not final yet** — and `field` names the request field when one is at fault. properties: code: type: integer message: type: string status: type: string enum: - ERROR data: type: 'null' errors: type: array items: type: object properties: code: type: string message: type: string field: type: - string - 'null' Fee: type: object description: >- An Endl fee. The `fees` shape is final; the fee **amounts** are not final yet. properties: type: type: string example: transaction_fee amount: $ref: '#/components/schemas/Money' securitySchemes: apiKey: type: apiKey in: header name: Api-Key description: Partner API key. Must carry the `cards` permission. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.