> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iron.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a specific fiat address

> Get a specific fiat address by customer ID and address ID




## OpenAPI

````yaml /spec.yaml get /addresses/fiat/{customer_id}/{fiat_address_id}
openapi: 3.1.0
info:
  description: The Stablecoin Payment Network
  title: Iron API - Sandbox
  version: 1.0-17078
servers:
  - url: https://api.sandbox.iron.xyz/api
security: []
tags:
  - description: >-
      Wallet and bank account registration


      Every wallet address that interacts with Iron must be registered (linked)
      to a customer **before** it can be used in any flow — onramp, offramp, or
      swap. This is a regulatory requirement under the **Travel Rule**, which
      obliges Virtual Asset Service Providers to exchange originator and
      beneficiary information for crypto transfers.


      Iron supports two wallet types:


      - **Self-hosted wallets** — the customer controls the private key.
      Registration requires a signed proof-of-ownership message.

      - **Hosted wallets** — the wallet is custodied by another VASP (e.g.
      Coinbase, Kraken). Registration requires the VASP's DID so Iron can
      exchange travel-rule data with the custodian.


      Similarly, fiat bank accounts must be registered before they can receive
      offramp payouts.
    name: Addresses
  - description: Operations on Autoramp
    name: Autoramp
  - description: Operations on Chronicle collateral
    name: ChronicleCollateral
  - description: Operations on Currencies
    name: Currencies
  - description: Operations on Customers
    name: Customer
  - description: Operations on Exchange Rate
    name: ExchangeRate
  - description: Operations on Fee Profiles
    name: FeeProfiles
  - description: Operations for Sandbox Testing
    name: Sandbox
  - description: Operations on SSE
    name: Sse
  - description: Operations on Terms and Conditions
    name: TermsAndConditions
  - description: Operations on Webhooks
    name: Webhooks
paths:
  /addresses/fiat/{customer_id}/{fiat_address_id}:
    get:
      tags:
        - Addresses
      summary: Get a specific fiat address
      description: |
        Get a specific fiat address by customer ID and address ID
      operationId: getFiatAddress
      parameters:
        - deprecated: false
          description: >-
            Optional sub-partner UUID, if provided, the customer will be
            verified against the sub-partner
          explode: true
          in: header
          name: X-SUB-PARTNER-ID
          required: false
          schema:
            type: string
        - deprecated: false
          description: the ID of the customer
          explode: true
          in: path
          name: customer_id
          required: true
          schema:
            format: uuid
            type: string
        - deprecated: false
          description: the ID of the fiat address
          explode: true
          in: path
          name: fiat_address_id
          required: true
          schema:
            format: uuid
            type: string
        - $ref: '#/components/parameters/XApiVersion'
      responses:
        '200':
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/FiatAddress'
          description: GET Address Succeeded
        '404':
          content:
            application/json; charset=utf-8:
              schema:
                type: string
          description: GET Address Failed (Not Found)
        '500':
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: GET Address Failed (Internal Server Error)
      security:
        - ApiKeyAuth: []
components:
  parameters:
    XApiVersion:
      description: >-
        Selects the API version for this request, as an ISO date (`YYYY-MM-DD`).
        Omit to use the default version (`2025-03-13`). Supported versions:
        2025-03-13, 2026-07-01.
      in: header
      name: X-API-Version
      required: false
      schema:
        type: string
  schemas:
    FiatAddress:
      description: |
        Fiat Address

        Response containing fiat address details
      example:
        bank_account_identifier:
          iban: DE89370400440532013000
          type: SEPA
        bank_details:
          account_identifier:
            iban: DE89370400440532013000
            type: SEPA
          address:
            city: London
            country:
              code: GB
            postal_code: SW1A 2AA
            state: England
            street: 10 Downing Street
          bank_address: null
          email_address:
            email: john.doe@example.com
          is_third_party: false
          phone_number: +49-30-12345678
          provider_country:
            code: DE
          provider_name: Iron Bank
          recipient:
            name: Aperture Science
            type: Business
        bank_name: Iron Bank
        country: DE
        created_at: '2024-01-15T10:30:00.000Z'
        currency: EUR
        customer_id: 123e4567-e89b-12d3-a456-426614174000
        id: 550e8400-e29b-41d4-a716-446655440000
        is_third_party: false
        label: Primary Business Account
        ownership_verified: true
        status: Registered
        updated_at: '1970-01-01T00:00:00.000Z'
      properties:
        bank_account_identifier:
          $ref: '#/components/schemas/BankAccountIdentifier'
        bank_details:
          $ref: '#/components/schemas/RecipientBankAccount'
        bank_name:
          description: The bank name
          type: string
        country:
          description: The country code
          type: string
        created_at:
          description: When the address was created
          format: date-time
          type: string
        currency:
          description: The currency of the bank account
          type: string
        customer_id:
          description: The customer ID
          format: uuid
          type: string
        id:
          description: The ID of the address
          format: uuid
          type: string
        is_third_party:
          description: Is this a third party fiat address
          type: boolean
        label:
          description: Optional label for the address
          type: string
        ownership_verified:
          description: Has the customer verified their ownership of this account
          type: boolean
        status:
          $ref: '#/components/schemas/FiatAddressStatus'
        updated_at:
          description: When the address was last updated
          format: date-time
          type: string
      required:
        - id
        - created_at
        - updated_at
        - customer_id
        - bank_details
        - status
        - currency
        - bank_account_identifier
        - country
        - bank_name
        - ownership_verified
        - is_third_party
      title: FiatAddress
      type: object
    ApiError:
      description: |-
        Standard error response returned to API clients for server errors.
        Includes a trace_id that clients can reference when reporting issues.
      properties:
        message:
          description: Human-readable error message
          type: string
        trace_id:
          description: Trace ID that can be used to look up request details in logs
          type: string
      required:
        - message
        - trace_id
      title: ApiError
      type: object
    BankAccountIdentifier:
      anyOf:
        - $ref: '#/components/schemas/BankAccountIdentifier_Iban'
        - $ref: '#/components/schemas/BankAccountIdentifier_BankAccountACHIdentifier'
        - $ref: '#/components/schemas/BankAccountIdentifier_BankAccountWireIdentifier'
        - $ref: '#/components/schemas/BankAccountIdentifier_BankAccountRTPIdentifier'
        - $ref: >-
            #/components/schemas/BankAccountIdentifier_BankAccountFedNowIdentifier
        - $ref: >-
            #/components/schemas/BankAccountIdentifier_BankAccountSWIFTIdentifier
        - $ref: >-
            #/components/schemas/BankAccountIdentifier_BankAccountCHAPSIdentifier
        - $ref: '#/components/schemas/BankAccountIdentifier_BankAccountFPSIdentifier'
      discriminator:
        mapping:
          ACH:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountACHIdentifier
          CHAPS:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountCHAPSIdentifier
          FEDNOW:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountFedNowIdentifier
          FPS:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountFPSIdentifier
          RTP:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountRTPIdentifier
          SEPA:
            $ref: '#/components/schemas/BankAccountIdentifier_Iban'
          SWIFT:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountSWIFTIdentifier
          Wire:
            $ref: >-
              #/components/schemas/BankAccountIdentifier_BankAccountWireIdentifier
        propertyName: type
      type: object
    RecipientBankAccount:
      description: |
        RecipientBankAccount

        A recipient fiat bank account
      example:
        account_identifier:
          iban: DE89370400440532013000
          type: SEPA
        address:
          city: London
          country:
            code: GB
          postal_code: SW1A 2AA
          state: England
          street: 10 Downing Street
        bank_address: null
        email_address:
          email: john.doe@example.com
        is_third_party: false
        phone_number: +49-30-12345678
        provider_country:
          code: DE
        provider_name: Iron Bank
        recipient:
          name: Aperture Science
          type: Business
      properties:
        account_identifier:
          $ref: '#/components/schemas/BankAccountIdentifier'
        address:
          $ref: '#/components/schemas/RecipientPostalAddress'
        bank_address:
          $ref: '#/components/schemas/BankPostalAddress'
        email_address:
          $ref: '#/components/schemas/EmailAddress'
        is_third_party:
          description: Is this a users fiat bank account or a third party fiat bank account
          type: boolean
        phone_number:
          description: The recipient's phone number. Required for USD accounts.
          type: string
        provider_country:
          $ref: '#/components/schemas/Country'
        provider_name:
          description: The name of the provider of the recipient's account
          type: string
        recipient:
          $ref: '#/components/schemas/RecipientName'
      required:
        - recipient
        - provider_name
        - provider_country
        - account_identifier
        - address
        - is_third_party
      title: RecipientBankAccount
      type: object
    FiatAddressStatus:
      description: |
        Verification Status

        The status of the verification of a fiat address
      enum:
        - AuthorizationRequired
        - AuthorizationFailed
        - RegistrationPending
        - RegistrationFailed
        - Registered
      type: string
    BankAccountIdentifier_Iban:
      allOf:
        - properties:
            type:
              enum:
                - SEPA
              example: SEPA
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/Iban'
    BankAccountIdentifier_BankAccountACHIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - ACH
              example: ACH
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountACHIdentifier'
    BankAccountIdentifier_BankAccountWireIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - Wire
              example: Wire
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountWireIdentifier'
    BankAccountIdentifier_BankAccountRTPIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - RTP
              example: RTP
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountRTPIdentifier'
    BankAccountIdentifier_BankAccountFedNowIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - FEDNOW
              example: FEDNOW
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountFedNowIdentifier'
    BankAccountIdentifier_BankAccountSWIFTIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - SWIFT
              example: SWIFT
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountSWIFTIdentifier'
    BankAccountIdentifier_BankAccountCHAPSIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - CHAPS
              example: CHAPS
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountCHAPSIdentifier'
    BankAccountIdentifier_BankAccountFPSIdentifier:
      allOf:
        - properties:
            type:
              enum:
                - FPS
              example: FPS
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BankAccountFPSIdentifier'
    RecipientPostalAddress:
      description: |-
        RecipientPostalAddress

        The account holder's address.
      properties:
        city:
          description: The city
          maxLength: 100
          minLength: 2
          type: string
        country:
          $ref: '#/components/schemas/Country'
        postal_code:
          description: The postal code
          maxLength: 20
          minLength: 3
          type: string
        state:
          description: The state
          type: string
        street:
          description: The street address
          maxLength: 256
          minLength: 2
          type: string
      required:
        - street
        - city
        - state
        - country
        - postal_code
      title: RecipientPostalAddress
      type: object
    BankPostalAddress:
      description: |-
        BankPostalAddress

        The bank's address. Only required for SWIFT accounts.
      properties:
        city:
          description: The city
          maxLength: 100
          minLength: 2
          type: string
        country:
          $ref: '#/components/schemas/Country'
        postal_code:
          description: The postal code
          maxLength: 20
          minLength: 3
          type: string
        state:
          description: The state
          type: string
        street:
          description: The street address
          maxLength: 256
          minLength: 2
          type: string
      required:
        - street
        - city
        - state
        - country
        - postal_code
      title: BankPostalAddress
      type: object
    EmailAddress:
      description: |
        EmailAddress

        An email address
        An email address
      example:
        email: john.doe@example.com
      properties:
        email:
          description: The email address
          type: string
      required:
        - email
      title: EmailAddress
      type: object
    Country:
      description: A country
      example:
        code: DE
      properties:
        code:
          description: The ISO_3166-1 Alpha-2 country code, e.g. "DE"
          maxLength: 2
          minLength: 2
          type: string
      required:
        - code
      title: Country
      type: object
    RecipientName:
      anyOf:
        - $ref: '#/components/schemas/RecipientName_IndividualName'
        - $ref: '#/components/schemas/RecipientName_BusinessName'
      discriminator:
        mapping:
          Business:
            $ref: '#/components/schemas/RecipientName_BusinessName'
          Individual:
            $ref: '#/components/schemas/RecipientName_IndividualName'
        propertyName: type
      type: object
    Iban:
      example:
        iban: DE89370400440532013000
      properties:
        iban:
          type: string
      required:
        - iban
      title: Iban
      type: object
    BankAccountACHIdentifier:
      example:
        account_number: '123456789'
        routing_number: '021000021'
      properties:
        account_number:
          description: US account number (4-17 alphanumeric characters)
          pattern: ^[0-9A-Z]{4,17}$
          type: string
        routing_number:
          description: US routing number (exactly 9 digits)
          pattern: ^[0-9]{9}$
          type: string
      required:
        - routing_number
        - account_number
      title: BankAccountACHIdentifier
      type: object
    BankAccountWireIdentifier:
      example:
        account_number: '987654321'
        routing_number: '021000021'
      properties:
        account_number:
          description: US account number (4-17 alphanumeric characters)
          pattern: ^[0-9A-Z]{4,17}$
          type: string
        routing_number:
          description: US routing number (exactly 9 digits)
          pattern: ^[0-9]{9}$
          type: string
      required:
        - routing_number
        - account_number
      title: BankAccountWireIdentifier
      type: object
    BankAccountRTPIdentifier:
      example:
        account_number: '456789123'
        routing_number: '021000021'
      properties:
        account_number:
          description: US account number (4-17 alphanumeric characters)
          pattern: ^[0-9A-Z]{4,17}$
          type: string
        routing_number:
          description: US routing number (exactly 9 digits)
          pattern: ^[0-9]{9}$
          type: string
      required:
        - routing_number
        - account_number
      title: BankAccountRTPIdentifier
      type: object
    BankAccountFedNowIdentifier:
      example:
        account_number: '456789123'
        routing_number: '021000021'
      properties:
        account_number:
          description: US account number (4-17 alphanumeric characters)
          pattern: ^[0-9A-Z]{4,17}$
          type: string
        routing_number:
          description: US routing number (exactly 9 digits)
          pattern: ^[0-9]{9}$
          type: string
      required:
        - routing_number
        - account_number
      title: BankAccountFedNowIdentifier
      type: object
    BankAccountSWIFTIdentifier:
      example:
        account_number: '1234567890'
        bic: CHASUS33XXX
      properties:
        account_number:
          type: string
        bic:
          type: string
        intermediary_bic:
          description: >-
            BIC of an intermediary correspondent bank in the SWIFT routing
            chain,

            when the sender wants to override the auto-selected intermediary.

            Optional — most senders leave this unset and let their provider
            pick.
          type: string
      required:
        - bic
        - account_number
      title: BankAccountSWIFTIdentifier
      type: object
    BankAccountCHAPSIdentifier:
      example:
        account_number: '12345678'
        sort_code: 20-00-00
      properties:
        account_number:
          type: string
        sort_code:
          type: string
      required:
        - sort_code
        - account_number
      title: BankAccountCHAPSIdentifier
      type: object
    BankAccountFPSIdentifier:
      example:
        account_number: '55779911'
        sort_code: 20-00-00
      properties:
        account_number:
          type: string
        sort_code:
          type: string
      required:
        - sort_code
        - account_number
      title: BankAccountFPSIdentifier
      type: object
    RecipientName_IndividualName:
      allOf:
        - properties:
            type:
              enum:
                - Individual
              example: Individual
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/IndividualName'
    RecipientName_BusinessName:
      allOf:
        - properties:
            type:
              enum:
                - Business
              example: Business
              type: string
          required:
            - type
          type: object
        - $ref: '#/components/schemas/BusinessName'
    IndividualName:
      example:
        family_name: Turing
        given_name: Alan
      properties:
        family_name:
          maxLength: 50
          minLength: 1
          type: string
        given_name:
          maxLength: 50
          minLength: 1
          type: string
      required:
        - given_name
        - family_name
      title: IndividualName
      type: object
    BusinessName:
      example:
        name: Aperture Science
      properties:
        name:
          maxLength: 50
          minLength: 1
          type: string
      required:
        - name
      title: BusinessName
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: API Key
      in: header
      name: X-API-Key
      type: apiKey

````