List accounts

GET

accounts

List accounts

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

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

import requests

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

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/accounts")

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/accounts"

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

}

{
  "data": [
    {
      "id": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "ownershipType": "external",
      "type": "ach",
      "counterPartyName": "Globex Manufacturing",
      "counterPartyEmail": "[email protected]",
      "bankAccount": {
        "accountType": "checking",
        "routingNumber": "111000025",
        "accountNumberLast4": "4321"
      },
      "createdAt": "2026-07-08T15:05:00Z",
      "updatedAt": "2026-07-08T15:05:00Z"
    },
    {
      "id": "acct_8be01c32-9378-4aad-9f0d-229e4454259c",
      "ownershipType": "external",
      "type": "check",
      "counterPartyName": "Initech",
      "counterPartyEmail": "[email protected]",
      "paperCheck": {
        "printName": "Initech",
        "address": {
          "line1": "500 Market St",
          "city": "San Francisco",
          "state": "CA",
          "postalCode": "94105"
        }
      },
      "createdAt": "2026-07-08T15:05:15Z",
      "updatedAt": "2026-07-08T15:05:15Z"
    }
  ]
}

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

ownershipType

enum<string>

Available options:

internal,

external

type

enum<string>

Available options:

ach,

check,

card,

domestic-wire,

virtual-card,

counterparty-choice

externalId

string

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

metadata

object

Filter by metadata key/value pairs, e.g. metadata[ledgerId]=L-9. Matches accounts whose metadata contains every supplied pair.

Hide child attributes

metadata.{key}]

string

Response

200 - application/json

Accounts.

data

object[]

Hide child attributes

data.id

string

Opaque account id (acct_)

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

object

Free-form string key/value pairs stored and returned verbatim, never interpreted by Melio. Up to 500 keys; each key 1 to 40 chars and may not contain square brackets ([ ], reserved for the metadata[key] filter); value ≤100 chars. The whole object must serialize to at most 128KB of JSON. Filterable via metadata[key].

Hide child attributes

data.metadata.{key}

string

Maximum string length: 100

data.ownershipType

enum<string>

Available options:

internal,

external

data.type

enum<string>

Plaid-backed internal accounts are returned as ach.

Available options:

ach,

check,

card,

domestic-wire,

virtual-card,

counterparty-choice,

international-fx,

international-gusd

data.nickname

string

Present for internal accounts.

data.counterPartyName

string

Present for external accounts.

data.counterPartyEmail

string

Counterparty (payee) email. Present for external accounts.

data.isVerified

boolean

Present for internal accounts. For ach, false while micro-deposit verification is outstanding and true once it completes. Absent for external accounts, where verification does not apply.

data.bankAccount

object

Present when type=ach.

Hide child attributes

data.bankAccount.accountType

enum<string>

Available options:

checking,

savings

data.bankAccount.routingNumber

string

data.bankAccount.accountNumberLast4

string

data.card

object

Present when type=card.

Hide child attributes

data.card.lastFourDigits

string

data.card.network

string

data.card.expiration

string

MM/YY

data.paperCheck

object

Present when type=check.

Hide child attributes

data.paperCheck.printName

string

data.paperCheck.address

object

Address as returned in responses; fields may be absent when the stored record is incomplete.

Hide child attributes

data.paperCheck.address.line1

string

data.paperCheck.address.line2

string

data.paperCheck.address.city

string

data.paperCheck.address.state

string

data.paperCheck.address.postalCode

string

data.paperCheck.address.aptNumber

string

data.paperCheck.address.countryCode

string

data.domesticWire

object

Present when type=domestic-wire.

Hide child attributes

data.domesticWire.routingNumber

string

ABA routing number of the receiving bank

data.domesticWire.accountNumberLast4

string

data.domesticWire.address

object

Address as returned in responses; fields may be absent when the stored record is incomplete.

Hide child attributes

data.domesticWire.address.line1

string

data.domesticWire.address.line2

string

data.domesticWire.address.city

string

data.domesticWire.address.state

string

data.domesticWire.address.postalCode

string

data.domesticWire.address.aptNumber

string

data.domesticWire.address.countryCode

string

data.internationalFx

object

Present when type=international-fx. The submitted bank identifiers are stored encrypted, so only the last four characters are returned.

Hide child attributes

data.internationalFx.currency

string

ISO 4217 code the counterparty is paid in

data.internationalFx.bankCountryCode

string

data.internationalFx.bankName

string

data.internationalFx.accountIdentifierLast4

string

Last four characters of the IBAN or account number on file.

data.internationalFx.address

object

Address as returned in responses; fields may be absent when the stored record is incomplete.

Hide child attributes

data.internationalFx.address.line1

string

data.internationalFx.address.line2

string

data.internationalFx.address.city

string

data.internationalFx.address.state

string

data.internationalFx.address.postalCode

string

data.internationalFx.address.aptNumber

string

data.internationalFx.address.countryCode

string

data.internationalGusd

object

Present when type=international-gusd.

Hide child attributes

data.internationalGusd.walletAddressLast4

string

Last four characters of the wallet address

data.createdAt

string<date-time>

data.updatedAt

string<date-time>

List accounts

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

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

import requests

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

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/accounts")

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/accounts"

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

}

{
  "data": [
    {
      "id": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "ownershipType": "external",
      "type": "ach",
      "counterPartyName": "Globex Manufacturing",
      "counterPartyEmail": "[email protected]",
      "bankAccount": {
        "accountType": "checking",
        "routingNumber": "111000025",
        "accountNumberLast4": "4321"
      },
      "createdAt": "2026-07-08T15:05:00Z",
      "updatedAt": "2026-07-08T15:05:00Z"
    },
    {
      "id": "acct_8be01c32-9378-4aad-9f0d-229e4454259c",
      "ownershipType": "external",
      "type": "check",
      "counterPartyName": "Initech",
      "counterPartyEmail": "[email protected]",
      "paperCheck": {
        "printName": "Initech",
        "address": {
          "line1": "500 Market St",
          "city": "San Francisco",
          "state": "CA",
          "postalCode": "94105"
        }
      },
      "createdAt": "2026-07-08T15:05:15Z",
      "updatedAt": "2026-07-08T15:05:15Z"
    }
  ]
}

Entities

Accounts

Attachments

Payments

Tools

Authorizations

Headers

Query Parameters

Response