POST
/api/v2/transfers/user-to-masterCreate a transfer from user to master account
Authentication
Send your API key in the x-api-key header on every request.
Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
| UserId | unknown | Yes | |
| Amount | string | Yes | |
| Currency | string | Yes | |
| Description | string | No | |
| ExternalReferenceId | string | No | |
| Metadata | object | No |
Responses
201 — Created
| Field | Type | Required | Description |
|---|---|---|---|
| Id | unknown | No | |
| UserId | unknown | No | |
| Status | TransferStatusV2 | No | |
| Amount | string | No | |
| Currency | string | No | |
| SourceType | TransferSourceTypeV2 | No | |
| DestinationType | TransferDestinationTypeV2 | No | |
| Description | string | No | |
| ExternalReferenceId | string | No | |
| CreatedAt | string | No | |
| CompletedAt | string | No | |
| UpdatedAt | string | No | |
| Metadata | object | No | |
| TransferType | string | No | Transfer type identifier (e.g., "user_to_master_transfer", "master_to_user_transfer") |
| Message | string | No | Response message for the transfer operation |
| ErrorCode | string | No | Error code if the transfer failed |
| FeeAmount | string | No | Total fee amount charged for this transfer (future implementation) |
| FeeCurrency | string | No | Currency of the fee (future implementation) |
| FeeType | TransferFeeType | No | |
| NetAmount | string | No | Net amount after fees (future implementation) |
400 — Bad Request
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
401 — Unauthorized
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
404 — Not Found
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
500 — Internal Server Error
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
Example request
curl -X POST "https://{base_url}/api/v2/transfers/user-to-master" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"UserId":"…","Amount":"…","Currency":"…"}'This page is generated from the live OpenAPI specification and always matches the current API.