API reference
Wallets
Onramp and offramp
Transactions
User signers
Accounts
Create fiat account
Sets up external bank account object for the user through the configured default provider. Requires the user to already be KYC’ed.
POST
/
v1
/
users
/
{user_id}
/
fiat
/
accounts
curl --request POST \
--url https://api.privy.io/v1/users/{user_id}/fiat/accounts \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '{
"provider": "bridge",
"account_owner_name": "<string>",
"bank_name": "<string>",
"currency": "usd",
"iban": {
"account_number": "<string>",
"bic": "<string>",
"country": "<string>"
},
"account": {
"account_number": "<string>",
"routing_number": "<string>",
"checking_or_savings": "checking"
},
"swift": {
"address": {
"street_line_1": "<string>",
"street_line_2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"state": "<string>"
},
"category": "client",
"purpose_of_funds": [
"intra_group_transfer"
],
"short_business_description": "<string>",
"account": {
"account_number": "<string>",
"bic": "<string>",
"country": "<string>"
}
},
"address": {
"street_line_1": "<string>",
"street_line_2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"state": "<string>"
},
"first_name": "<string>",
"last_name": "<string>"
}'
{
"id": "<string>",
"bank_name": "<string>",
"currency": "<string>",
"account_type": "<string>",
"last_4": "<string>"
}
Authorizations
App secret authentication.
Headers
ID of your Privy app.
Path Parameters
The ID of the user to create the fiat account for
Body
application/json
Response
200 - application/json
Created fiat account details
The response is of type object
.
curl --request POST \
--url https://api.privy.io/v1/users/{user_id}/fiat/accounts \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '{
"provider": "bridge",
"account_owner_name": "<string>",
"bank_name": "<string>",
"currency": "usd",
"iban": {
"account_number": "<string>",
"bic": "<string>",
"country": "<string>"
},
"account": {
"account_number": "<string>",
"routing_number": "<string>",
"checking_or_savings": "checking"
},
"swift": {
"address": {
"street_line_1": "<string>",
"street_line_2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"state": "<string>"
},
"category": "client",
"purpose_of_funds": [
"intra_group_transfer"
],
"short_business_description": "<string>",
"account": {
"account_number": "<string>",
"bic": "<string>",
"country": "<string>"
}
},
"address": {
"street_line_1": "<string>",
"street_line_2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"state": "<string>"
},
"first_name": "<string>",
"last_name": "<string>"
}'
{
"id": "<string>",
"bank_name": "<string>",
"currency": "<string>",
"account_type": "<string>",
"last_4": "<string>"
}