# Initiate withdrawal Initiates a bitcoin withdrawal. The transaction is not completed until it is confirmed by the network it is sent onto. A success response from this endpoint means the transaction was successfully initiated, but does not guarantee completion. Endpoint: POST /v1/withdrawals/bitcoin Version: 0.0.1 Security: apiKey, apiHmac, apiNonce ## Request fields (application/json): - `destination` (string) The bitcoin destination to send funds to. Supported formats: - Bitcoin address (bech32, legacy-segwit, legacy) - Lightning invoice (bolt11) - Lightning address - Lightning LNURL - `amountBtc` (number) The amount to send. This field is required for all destinations except Lightning invoices. If the destination is a Lightning invoice, the amount is derived from the invoice. - `accountId` (string) The ID of the account to send from. If empty, the default account is used. - `isPayment` (boolean) Marks the transaction as a payment. This has consequences for how the transaction is exported for tax purposes. It has no effect on the bitcoin transaction itself. - `description` (string) Free-form text description of the withdrawal. Can be used to correlate with your own systems. - `tfrInfo` (object) The recipient of this transaction, per EU's travel rule. Required for all withdrawals to new destinations. - `tfrInfo.fullName` (string) - `tfrInfo.country` (string) ISO-3166-1 alpha-2 country code - `tfrInfo.address` (string) - `tfrInfo.nin` (string) NIN (national ID number/passport number/driver license number) is only required if the TFR config said so - `tfrInfo.exchange` (string) - `tfrInfo.selfCustody` (boolean) ## Response 200 fields (application/json): - `withdrawalId` (string) The ID of the initiated withdrawal. - `network` (string) Enum: "NETWORK_UNSPECIFIED", "NETWORK_BITCOIN", "NETWORK_LIGHTNING" - `status` (string) The status of the withdrawal. The withdrawal might immediately succeed, if sending to another user of the Bare Bitcoin platform. Enum: "WITHDRAWAL_STATUS_UNSPECIFIED", "WITHDRAWAL_STATUS_PENDING", "WITHDRAWAL_STATUS_COMPLETED", "WITHDRAWAL_STATUS_FAILED"