Inbound quotation

GET {{Environment_URL}}/v2/exchanges/remittance/inbound?currency=USD&value=100000&purposeCode=MAINTENANCE&correspondentId=0

This endpoint generates a detailed quotation for international remittance operations. It provides real-time exchange rates, fee calculations, and amount breakdowns for converting from foreign currencies to Brazilian Real (BRL).

Supported Currencies

The following foreign currencies are available for quotation: USD, EUR, GBP .

Path Params

Attribute	Description	Type	Required
currency	Desired currency to be received	String	Yes
value	Value is given in cents, for example, $ 6,000.00 will be 600000	String	Yes
purposeCode	Available purpose codes are MAINTENANCE, AVAILABILITY and ADSENSE	String	Yes
correspondentId	Your correspondent ID	String	Yes

Purpose Code

Purpose code	Aailable currencies
MAINTENANCE	USD - EUR - GBP
AVAILABILITY	USD - EUR - GBP
ADSENSE	USD

Response

200 OK

{
  "id": "5b957657e5fd6089dd9b16f55ee0d2fa3572598a",
  "correspondentId": 10,
  "purposeCode": "MAINTENANCE",
  "currency": {
    "code": "USD",
    "name": "Dólar Americano",
    "commercialExchangeRate": {
      "value": 55795,
      "divisor": 10000,
      "currency": "BRL",
      "precision": 4,
      "updatedAt": "2025-12-29T17:25:32.000Z"
    },
    "countryFlagUrl": "https://s3.amazonaws.com/simple-exchanges-dev/new-flags/united-states.svg",
    "levelingRate": {
      "value": 55683,
      "divisor": 10000,
      "currency": "BRL",
      "precision": 4
    },
    "maxValue": 500000,
    "minValue": 50,
    "offerUSD": {
      "amount": 1000000000,
      "currency": "USD",
      "precision": 4
    },
    "offer": {
      "value": 100000,
      "divisor": 100,
      "currency": "USD",
      "precision": 2
    },
    "offerWithoutDiscount": {
      "value": 100000,
      "divisor": 100,
      "currency": "USD",
      "precision": 2
    },
    "price": {
      "withoutTaxAndDiscount": {
        "value": 55683,
        "divisor": 10000,
        "currency": "BRL",
        "precision": 4
      },
      "withoutTax": {
        "value": 55683,
        "divisor": 10000,
        "currency": "BRL",
        "precision": 4
      },
      "withTax": {
        "value": 55422,
        "divisor": 10000,
        "currency": "BRL",
        "precision": 4
      },
      "withFutureTax": {
        "value": 55422,
        "divisor": 10000,
        "currency": "BRL",
        "precision": 4
      },
      "withoutDiscount": {
        "value": 55472,
        "divisor": 10000,
        "currency": "BRL",
        "precision": 4
      }
    },
    "spreadPercentage": 0,
    "spreadPercentageWithoutDiscount": 0,
    "spreadMaster": false,
    "minSpreadMaster": 2
  },
  "discounts": {
    "coupon": {
      "id": null,
      "code": null,
      "discount": 0,
      "total": {
        "value": 0,
        "divisor": 100,
        "currency": "BRL",
        "precision": 2
      }
    }
  },
  "tax": {
    "bankFee": {
      "valueUSD": 0.9,
      "total": {
        "value": 500,
        "divisor": 100,
        "currency": "BRL",
        "precision": 2
      }
    },
    "iof": {
      "percentage": 0.38,
      "total": {
        "value": 2116,
        "divisor": 100,
        "currency": "BRL",
        "precision": 2
      }
    }
  },
  "futureTax": {
    "ir": {
      "percentage": 0,
      "total": {
        "value": 0,
        "divisor": 100,
        "currency": "BRL",
        "precision": 2
      }
    }
  },
  "total": {
    "withoutTax": {
      "value": 556834,
      "divisor": 100,
      "currency": "BRL",
      "precision": 2
    },
    "withTax": {
      "value": 554218,
      "divisor": 100,
      "currency": "BRL",
      "precision": 2
    },
    "withFutureTax": {
      "value": 554218,
      "divisor": 100,
      "currency": "BRL",
      "precision": 2
    },
    "withoutDiscount": {
      "value": 554218,
      "divisor": 100,
      "currency": "BRL",
      "precision": 2
    },
    "withoutTaxesAndDiscounts": {
      "value": 556834,
      "divisor": 100,
      "currency": "BRL",
      "precision": 2
    }
  },
  "type": "INBOUND",
  "clamp": "NORMAL",
  "timeToLive": 600,
  "expiresAt": "2026-02-09T01:18:34.000Z",
  "createdAt": "2026-02-09T01:08:34.214Z",
  "miles": {
    "regular": 2217,
    "bonus": 3325
  },
  "metaData": {
    "managerOperation": null
  },
  "provider": "NIUM"
}