List payments

GET

payments

List payments

const options = {
  method: 'GET',
  headers: {'Melio-Entity-Id': '<melio-entity-id>', 'api-key': '<api-key>'}
};

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

import requests

url = "https://api.melio.com/v2/payments"

headers = {
    "Melio-Entity-Id": "<melio-entity-id>",
    "api-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/payments")

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

request = Net::HTTP::Get.new(url)
request["Melio-Entity-Id"] = '<melio-entity-id>'
request["api-key"] = '<api-key>'

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

package main

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

func main() {

	url := "https://api.melio.com/v2/payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Melio-Entity-Id", "<melio-entity-id>")
	req.Header.Add("api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "hasMore": true,
  "data": [
    {
      "id": "pay_9f8c7b6a5d4e3f21",
      "externalId": "invoice-2043",
      "amount": 125000,
      "currency": "USD",
      "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
      "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "deductionDate": "2026-07-10",
      "deliveryDate": "2026-07-14",
      "status": "scheduled",
      "metadata": {
        "invoiceId": "INV-2043",
        "department": "operations"
      },
      "createdAt": "2026-07-08T15:04:05Z",
      "updatedAt": "2026-07-08T15:04:05Z"
    },
    {
      "id": "pay_1a2b3c4d5e6f7a8b",
      "externalId": "invoice-2041",
      "amount": 4200,
      "currency": "USD",
      "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
      "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "deductionDate": "2026-07-09",
      "deliveryDate": "2026-07-11",
      "status": "completed",
      "metadata": {},
      "createdAt": "2026-07-07T09:22:00Z",
      "updatedAt": "2026-07-07T09:22:00Z"
    }
  ]
}

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).

Query Parameters

limit

integer

default:50

Maximum number of resources to return, 1 to 50. Defaults to 50.

Required range: 1 <= x <= 50

startingAfter

string

Cursor for forward (older) pagination: a resource id. The page returned starts immediately after this resource. Mutually exclusive with endingBefore.

endingBefore

string

Cursor for backward (newer) pagination: a resource id. The page returned ends immediately before this resource. Mutually exclusive with startingAfter.

externalId

string

Return only the payment whose externalId matches (your own id).

status

enum<string>

Filter by payment status.

Available options:

scheduled,

in-progress,

completed,

failed,

canceled

originatingAccountId

string

Return only payments drawn from this internal originating account (acct_).

receivingAccountId

string

Return only payments sent to this external receiving account (acct_).

created[gte]

string<date-time>

Return payments created at or after this RFC 3339 timestamp.

created[lte]

string<date-time>

Return payments created at or before this RFC 3339 timestamp.

metadata

object

Filter by metadata key/value pairs, e.g. metadata[invoiceId]=INV-42. Matches payments whose metadata contains every supplied pair.

Hide child attributes

metadata.{key}]

string

Response

A page of payments, newest first.

data

object[]

required

Hide child attributes

data.fees

object[]

required

The fees charged for this payment, as recorded by the fees service. Includes both the originator-side and receiver-side fees; use chargeTo on each item to tell them apart. Always present — an empty array when no fees have been recorded yet (e.g. a freshly created payment).

Hide child attributes

data.fees.type

string

required

The fee category (e.g. ach, card, expedited-ach).

data.fees.chargeTo

enum<string>

required

Which side of the payment the fee is levied on: the account originating the payment or the account receiving it. Works for both estimated (calculator) and applied (payment) fees.

Available options:

originator,

receiver

data.fees.status

enum<string>

required

Whether the fee has been charged or is still pending.

Available options:

charged,

pending

data.fees.fixed

object

Present when the fee is a flat amount.

Hide child attributes

data.fees.fixed.value

integer

Flat fee, minor units (cents)

data.fees.percent

object

Present when the fee is a percentage of the payment amount.

Hide child attributes

data.fees.percent.rate

number

Percentage rate (e.g. 2.9 = 2.9%)

data.fees.percent.min

integer

Minimum fee, minor units (cents)

data.fees.percent.max

integer

Maximum fee, minor units (cents)

data.fees.amount

integer

The resolved fee for the requested payment amount, in minor units (cents). Absent only when the fee cannot be resolved without a per-payment quote (e.g. tiered pricing).

data.id

string

Opaque payment id (pay_)

data.externalId

string

Your own unique identifier for the resource. Unique per partner per resource type (reusing one returns 409 DUPLICATE_EXTERNAL_ID). Distinct from the Idempotency-Key header, which dedupes the request rather than identifying the resource.

Maximum string length: 255

Pattern: ^[A-Za-z0-9_-]+$

data.amount

integer

data.currency

string

data.originatingAccountId

string

Internal originating account id (acct_)

data.receivingAccountId

string

External receiving account id (acct_)

data.deductionDate

string<date>

data.deliveryPreference

enum<string>

Effective delivery preference. Reflects the faster variant when one was applied, otherwise the receiving rail's normal-speed value.

Available options:

standard-ach,

same-day-ach,

rtp,

standard-check,

express-check,

overnight-check,

domestic-wire,

instant-domestic-wire,

virtual-card,

instant-virtual-card

data.deliveryDate

string<date>

data.status

enum<string>

While a payment is being reviewed it is reported as scheduled; there is no separate review status.

Available options:

scheduled,

in-progress,

completed,

failed,

canceled

data.noteToSelf

string

Payer-private memo, never shown to the recipient

data.noteToRecipient

string

Note shown to the payment recipient

data.metadata

object

Free-form string key/value pairs stored and returned verbatim, never interpreted by Melio. Up to 50 keys; each key 1 to 40 chars and may not contain square brackets ([ ], reserved for the metadata[key] filter); value ≤100 chars. Filterable via metadata[key].

Hide child attributes

data.metadata.{key}

string

Maximum string length: 100

data.createdAt

string<date-time>

data.updatedAt

string<date-time>

hasMore

boolean

required

True when more resources exist after this page; page again using the last item's id as startingAfter.

⌘I

List payments

const options = {
  method: 'GET',
  headers: {'Melio-Entity-Id': '<melio-entity-id>', 'api-key': '<api-key>'}
};

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

import requests

url = "https://api.melio.com/v2/payments"

headers = {
    "Melio-Entity-Id": "<melio-entity-id>",
    "api-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/payments")

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

request = Net::HTTP::Get.new(url)
request["Melio-Entity-Id"] = '<melio-entity-id>'
request["api-key"] = '<api-key>'

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

package main

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

func main() {

	url := "https://api.melio.com/v2/payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Melio-Entity-Id", "<melio-entity-id>")
	req.Header.Add("api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "hasMore": true,
  "data": [
    {
      "id": "pay_9f8c7b6a5d4e3f21",
      "externalId": "invoice-2043",
      "amount": 125000,
      "currency": "USD",
      "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
      "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "deductionDate": "2026-07-10",
      "deliveryDate": "2026-07-14",
      "status": "scheduled",
      "metadata": {
        "invoiceId": "INV-2043",
        "department": "operations"
      },
      "createdAt": "2026-07-08T15:04:05Z",
      "updatedAt": "2026-07-08T15:04:05Z"
    },
    {
      "id": "pay_1a2b3c4d5e6f7a8b",
      "externalId": "invoice-2041",
      "amount": 4200,
      "currency": "USD",
      "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
      "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "deductionDate": "2026-07-09",
      "deliveryDate": "2026-07-11",
      "status": "completed",
      "metadata": {},
      "createdAt": "2026-07-07T09:22:00Z",
      "updatedAt": "2026-07-07T09:22:00Z"
    }
  ]
}

Entities

Accounts

Payments

Tools

Webhooks

Authorizations

Headers

Query Parameters

Response