Skip to main content
GET
Get Beneficiary by ID

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

beneficiaryId
string
required

ID of the beneficiary — the id returned by POST /v1/beneficiaries or GET /v1/beneficiaries.

Response

The beneficiary details for the authenticated account

A person beneficiary

id
string
required

Unique identifier of the beneficiary

Example:

"uscp-01JMERBENEF001"

counterpartyId
string
required

Identifier of the underlying counterparty

Example:

"uscp-01JMERBENEF001"

createdAt
string<date-time>
required

Timestamp when the beneficiary was created

Example:

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

updatedAt
string<date-time>
required

Timestamp when the beneficiary was last updated

Example:

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

type
enum<string>
required

Beneficiary type discriminator

Available options:
PERSON,
BUSINESS
firstName
string | null

First name of the beneficiary

lastName
string | null

Last name of the beneficiary

dateOfBirth
string<date> | null

Date of birth of the beneficiary

displayName
string | null

Display name of the beneficiary

email
string | null

Email address of the beneficiary

phoneNumber
string | null

Phone number of the beneficiary

address
Beneficiary Address · object | null

Address of the beneficiary's bank. Required by RouteFusion for non-US bank countries; a missing field is reported as a field-level validation error on submission.

relationshipToUser
enum<string> | null

Beneficiary's relationship to the account owner

Available options:
SELF,
THIRD_PARTY,
null
Example:

"THIRD_PARTY"