Skip to main content
GET
/
autoramps
/
{external_id}
/
external
Get an Autoramp by external ID
curl --request GET \
  --url https://api.sandbox.iron.xyz/api/autoramps/{external_id}/external \
  --header 'X-API-Key: <api-key>'
{
  "created_at": "2023-11-07T05:31:56Z",
  "deposit_rails": [
    {
      "address": "10 Downing Street, London, SW1A 2AA, GB",
      "beneficiary_name": "Alan Turing",
      "bic": "COBADEFFXXX",
      "iban": "DE89370400440532013000",
      "name": "Iron Bank",
      "phone": "+44-20-1234-5678"
    }
  ],
  "destination_currency": {
    "blockchain": "Solana",
    "token": "USDC"
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_third_party": true,
  "recipient": {
    "account_identifier": {
      "iban": "DE89370400440532013000",
      "type": "SEPA"
    },
    "address": {
      "city": "London",
      "country": {
        "code": "GB"
      },
      "postal_code": "SW1A 2AA",
      "state": "England",
      "street": "10 Downing Street"
    },
    "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"
    }
  },
  "source": "Standalone",
  "source_currencies": [
    {
      "blockchain": "Solana",
      "token": "USDC"
    }
  ],
  "status": "Created",
  "additional_partner_fee_in_bips": "<string>",
  "deposit_account": {
    "address": "10 Downing Street, London, SW1A 2AA, GB",
    "beneficiary_name": "Alan Turing",
    "bic": "COBADEFFXXX",
    "iban": "DE89370400440532013000",
    "name": "Iron Bank",
    "phone": "+44-20-1234-5678"
  },
  "external_id": "<string>",
  "name": "<string>",
  "quote": {
    "amount_in": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "amount_out": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "fee": {
      "banking_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "iron_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "network_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "network_fees": [
        {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        }
      ],
      "network_fees_with_settlement": [
        {
          "fee_amount": {
            "amount": "100.5",
            "currency": {
              "code": "USD",
              "type": "Fiat"
            }
          },
          "fee_type": "SepaIn",
          "settlement": "deductedImmediately"
        }
      ],
      "partner_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "partner_fees": [
        {
          "fee": {
            "amount": "100.5",
            "currency": {
              "code": "USD",
              "type": "Fiat"
            }
          },
          "label": "<string>",
          "settlement": "deductedImmediately"
        }
      ],
      "total_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "transaction_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "deducted_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "iron_fee_settlement": "deductedImmediately"
    },
    "fee_settlement": "deductedImmediately",
    "partner_fee_settlement": "deductedImmediately",
    "quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "rate": "<string>",
    "rate_expiry_policy": "Return",
    "rate_lock_valid_until": "2023-11-07T05:31:56Z",
    "valid_until": "2023-11-07T05:31:56Z",
    "slippage_tolerance_in_bips": "<string>"
  },
  "travel_address": "<string>",
  "wire_message": "<string>"
}

Authorizations

X-API-Key
string
header
required

API Key

Path Parameters

external_id
string
required

The autoramp external ID

Response

Get autoramp successful

Autoramp

The autoramp response

A Autoramp response

created_at
string<date-time>
required

The created at timestamp

deposit_rails
(IbanDepositInfo · object | AfricanBankTransferDepositInfo · object | PixDepositInfo · object | SpeiDepositInfo · object | MobileMoneyDepositInfo · object | CryptoWallet · object | FpsDepositInfo · object | ChapsDepositInfo · object | ACHDepositInfo · object | WireDepositInfo · object | RtpDepositInfo · object | SwiftDepositInfo · object)[]
required
  • IbanDepositInfo
  • AfricanBankTransferDepositInfo
  • PixDepositInfo
  • SpeiDepositInfo
  • MobileMoneyDepositInfo
  • CryptoWallet
  • FpsDepositInfo
  • ChapsDepositInfo
  • ACHDepositInfo
  • WireDepositInfo
  • RtpDepositInfo
  • SwiftDepositInfo
Example:
{
"address": "10 Downing Street, London, SW1A 2AA, GB",
"beneficiary_name": "Alan Turing",
"bic": "COBADEFFXXX",
"iban": "DE89370400440532013000",
"name": "Iron Bank",
"phone": "+44-20-1234-5678"
}
destination_currency
Crypto · object
required

Currency

Can be either crypto or fiat

  • Crypto
  • Fiat
Example:
{ "blockchain": "Solana", "token": "USDC" }
id
string<uuid>
required

The id of the autoramp

is_third_party
boolean
required

Is this a third party payment (3pp) autoramp

recipient
RecipientBankAccount · object
required

Recipient

The recipient of the payment

  • RecipientBankAccount
  • RecipientWallet
  • RecipientPix
Example:
{
"account_identifier": {
"iban": "DE89370400440532013000",
"type": "SEPA"
},
"address": {
"city": "London",
"country": { "code": "GB" },
"postal_code": "SW1A 2AA",
"state": "England",
"street": "10 Downing Street"
},
"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"
}
}
source
enum<string>
required

Autoramp Source

The source of the autoramp

Available options:
Standalone,
Quote
source_currencies
(Crypto · object | Fiat · object)[]
required

The source currencies

Currency

Can be either crypto or fiat

  • Crypto
  • Fiat
Example:
{ "blockchain": "Solana", "token": "USDC" }
status
enum<string>
required
Available options:
Created,
EditPending,
Authorized,
DepositAccountAdded,
Approved,
Rejected,
Cancelled
additional_partner_fee_in_bips
string<decimal>

The additional partner fee in bips

deposit_account
IbanDepositInfo · object
deprecated

Deprecated, please use the information in the deposit_rails field instead

  • IbanDepositInfo
  • AchWireDepositInfo
  • AfricanBankTransferDepositInfo
  • PixDepositInfo
  • SpeiDepositInfo
  • MobileMoneyDepositInfo
  • CryptoWallet
  • ChapsFpsDepositInfo
Example:
{
"address": "10 Downing Street, London, SW1A 2AA, GB",
"beneficiary_name": "Alan Turing",
"bic": "COBADEFFXXX",
"iban": "DE89370400440532013000",
"name": "Iron Bank",
"phone": "+44-20-1234-5678"
}
external_id
string

External ID for the autoramp, provided by the partner

name
string

The name of the autoramp

quote
AutorampQuote · object

Autoramp Quote

The autoramp quote used to create an autoramp

travel_address
string

The travel rule address for compliance

wire_message
string

reference message for outgoing wire transfers