Get recipient

Get recipient

curl --request GET \
  --url https://api.daya.co/v1/recipients/{id} \
  --header 'X-Api-Key: <x-api-key>'

import requests

url = "https://api.daya.co/v1/recipients/{id}"

headers = {"X-Api-Key": "<x-api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};

fetch('https://api.daya.co/v1/recipients/{id}', 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://api.daya.co/v1/recipients/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <x-api-key>"
  ],
]);

$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://api.daya.co/v1/recipients/{id}"

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

	req.Header.Add("X-Api-Key", "<x-api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.daya.co/v1/recipients/{id}")
  .header("X-Api-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.daya.co/v1/recipients/{id}")

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

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<x-api-key>'

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

{
  "id": "750e8400-e29b-41d4-a716-446655440000",
  "type": "BANK_ACCOUNT",
  "first_name": "John",
  "last_name": "Doe",
  "bank_account": {
    "account_name": "John Doe",
    "account_number_last4": "7890",
    "bank_code": "044",
    "bank_name": "Access Bank"
  },
  "crypto_address": null,
  "us_bank_account": null,
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "850e8400-e29b-41d4-a716-446655440000",
  "type": "CRYPTO_ADDRESS",
  "first_name": null,
  "last_name": null,
  "bank_account": null,
  "crypto_address": {
    "asset": "USDC",
    "chain": "BASE",
    "address": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "us_bank_account": null,
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "950e8400-e29b-41d4-a716-446655440000",
  "type": "US_BANK_ACCOUNT",
  "first_name": "Jane",
  "last_name": "Smith",
  "bank_account": null,
  "crypto_address": null,
  "us_bank_account": {
    "account_owner_name": "Jane Smith",
    "account_number_last4": "6789",
    "routing_number": "021000021",
    "bank_name": "JPMorgan Chase",
    "account_type": "checking",
    "payout_scheme": "ach",
    "address": {
      "street_line_1": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postal_code": "10001",
      "country": "USA"
    }
  },
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "a50e8400-e29b-41d4-a716-446655440000",
  "type": "SWIFT_BANK_ACCOUNT",
  "first_name": "Aisha",
  "last_name": "Ahmed",
  "bank_account": null,
  "crypto_address": null,
  "us_bank_account": null,
  "swift_bank_account": {
    "account_owner_name": "Aisha Ahmed",
    "account_owner_type": "individual",
    "first_name": "Aisha",
    "last_name": "Ahmed",
    "category": "client",
    "account_country": "GBR",
    "bank_name": "HSBC UK",
    "bic": "HBUKGB4B",
    "iban_last4": "3210",
    "purpose_of_funds": ["personal_or_living_expenses"],
    "address": {
      "street_line_1": "10 Downing St",
      "city": "London",
      "postal_code": "SW1A 2AA",
      "country": "GBR"
    },
    "bank_address": {
      "street_line_1": "8 Canada Square",
      "city": "London",
      "postal_code": "E14 5HQ",
      "country": "GBR"
    }
  },
  "created_at": "2026-01-05T15:04:05Z"
}

GET

recipients

{id}

Get recipient

curl --request GET \
  --url https://api.daya.co/v1/recipients/{id} \
  --header 'X-Api-Key: <x-api-key>'

import requests

url = "https://api.daya.co/v1/recipients/{id}"

headers = {"X-Api-Key": "<x-api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};

fetch('https://api.daya.co/v1/recipients/{id}', 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://api.daya.co/v1/recipients/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <x-api-key>"
  ],
]);

$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://api.daya.co/v1/recipients/{id}"

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

	req.Header.Add("X-Api-Key", "<x-api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.daya.co/v1/recipients/{id}")
  .header("X-Api-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.daya.co/v1/recipients/{id}")

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

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<x-api-key>'

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

{
  "id": "750e8400-e29b-41d4-a716-446655440000",
  "type": "BANK_ACCOUNT",
  "first_name": "John",
  "last_name": "Doe",
  "bank_account": {
    "account_name": "John Doe",
    "account_number_last4": "7890",
    "bank_code": "044",
    "bank_name": "Access Bank"
  },
  "crypto_address": null,
  "us_bank_account": null,
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "850e8400-e29b-41d4-a716-446655440000",
  "type": "CRYPTO_ADDRESS",
  "first_name": null,
  "last_name": null,
  "bank_account": null,
  "crypto_address": {
    "asset": "USDC",
    "chain": "BASE",
    "address": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "us_bank_account": null,
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "950e8400-e29b-41d4-a716-446655440000",
  "type": "US_BANK_ACCOUNT",
  "first_name": "Jane",
  "last_name": "Smith",
  "bank_account": null,
  "crypto_address": null,
  "us_bank_account": {
    "account_owner_name": "Jane Smith",
    "account_number_last4": "6789",
    "routing_number": "021000021",
    "bank_name": "JPMorgan Chase",
    "account_type": "checking",
    "payout_scheme": "ach",
    "address": {
      "street_line_1": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postal_code": "10001",
      "country": "USA"
    }
  },
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "a50e8400-e29b-41d4-a716-446655440000",
  "type": "SWIFT_BANK_ACCOUNT",
  "first_name": "Aisha",
  "last_name": "Ahmed",
  "bank_account": null,
  "crypto_address": null,
  "us_bank_account": null,
  "swift_bank_account": {
    "account_owner_name": "Aisha Ahmed",
    "account_owner_type": "individual",
    "first_name": "Aisha",
    "last_name": "Ahmed",
    "category": "client",
    "account_country": "GBR",
    "bank_name": "HSBC UK",
    "bic": "HBUKGB4B",
    "iban_last4": "3210",
    "purpose_of_funds": ["personal_or_living_expenses"],
    "address": {
      "street_line_1": "10 Downing St",
      "city": "London",
      "postal_code": "SW1A 2AA",
      "country": "GBR"
    },
    "bank_address": {
      "street_line_1": "8 Canada Square",
      "city": "London",
      "postal_code": "E14 5HQ",
      "country": "GBR"
    }
  },
  "created_at": "2026-01-05T15:04:05Z"
}

Overview

Retrieve details for a specific recipient belonging to the authenticated merchant. The response shape depends on the recipient’s type: BANK_ACCOUNT, CRYPTO_ADDRESS, US_BANK_ACCOUNT, or SWIFT_BANK_ACCOUNT. Only the field matching the type is populated; the others are null.

Authentication

X-Api-Key

string

required

Your merchant API key

Path Parameters

string

required

Recipient ID (UUID)Example: 750e8400-e29b-41d4-a716-446655440000

Request Example

curl --request GET \
  --url https://api.daya.co/v1/recipients/750e8400-e29b-41d4-a716-446655440000 \
  --header 'X-Api-Key: YOUR_API_KEY'

const response = await fetch(
  "https://api.daya.co/v1/recipients/750e8400-e29b-41d4-a716-446655440000",
  {
    method: "GET",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
    },
  }
);

const recipient = await response.json();

Response

string

required

Unique recipient identifier (UUID)

type

string

required

Recipient type.Allowed values: BANK_ACCOUNT | CRYPTO_ADDRESS | US_BANK_ACCOUNT | SWIFT_BANK_ACCOUNT

first_name

string

Recipient first name (for individual recipients).

last_name

string

Recipient last name (for individual recipients).

bank_account

object

NGN bank account details. Present when type is BANK_ACCOUNT, null otherwise.

Show bank_account properties

bank_account.account_name

string

Resolved account holder name.

bank_account.account_number_last4

string

Last four digits of the account number.

bank_account.bank_code

string

Bank code.

bank_account.bank_name

string

Resolved bank name.

crypto_address

object

Crypto address details. Present when type is CRYPTO_ADDRESS, null otherwise.

Show crypto_address properties

crypto_address.asset

string

Crypto asset (USDC or USDT).

crypto_address.chain

string

Blockchain network.

crypto_address.address

string

Wallet address.

us_bank_account

object

US bank account details. Present when type is US_BANK_ACCOUNT, null otherwise.

Show us_bank_account properties

us_bank_account.account_owner_name

string

Account owner name.

us_bank_account.account_number_last4

string

Last four digits of the account number.

us_bank_account.routing_number

string

ABA routing number.

us_bank_account.bank_name

string

Bank name.

us_bank_account.account_type

string

Account type (e.g., checking, savings).

us_bank_account.payout_scheme

string

Payout scheme (e.g., ach, wire).

us_bank_account.address

object

Recipient address.

Show address properties

us_bank_account.address.street_line_1

string

Street line 1.

us_bank_account.address.street_line_2

string

Street line 2.

us_bank_account.address.city

string

City.

us_bank_account.address.state

string

State or subdivision.

us_bank_account.address.postal_code

string

Postal code.

us_bank_account.address.country

string

ISO 3166-1 alpha-3 country code.

swift_bank_account

object

SWIFT bank account details. Present when type is SWIFT_BANK_ACCOUNT, null otherwise.

Show swift_bank_account properties

swift_bank_account.account_owner_name

string

Account owner name.

swift_bank_account.account_owner_type

string

Account owner type: individual or business.

swift_bank_account.first_name

string

First name (for individual owners).

swift_bank_account.last_name

string

Last name (for individual owners).

swift_bank_account.business_name

string

Business name (for business owners).

swift_bank_account.short_business_description

string

Short business description.

swift_bank_account.category

string

Relationship category: client, parent_company, subsidiary, or supplier.

swift_bank_account.account_country

string

ISO 3166-1 alpha-3 country code of the account.

swift_bank_account.bank_name

string

Bank name.

swift_bank_account.bic

string

Bank Identifier Code (SWIFT/BIC).

swift_bank_account.iban_last4

string

Last four characters of the IBAN.

swift_bank_account.purpose_of_funds

array

Declared purpose(s) of funds.

swift_bank_account.address

object

Recipient address (same shape as us_bank_account.address).

swift_bank_account.bank_address

object

Bank address (same shape as us_bank_account.address).

created_at

string

required

When the recipient was created (ISO 8601 timestamp)

Success Response

{
  "id": "750e8400-e29b-41d4-a716-446655440000",
  "type": "BANK_ACCOUNT",
  "first_name": "John",
  "last_name": "Doe",
  "bank_account": {
    "account_name": "John Doe",
    "account_number_last4": "7890",
    "bank_code": "044",
    "bank_name": "Access Bank"
  },
  "crypto_address": null,
  "us_bank_account": null,
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "850e8400-e29b-41d4-a716-446655440000",
  "type": "CRYPTO_ADDRESS",
  "first_name": null,
  "last_name": null,
  "bank_account": null,
  "crypto_address": {
    "asset": "USDC",
    "chain": "BASE",
    "address": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "us_bank_account": null,
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "950e8400-e29b-41d4-a716-446655440000",
  "type": "US_BANK_ACCOUNT",
  "first_name": "Jane",
  "last_name": "Smith",
  "bank_account": null,
  "crypto_address": null,
  "us_bank_account": {
    "account_owner_name": "Jane Smith",
    "account_number_last4": "6789",
    "routing_number": "021000021",
    "bank_name": "JPMorgan Chase",
    "account_type": "checking",
    "payout_scheme": "ach",
    "address": {
      "street_line_1": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postal_code": "10001",
      "country": "USA"
    }
  },
  "swift_bank_account": null,
  "created_at": "2026-01-05T15:04:05Z"
}

{
  "id": "a50e8400-e29b-41d4-a716-446655440000",
  "type": "SWIFT_BANK_ACCOUNT",
  "first_name": "Aisha",
  "last_name": "Ahmed",
  "bank_account": null,
  "crypto_address": null,
  "us_bank_account": null,
  "swift_bank_account": {
    "account_owner_name": "Aisha Ahmed",
    "account_owner_type": "individual",
    "first_name": "Aisha",
    "last_name": "Ahmed",
    "category": "client",
    "account_country": "GBR",
    "bank_name": "HSBC UK",
    "bic": "HBUKGB4B",
    "iban_last4": "3210",
    "purpose_of_funds": ["personal_or_living_expenses"],
    "address": {
      "street_line_1": "10 Downing St",
      "city": "London",
      "postal_code": "SW1A 2AA",
      "country": "GBR"
    },
    "bank_address": {
      "street_line_1": "8 Canada Square",
      "city": "London",
      "postal_code": "E14 5HQ",
      "country": "GBR"
    }
  },
  "created_at": "2026-01-05T15:04:05Z"
}

Error Responses

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid UUID format",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Recipient not found",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Next Steps

List recipients

Retrieve all saved recipients

Delete recipient

Remove a payout recipient

List recipients Delete recipient

Getting Started

Core Concepts

Guides

Rates & Chains

Customers

Funding Accounts

Transfers

Deposits

Recipients

Banks

USD Virtual Accounts

USD Virtual Account Deposits

Merchant Balance

Merchant Funding

Webhooks

Legacy API

Overview

Authentication

Path Parameters

Request Example

Response

Success Response

Error Responses

Next Steps

List recipients

Delete recipient

​Overview

​Authentication

​Path Parameters

​Request Example

​Response

​Success Response

​Error Responses

​Next Steps

List recipients

Delete recipient

Overview

Authentication

Path Parameters

Request Example

Response

Success Response

Error Responses

Next Steps