Morse

Returns the current mid-market exchange rate between two currencies as the number of units of to_currency per one unit of from_currency, with the time it was read. Use it to answer how much one currency is worth in another. It does not say whether Morse can send money in either currency; use list_send_destinations for that. The rate is indicative; show get_started_url as the way to continue in the Morse app, where the rate applied to a transfer is shown before the user confirms.

{
  "type": "object",
  "properties": {
    "from_currency": {
      "type": "string",
      "description": "ISO 4217 code of the currency to convert from, e.g. USD."
    },
    "to_currency": {
      "type": "string",
      "description": "ISO 4217 code of the currency to convert to, e.g. MXN."
    }
  },
  "required": [
    "from_currency",
    "to_currency"
  ],
  "additionalProperties": false
}

Returns the countries, currencies and payment rails a person living in from_country can send money to with Morse when paying someone else's bank account, with the typical delivery time for each. Use it to answer whether Morse can send from one country to another. An empty destinations list means sending to other people's bank accounts is not offered from that country. When the result includes get_started_url, show it to the user as the way to continue in the Morse app.

{
  "type": "object",
  "properties": {
    "from_country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code of the country the sender lives in, e.g. US. If the user has not said where they live, ask them before quoting; do not assume."
    }
  },
  "required": [
    "from_country"
  ],
  "additionalProperties": false
}

Returns an indicative quote for sending money with Morse from a person living in from_country to someone else's bank account in to_country: the amount sent, the fee, the mid-market exchange rate and what the recipient gets. The result includes the total cost of the transfer and the typical delivery time. Use it to answer how much a transfer costs or how much will arrive. Use list_send_destinations first to check the destination is offered. Present the figures as indicative and tell the user to check the final rate and fees in the Morse app, using get_started_url.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount to send, in from_currency, e.g. 250 or 99.50."
    },
    "from_country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code of the country the sender lives in, e.g. US. If the user has not said where they live, ask them before quoting; do not assume."
    },
    "to_country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code of the country of the recipient's bank account, e.g. MX."
    },
    "from_currency": {
      "type": "string",
      "description": "ISO 4217 code of the currency the sender pays in. Defaults to the currency of from_country."
    },
    "to_currency": {
      "type": "string",
      "description": "ISO 4217 code of the currency the recipient receives. Defaults to the currency Morse pays out in to_country."
    }
  },
  "required": [
    "amount",
    "from_country",
    "to_country"
  ],
  "additionalProperties": false
}