v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

Fiat

Create a 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

Path parameters

user_idstring required

The ID of the user to create the fiat account for

Headers

privy-app-idstring required

ID of your Privy app.

Request body

account_owner_namestring required

bank_namestring

currency'usd' | 'eur' required

Supported fiat currencies.

first_namestring

last_namestring

provider'bridge' | 'bridge-sandbox' required

Valid set of onramp providers

Example request

{
  "account": {
    "account_number": "1234567899",
    "checking_or_savings": "checking",
    "routing_number": "121212121"
  },
  "account_owner_name": "John Doe",
  "address": {
    "city": "New York",
    "country": "USA",
    "postal_code": "10001",
    "state": "NY",
    "street_line_1": "123 Washington St",
    "street_line_2": "Apt 2F"
  },
  "bank_name": "Chase",
  "currency": "usd",
  "first_name": "John",
  "last_name": "Doe",
  "provider": "bridge-sandbox"
}

Response

Created fiat account details

account_typestring required

bank_namestring

currencystring required

idstring required

last_4string

Example response

{
  "account_type": "us",
  "bank_name": "Chase",
  "currency": "usd",
  "id": "a068d2dd-743a-4011-9b62-8ad33cc7a7be",
  "last_4": "7899"
}