Estimate delivery dates

POST

tools

delivery-eta

const options = {
  method: 'POST',
  headers: {
    'Melio-Entity-Id': '<melio-entity-id>',
    'api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    originatingAccountId: 'acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301',
    receivingAccountId: 'acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d',
    amount: 125000,
    deductionDate: '2026-07-10'
  })
};

fetch('https://api.melio.com/v2/tools/delivery-eta', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.melio.com/v2/tools/delivery-eta"

payload = {
    "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
    "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "amount": 125000,
    "deductionDate": "2026-07-10"
}
headers = {
    "Melio-Entity-Id": "<melio-entity-id>",
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.melio.com/v2/tools/delivery-eta \
  --header 'Content-Type: application/json' \
  --header 'Melio-Entity-Id: <melio-entity-id>' \
  --header 'api-key: <api-key>' \
  --data '
{
  "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "amount": 125000,
  "deductionDate": "2026-07-10"
}
'

HttpResponse<String> response = Unirest.post("https://api.melio.com/v2/tools/delivery-eta")
  .header("Melio-Entity-Id", "<melio-entity-id>")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"originatingAccountId\": \"acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301\",\n  \"receivingAccountId\": \"acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n  \"amount\": 125000,\n  \"deductionDate\": \"2026-07-10\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/tools/delivery-eta")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Melio-Entity-Id"] = '<melio-entity-id>'
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"originatingAccountId\": \"acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301\",\n  \"receivingAccountId\": \"acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n  \"amount\": 125000,\n  \"deductionDate\": \"2026-07-10\"\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.melio.com/v2/tools/delivery-eta"

	payload := strings.NewReader("{\n  \"originatingAccountId\": \"acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301\",\n  \"receivingAccountId\": \"acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n  \"amount\": 125000,\n  \"deductionDate\": \"2026-07-10\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Melio-Entity-Id", "<melio-entity-id>")
	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "amount": 125000,
  "currency": "USD",
  "deductionDate": "2026-07-10",
  "estimates": [
    {
      "deliveryPreference": "standard-ach",
      "deliveryDate": "2026-07-14"
    },
    {
      "deliveryPreference": "same-day-ach",
      "deliveryDate": "2026-07-10"
    },
    {
      "deliveryPreference": "rtp",
      "deliveryDate": "2026-07-10"
    }
  ]
}

Authorizations

api-key

string

header

required

Headers

Melio-Entity-Id

string

required

Entity the request operates on — an entity id (ent_<uuid>) or me (the partner's sole entity).

Body

application/json

originatingAccountId

string

required

Internal originating account id (acct_), the debit account

receivingAccountId

string

required

External receiving account id (acct_), the credit account

amount

integer

required

The prospective payment amount to estimate for, in minor units (cents).

deductionDate

string<date>

The debit/schedule date the estimate is based on. Defaults to the current date when omitted.

currency

string

default:USD

Response

Estimated delivery dates, one per delivery preference for the receiving rail.

originatingAccountId

string

required

receivingAccountId

string

required

amount

integer

required

Echoes the requested payment amount, minor units (cents).

currency

string

required

deductionDate

string<date>

required

The debit/schedule date the estimates are based on.

estimates

object[]

required

One entry per delivery preference valid for the receiving external account. Empty when the rail has no valid preferences.

Hide child attributes

estimates.deliveryPreference

enum<string>

required

A delivery preference valid for the receiving external account and the originating account's funding type.

Available options:

standard-ach,

same-day-ach,

rtp,

standard-check,

express-check,

overnight-check,

domestic-wire,

instant-domestic-wire,

virtual-card,

instant-virtual-card,

counterparty-choice,

international-fx,

fast-international-fx,

international-gusd

estimates.deliveryDate

string<date>

The estimated date the funds would be delivered for this delivery preference. Absent when no date can be estimated for the preference.

Estimate delivery dates

const options = {
  method: 'POST',
  headers: {
    'Melio-Entity-Id': '<melio-entity-id>',
    'api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    originatingAccountId: 'acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301',
    receivingAccountId: 'acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d',
    amount: 125000,
    deductionDate: '2026-07-10'
  })
};

fetch('https://api.melio.com/v2/tools/delivery-eta', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.melio.com/v2/tools/delivery-eta"

payload = {
    "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
    "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "amount": 125000,
    "deductionDate": "2026-07-10"
}
headers = {
    "Melio-Entity-Id": "<melio-entity-id>",
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.melio.com/v2/tools/delivery-eta \
  --header 'Content-Type: application/json' \
  --header 'Melio-Entity-Id: <melio-entity-id>' \
  --header 'api-key: <api-key>' \
  --data '
{
  "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "amount": 125000,
  "deductionDate": "2026-07-10"
}
'

HttpResponse<String> response = Unirest.post("https://api.melio.com/v2/tools/delivery-eta")
  .header("Melio-Entity-Id", "<melio-entity-id>")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"originatingAccountId\": \"acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301\",\n  \"receivingAccountId\": \"acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n  \"amount\": 125000,\n  \"deductionDate\": \"2026-07-10\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/tools/delivery-eta")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Melio-Entity-Id"] = '<melio-entity-id>'
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"originatingAccountId\": \"acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301\",\n  \"receivingAccountId\": \"acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n  \"amount\": 125000,\n  \"deductionDate\": \"2026-07-10\"\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.melio.com/v2/tools/delivery-eta"

	payload := strings.NewReader("{\n  \"originatingAccountId\": \"acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301\",\n  \"receivingAccountId\": \"acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n  \"amount\": 125000,\n  \"deductionDate\": \"2026-07-10\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Melio-Entity-Id", "<melio-entity-id>")
	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "amount": 125000,
  "currency": "USD",
  "deductionDate": "2026-07-10",
  "estimates": [
    {
      "deliveryPreference": "standard-ach",
      "deliveryDate": "2026-07-14"
    },
    {
      "deliveryPreference": "same-day-ach",
      "deliveryDate": "2026-07-10"
    },
    {
      "deliveryPreference": "rtp",
      "deliveryDate": "2026-07-10"
    }
  ]
}

Entities

Accounts

Attachments

Payments

Tools

Authorizations

Headers

Body

Response