Get withdrawal by ID

const url = 'https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "status": "success",
  "data": {
    "id": "392cf015-5045-4615-a226-df3543d9c15f",
    "createdAt": "2025-02-07T14:04:14.268Z",
    "amount": 0.5,
    "currency": "USDT",
    "network": "ETHEREUM",
    "status": "COMPLETED",
    "transactionHash": null,
    "withdrawalAddressId": "2697eff1-ac30-41db-94b7-d615133a5c9e",
    "orgId": "c96183a5-2830-4606-9ae2-15dfd058872b",
    "actorId": "36bdb6a4-7cc6-4a08-b325-db416dbdd9f5",
    "actorEmail": "[email protected]",
    "comments": "Client initiated the withdrawal",
    "paymentDetails": null
  }
}

{
  "status": "error",
  "message": "Query validation failed"
}

{
  "status": "error",
  "message": "The authorization key provided is either invalid or expired, please try again"
}

{
  "status": "error",
  "message": "Request with this idempotency key is currently processing",
  "error": {
    "code": "IDEMPOTENCY_IN_FLIGHT",
    "details": "Please wait for the original request to complete"
  }
}

{
  "status": "error",
  "message": "Idempotency key reused with different parameters",
  "error": {
    "code": "IDEMPOTENCY_MISMATCH",
    "details": "This idempotency key was already used with different request parameters"
  }
}

{
  "status": "error",
  "message": "An internal error has occurred"
}

GET

brokerage

{orgId}

withdrawal

{withdrawalId}

Get withdrawal by ID

const url = 'https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal/{withdrawalId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "status": "success",
  "data": {
    "id": "392cf015-5045-4615-a226-df3543d9c15f",
    "createdAt": "2025-02-07T14:04:14.268Z",
    "amount": 0.5,
    "currency": "USDT",
    "network": "ETHEREUM",
    "status": "COMPLETED",
    "transactionHash": null,
    "withdrawalAddressId": "2697eff1-ac30-41db-94b7-d615133a5c9e",
    "orgId": "c96183a5-2830-4606-9ae2-15dfd058872b",
    "actorId": "36bdb6a4-7cc6-4a08-b325-db416dbdd9f5",
    "actorEmail": "[email protected]",
    "comments": "Client initiated the withdrawal",
    "paymentDetails": null
  }
}

{
  "status": "error",
  "message": "Query validation failed"
}

{
  "status": "error",
  "message": "The authorization key provided is either invalid or expired, please try again"
}

{
  "status": "error",
  "message": "Request with this idempotency key is currently processing",
  "error": {
    "code": "IDEMPOTENCY_IN_FLIGHT",
    "details": "Please wait for the original request to complete"
  }
}

{
  "status": "error",
  "message": "Idempotency key reused with different parameters",
  "error": {
    "code": "IDEMPOTENCY_MISMATCH",
    "details": "This idempotency key was already used with different request parameters"
  }
}

{
  "status": "error",
  "message": "An internal error has occurred"
}

Returns detailed information about a specific withdrawal using its unique identifier. Use this endpoint to:

Check the status of a specific withdrawal
Retrieve the blockchain transaction hash once available
View actor metadata (initiator email, comments) on a withdrawal record
Look up payment reference data (e.g. Fedwire IMAD)

Payment-method-specific metadata in paymentDetails. The withdrawal record includes an optional paymentDetails object that carries payment-rail-specific identifiers. For USD FEDWIRE withdrawals this looks like { "FEDWIRE": { "imad": "20240315B1QGC07C002345", "omad": "..." } }. The field is null for methods that don’t surface such data, and the same shape is also exposed on each entry of statusHistory[].paymentDetails so you can see when an identifier first appeared in the withdrawal’s lifecycle.

Errors

Status	Message	Notes
400	`Query validation failed`	Request didn’t match schema, or `withdrawalId` not found (v2 surfaces lookup misses as 400)
401	`The authorization key provided is either invalid or expired, please try again`	Mint a fresh JWT — see Authentication
409	`Request with this idempotency key is currently processing`	See Errors → Idempotency
422	`Idempotency key reused with different parameters`	New body → new key
500	`An internal error has occurred`	Server fault; retry with backoff

See the full v2 error reference for retry semantics and idempotency-specific codes.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgId

string

required

withdrawalId

string

required

Response

success

status

enum<string>

Available options:

success,

error

Example:

"success"

data

object

Show child attributes

message

string

Example:

"Data fetched successfully"

⌘I

Overview

Market Data

Balances

Trade

Deposits

Withdrawals

Get withdrawal by ID

Errors

Authorizations

Path Parameters

Response

​Errors

Authorizations

Path Parameters

Response

Errors