---
title: "Create Withdrawal"
method: POST
path: "/api/tenant_brokerage_withdraw"
tags: ["Withdrawals"]
---

# Create Withdrawal

`POST /api/tenant_brokerage_withdraw`

## Request

- Base URL: `https://powered-by-bamboo-sandbox.investbamboo.com`
- URL: `https://powered-by-bamboo-sandbox.investbamboo.com/api/tenant_brokerage_withdraw`
- Auth: none declared. Required headers: `content-type`, `accept-language`, `x-user-id`, `x-subject-type`, `x-client-token`

Withdrawal requests follow a similar verification flow as deposits. You send a notification request with the necessary details to debit the user's brokerage account, we verify that the user has the amount requested. 
Once verified, the specified amount is deducted from the user's brokerage account, and withdrawal status events are sent via Google Pub/Sub. 

Offline settlement happens between our teams using established procedures. (see event details under [withdrawal status events](#section/Withdrawal-Event))

## Headers

- `content-type` string, required
- `accept-language` string, required
- `x-user-id` string, required
- `x-subject-type` string, required
- `x-client-token` string, required

## Request body

- TenantBrokerageWithdrawBody
  - `currency` string, required: currency
  - `amount` integer, required: amount
  - `reference` string, required: reference
  - `market` string: Either "US" or "NGX". It is used to specify desired stock market. If no market is specified, it defaults to US.

## Response `200`

Withdrawal requested

- string: No response body for this endpoint

## Other responses

- `401`: Token has expired or invalid token
- `422`: Incomplete Parameters

---

[API](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api.md) - [All operations](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/revisions/063521e8d924?raw)