---
title: "Update Fiat Account"
method: PUT
path: "/transfer/fiat-accounts/{id}"
tags: ["Fiat Transfers"]
---

# Update Fiat Account

`PUT /transfer/fiat-accounts/{id}`

Change an existing value or add a new value on one or more fields for the given Fiat Account and return the modified Fiat Account in `PENDING` status.
Update fields in **either** `fiat_account_owner.person_details` or `fiat_account_owner.institution_details`.
Attempts to convert the `fiat_account_owner` type results in an error.
Empty strings or null values are ignored.

Upon successful response, Paxos initiates an automated review of the requested changes and then either sets the status to `APPROVED` or `REJECTED`.
Occasionally, a manual review may be required.
Use [Get Fiat Account](#operation/GetFiatAccount) to check for status changes.

## Path parameters

- `id` string, required

## Request body

- TransferPublicUpdateFiatAccountBody
  - `fiat_account_owner` FiatAccountOwner
    - `person_details` FiatAccountOwnerPersonDetails
      - `first_name` string, required
      - `last_name` string, required
    - `institution_details` FiatAccountOwnerInstitutionDetails
      - `name` string, required
  - `fiat_network_instructions` UpdateFiatAccountRequestUpdateFiatNetworkInstructions
    - `wire` UpdateFiatNetworkInstructionsUpdateWire
      - `fiat_account_owner_address` MailingAddress — A mailing address.
        - `country` string, required
        - `address1` string
        - `address2` string
        - `city` string
        - `province` string
        - `zip_code` string
      - `routing_details` UpdateWireUpdateRoutingDetails
        - `bank_name` string — The name of the bank.
        - `bank_address` MailingAddress — A mailing address.
          - `country` string, required
          - `address1` string
          - `address2` string
          - `city` string
          - `province` string
          - `zip_code` string
      - `intermediary_routing_details` UpdateWireUpdateRoutingDetails
        - `bank_name` string — The name of the bank.
        - `bank_address` MailingAddress — A mailing address.
          - `country` string, required
          - `address1` string
          - `address2` string
          - `city` string
          - `province` string
          - `zip_code` string
  - `metadata` object — Optional client-specified metadata. Up to 6 key/value pairs may be provided. Each key and value must be less than or equal to 100 characters.

## Response `200`

A successful response.

- FiatAccount
  - `id` string, required — The Paxos FiatAccount ID (UUID).
  - `ref_id` string — The optional client-specified ID (for idempotence).
  - `identity_id` string — The Paxos Identity (`identity_id`) of the user's FiatAccount.
  - `account_id` string — The Paxos Account (`account_id`) of the user's FiatAccount. Required only for customers with [3rd-Party integrations](https://docs.paxos.com/crypto-brokerage/ledger-type#fiat-and-crypto-subledger) initiating transfers on behalf of their end users.
  - `fiat_account_owner` FiatAccountOwner
    - `person_details` FiatAccountOwnerPersonDetails
      - `first_name` string, required
      - `last_name` string, required
    - `institution_details` FiatAccountOwnerInstitutionDetails
      - `name` string, required
  - `fiat_network_instructions` FiatNetworkInstructions, required
    - `wire` FiatNetworkInstructionsWire
      - `account_number` string, required — The FiatAccount owner's bank account number.
      - `fiat_account_owner_address` MailingAddress, required — A mailing address.
        - `country` string, required
        - `address1` string
        - `address2` string
        - `city` string
        - `province` string
        - `zip_code` string
      - `routing_details` FiatNetworkInstructionsWireRoutingDetails, required
        - `routing_number_type` 'ABA' | 'SWIFT', required
        - `routing_number` string, required — The routing number.
        - `bank_name` string, required — The name of the bank.
        - `bank_address` MailingAddress, required — A mailing address.
          - `country` string, required
          - `address1` string
          - `address2` string
          - `city` string
          - `province` string
          - `zip_code` string
      - `intermediary_routing_details` FiatNetworkInstructionsWireRoutingDetails
        - `routing_number_type` 'ABA' | 'SWIFT', required
        - `routing_number` string, required — The routing number.
        - `bank_name` string, required — The name of the bank.
        - `bank_address` MailingAddress, required — A mailing address.
          - `country` string, required
          - `address1` string
          - `address2` string
          - `city` string
          - `province` string
          - `zip_code` string
    - `cbit` FiatNetworkInstructionsCbit
      - `wallet_address` string, required — The wallet address of the CBIT account.
    - `dbs_act` FiatNetworkInstructionsDbsAct
      - `account_number` string, required — The account number of the DBS account.
    - `cubix` FiatNetworkInstructionsCubix
      - `account_id` string, required — The uuid account id of the CUBIX account.
    - `scb` FiatNetworkInstructionsScb
      - `account_number` string, required — The account number of the StandChart account.
    - `rtp` FiatNetworkInstructionsRtp
      - `account_number` string, required — The FiatAccount owner's bank account number.
      - `fiat_account_owner_address` MailingAddress — A mailing address.
        - `country` string, required
        - `address1` string
        - `address2` string
        - `city` string
        - `province` string
        - `zip_code` string
      - `routing_details` FiatNetworkInstructionsRtpRoutingDetails, required
        - `routing_number` string, required — The routing number.
        - `bank_name` string — The name of the bank.
        - `bank_address` MailingAddress — A mailing address.
          - `country` string, required
          - `address1` string
          - `address2` string
          - `city` string
          - `province` string
          - `zip_code` string
  - `status` 'PENDING' | 'APPROVED' | 'REJECTED', required
  - `metadata` object — Optional client-specified metadata. Up to 6 key/value pairs may be returned. Each key and value must be less than or equal to 100 characters.
  - `created_at` string, date-time, required — The time at which this FiatAccount was created.
  - `updated_at` string, date-time — The time at which this FiatAccount record was most recently updated.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/versions/0687ca8c9a8d/schema)