---
title: "Create collateral withdrawal request"
method: POST
path: "/api/prime/trading/v1/accounts/{accountId}/margin/collateral/withdrawalrequests"
tags: ["Margin"]
---

# Create collateral withdrawal request

`POST /api/prime/trading/v1/accounts/{accountId}/margin/collateral/withdrawalrequests`

## Request

- Base URL: `https://developers.bitgo.com`
- URL: `https://developers.bitgo.com/api/prime/trading/v1/accounts/{accountId}/margin/collateral/withdrawalrequests`
- Auth: none declared

Create a collateral withdrawal request.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `currency` string, required: Currency symbol for withdrawal
  - `quantity` string, decimal, required: Amount to withdraw

## Response `202`

Collateral withdrawal request accepted for processing

- CollateralWithdrawalRequestResponse
  - `id` string, uuid, required: Unique identifier for the withdrawal request
  - `accountId` string, required: Account ID associated with the withdrawal request
  - `enterpriseId` string, required: Enterprise ID associated with the withdrawal request
  - `currency` string, required: Currency symbol for the withdrawal
  - `quantity` string, decimal, required: Amount requested for withdrawal
  - `status` 'pending' | 'approved' | 'rejected' | 'completed' | 'cancelled', required: Current status of the withdrawal request
  - `createdBy` string, required: User who created the withdrawal request
  - `canceledBy` string, nullable: User who canceled the withdrawal request, if applicable
  - `creationDate` string, date-time, required: Timestamp when the request was created
  - `modifiedDate` string, date-time, required: Timestamp when the request was last modified

## Other responses

- `400`: Bad request - Invalid parameters
- `401`: Unauthorized - Invalid or missing authentication
- `403`: Forbidden - Insufficient permissions
- `409`: Conflict - A pending withdrawal request already exists for this currency
- `422`: Unprocessable Entity - JSON payload is improperly formatted
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) - [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/6b6e050a7f84?raw)