Documentation Index Fetch the complete documentation index at: https://apidocs.bridge.xyz/llms.txt
Use this file to discover all available pages before exploring further.
To access GBP and the FPS payment rail, please reach out to our team at sales@bridge.xyz 🇬🇧 What we support
Virtual Accounts - Deposit GBP via Faster Payments and receive payments from 3rd party businesses.Transfers - Onramp GBP via Faster Payments as a 1st party or from 3rd party businesses, offramp to any recipient.Liquidation Addresses - Offramps from stablecoin or crypto to GBP via Faster Payments.Supported Countries - We support GBP on/offramps for customers in +100 countries.
Logistics
Onramp minimum £2.00 GBP Offramp minimum 3.00 of the source currency No maximum, transfers received or sent over £1M GBP will use the BACS payment rail.
1st and 3rd party payouts supported
1st party payins supported, 3rd party payins supported from businesses.
Faster Payments complete in ~5 minutes however may take up to 30 minutes for larger values.
BACS payments complete in 3 business days.
Request / Response Examples External Account
Virtual Account
Transfer Onramp
Transfer Offramp
curl --request POST \ --url https://api.bridge.xyz/v0/customers/#{request.customer_id}/external_accounts \ --header 'Api-Key: #{api_key}' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: #{request.idempotency_key}' \ --data ' { "currency": "gbp", "bank_name": "Bank of England", "account_owner_name": "First Last", "first_name": "First", "last_name": "Last", "account_owner_type": "individual", "account": { "sort_code": "123456", "account_number": "34567890" }, "account_type": "gb" }'
{ "id" : "bce9dbe4-bca7-42e0-9cc1-7482069019f1" , "customer_id" : "485c2b50-949c-412b-928a-f56fce42330d" , "created_at" : "2026-01-05T23:54:57.715Z" , "updated_at" : "2026-01-05T23:54:58.201Z" , "bank_name" : "Bank of England" , "account_name" : null , "account_owner_name" : "Freddie Mercury" , "active" : true , "currency" : "gbp" , "account_owner_type" : "individual" , "account_type" : "gb" , "first_name" : "Freddie" , "last_name" : "Mercury" , "business_name" : null , "account" : { "sort_code" : "123456" , "account_number" : "34567890" }
curl --request POST \ --url https://api.bridge.xyz/v0/customers/#{request.customer_id}/virtual_accounts \ --header 'Api-Key: #{api_key}' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: #{request.idempotency_key}' \ --data ' { "developer_fee_percent": "0.0", "source": { "currency": "gbp" }, "destination": { "currency": "usdc", "payment_rail": "base", "bridge_wallet_id": "#{request.bridge_wallet_id}" } }'
{ "id": "65e93b85-ccf7-4c0b-a327-0cf80749e360", "status": "activated", "developer_fee_percent": "0.0", "customer_id": "485c2b50-949c-412b-928a-f56fce42330d", "created_at": "2026-01-03T00:23:23.724Z", "source_deposit_instructions": { "currency": "gbp", "account_number": "34567890", "sort_code": "123456", "account_holder_name": "Bridge Building Sp. Z.o.o.", "bank_name": "Banking Circle S.A.", "bank_address": "2 Boulevard de la Foire, L-1528 Luxembourg", "bank_beneficiary_name": "Bridge Building Sp. Z.o.o.", "bank_beneficiary_address": "2 Boulevard de la Foire, L-1528 Luxembourg", "payment_rails": [ "faster_payments" ] }, "destination": { "currency": "usdc", "payment_rail": "base", "address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c" } }'
curl --request POST \ --url https://api.bridge.xyz/v0/transfers \ --header 'Api-Key: #{api_key}' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: #{request.idempotency_key}' \ --data ' { "developer_fee_percent": "0.0", "on_behalf_of": "#{request.customer_id}", "amount": "2.01", "source": { "currency": "gbp", "payment_rail": "faster_payments" }, "destination": { "currency": "usdc", "payment_rail": "base", "bridge_wallet_id": "#{request.bridge_wallet_id}" } }'
{ "id" : "6ccbd781-8859-4944-8d88-66d8a0ff277b" , "client_reference_id" : null , "state" : "awaiting_funds" , "on_behalf_of" : "485c2b50-949c-412b-928a-f56fce42330d" , "currency" : "gbp" , "amount" : "2.01" , "developer_fee" : "0.0" , "source" : { "payment_rail" : "faster_payments" , "currency" : "gbp" , "external_account_id" : null }, "created_at" : "2026-01-05T19:38:43.480Z" , "updated_at" : "2026-01-05T19:38:43.780Z" , "destination" : { "payment_rail" : "base" , "currency" : "usdc" , "to_address" : "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c" }, "receipt" : { "initial_amount" : "2.01" , "developer_fee" : "0.0" , "exchange_fee" : "0.0" , "subtotal_amount" : "2.01" , "gas_fee" : "0.0" }, "developer_fee_percent" : "0.0" , "source_deposit_instructions" : { "payment_rail" : "faster_payments" , "currency" : "gbp" , "amount" : "2.01" , "deposit_message" : "BRGTPU5UDJWN4KW5PJM6" , "account_number" : "34567890" , "sort_code" : "123456" , "bank_name" : "Banking Circle S.A." , "bank_address" : "2 Boulevard de la Foire, L-1528 Luxembourg" } }
curl --request POST \ --url https://api.bridge.xyz/v0/transfers \ --header 'Api-Key: #{api_key}' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: #{request.idempotency_key}' \ --data ' { "developer_fee_percent": "0.0", "on_behalf_of": "#{request.customer_id}", "source": { "currency": "usdc", "payment_rail": "bridge_wallet", "bridge_wallet_id": "#{request.bridge_wallet_id}" }, "destination": { "amount": "3.00", "currency": "gbp", "payment_rail": "faster_payments", "external_account_id": "#{request.external_account_id}" "reference": "abcdefghijklmnopqr" // maximum 18 characters } }'
{ "id" : "e94b1961-cf77-44db-a66f-07981f03fb1f" , "client_reference_id" : null , "state" : "payment_submitted" , "on_behalf_of" : "485c2b50-949c-412b-928a-f56fce42330d" , "currency" : "usd" , "amount" : "4.12" , "developer_fee" : "0.0" , "source" : { "payment_rail" : "bridge_wallet" , "currency" : "usdc" , "amount" : "4.12" , "from_address" : "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c" , "bridge_wallet_id" : "d017bf1d-8372-4294-94ac-afd0cbc6357d" }, "created_at" : "2026-01-06T17:29:22.796Z" , "updated_at" : "2026-01-06T17:29:22.874Z" , "destination" : { "payment_rail" : "faster_payments" , "currency" : "gbp" , "amount" : "3.0" , "external_account_id" : "bce9dbe4-bca7-42e0-9cc1-7482069019f1" }, "receipt" : { "initial_amount" : "4.12" , "developer_fee" : "0.0" , "exchange_fee" : "0.0" , "subtotal_amount" : "4.12" , "gas_fee" : "0.0" }, "developer_fee_percent" : "0.0" }
