Get Account by ID

curl --request GET \
  --url https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "acc_01JMERUSDRET001",
  "createdAt": "2026-04-30T14:00:00Z",
  "updatedAt": "2026-04-30T14:00:00Z",
  "status": "ACTIVE",
  "statusReason": null,
  "currency": "USD",
  "depositReconciliationId": "prop-ct-oak-7421",
  "displayName": null,
  "availableBalance": "125000.00",
  "actualBalance": "125000.00",
  "routingPolicy": {
    "type": "RETAIN"
  },
  "depositInstructions": [
    {
      "id": "depinst_01JMERACH001",
      "createdAt": "2026-04-30T14:00:00Z",
      "updatedAt": "2026-04-30T14:00:00Z",
      "status": "ACTIVE",
      "rail": {
        "type": "US.USD.ACH",
        "label": "ACH"
      },
      "supportedCurrencies": [
        "USD"
      ],
      "fields": [
        {
          "key": "bankName",
          "label": "Bank name",
          "value": "Lead Bank N.A.",
          "copyable": false
        },
        {
          "key": "routingNumber",
          "label": "Routing number",
          "value": "026073150",
          "copyable": true
        },
        {
          "key": "accountNumber",
          "label": "Account number",
          "value": "1133557799",
          "copyable": true
        }
      ],
      "disclosures": [
        {
          "kind": "notice",
          "text": "ACH credits only."
        }
      ]
    },
    {
      "id": "depinst_01JMERWIRE001",
      "createdAt": "2026-04-30T14:00:00Z",
      "updatedAt": "2026-04-30T14:00:00Z",
      "status": "ACTIVE",
      "rail": {
        "type": "US.USD.FEDWIRE",
        "label": "Fedwire"
      },
      "supportedCurrencies": [
        "USD"
      ],
      "fields": [
        {
          "key": "bankName",
          "label": "Bank name",
          "value": "Lead Bank N.A.",
          "copyable": false
        },
        {
          "key": "routingNumber",
          "label": "Fedwire routing number",
          "value": "026073150",
          "copyable": true
        },
        {
          "key": "accountNumber",
          "label": "Account number",
          "value": "1133557799",
          "copyable": true
        }
      ],
      "disclosures": [
        {
          "kind": "notice",
          "text": "Include the beneficiary account number exactly as shown."
        }
      ]
    }
  ]
}

GET

accounts

{accountId}

Get Account by ID

curl --request GET \
  --url https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sandbox-api.va.meridianpay.com/v1/accounts/{accountId}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "acc_01JMERUSDRET001",
  "createdAt": "2026-04-30T14:00:00Z",
  "updatedAt": "2026-04-30T14:00:00Z",
  "status": "ACTIVE",
  "statusReason": null,
  "currency": "USD",
  "depositReconciliationId": "prop-ct-oak-7421",
  "displayName": null,
  "availableBalance": "125000.00",
  "actualBalance": "125000.00",
  "routingPolicy": {
    "type": "RETAIN"
  },
  "depositInstructions": [
    {
      "id": "depinst_01JMERACH001",
      "createdAt": "2026-04-30T14:00:00Z",
      "updatedAt": "2026-04-30T14:00:00Z",
      "status": "ACTIVE",
      "rail": {
        "type": "US.USD.ACH",
        "label": "ACH"
      },
      "supportedCurrencies": [
        "USD"
      ],
      "fields": [
        {
          "key": "bankName",
          "label": "Bank name",
          "value": "Lead Bank N.A.",
          "copyable": false
        },
        {
          "key": "routingNumber",
          "label": "Routing number",
          "value": "026073150",
          "copyable": true
        },
        {
          "key": "accountNumber",
          "label": "Account number",
          "value": "1133557799",
          "copyable": true
        }
      ],
      "disclosures": [
        {
          "kind": "notice",
          "text": "ACH credits only."
        }
      ]
    },
    {
      "id": "depinst_01JMERWIRE001",
      "createdAt": "2026-04-30T14:00:00Z",
      "updatedAt": "2026-04-30T14:00:00Z",
      "status": "ACTIVE",
      "rail": {
        "type": "US.USD.FEDWIRE",
        "label": "Fedwire"
      },
      "supportedCurrencies": [
        "USD"
      ],
      "fields": [
        {
          "key": "bankName",
          "label": "Bank name",
          "value": "Lead Bank N.A.",
          "copyable": false
        },
        {
          "key": "routingNumber",
          "label": "Fedwire routing number",
          "value": "026073150",
          "copyable": true
        },
        {
          "key": "accountNumber",
          "label": "Account number",
          "value": "1133557799",
          "copyable": true
        }
      ],
      "disclosures": [
        {
          "kind": "notice",
          "text": "Include the beneficiary account number exactly as shown."
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer token authentication, for client-server calls.

Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.

Headers

X-Meridian-Api-Key

string

Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.

X-Meridian-Timestamp

string

Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.

X-Meridian-Program-Id

string

Server-to-server (HMAC) requests only. Identifies the program context for the request.

X-Meridian-User-Id

string

Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.

Path Parameters

accountId

string

required

ID of the balance account to fetch — the id returned by GET /v1/accounts.

Response

The account details for the authenticated account

Detailed Meridian account payload

string

required

Unique identifier of the account

Example:

"acc_01JMERUSDRET001"

createdAt

string<date-time>

required

Timestamp when the account was created

Example:

"2026-04-30T14:00:00Z"

updatedAt

string<date-time>

required

Timestamp when the account was last updated

Example:

"2026-04-30T14:00:00Z"

status

enum<string>

required

Current status of the account

Available options:

ACTIVE,

CLOSED,

FROZEN

Example:

"ACTIVE"

currency

enum<string>

required

Currency of the account

Available options:

EUR,

USD,

GBP,

PHP,

MXN,

ZAR,

USDC_ETH,

USDC_SOL,

USDT_ETH,

USDT_SOL

Example:

"USD"

routingPolicy

Retain Routing Policy · object

required

Routing policy that retains deposited funds on the account

Retain Routing Policy
Sweep Routing Policy

Show child attributes

depositInstructions

Deposit Instruction · object[]

required

Deposit instructions for the account

Show child attributes

availableBalance

string

required

Funds available for immediate use, adjusted for pending transactions

actualBalance

string

required

Total posted and cleared balance physically in the account

statusReason

string | null

Reason for the current status

depositReconciliationId

string | null

Partner-defined identifier used to reconcile inbound deposits to the account

displayName

string | null

Display name of the account

⌘I

Getting Started

Authentication

Enrollment

Transactions

API Reference

Webhooks

Get Account by ID

Authorizations

Headers

Path Parameters

Response