Get recipient

Get recipient

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

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

}

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

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

}

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

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)

string

required

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

string

Recipient first name (for individual recipients).

string

Recipient last name (for individual recipients).

object

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

Show bank_account properties

string

Resolved account holder name.

string

Last four digits of the account number.

string

Bank code.

string

Resolved bank name.

object

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

Show crypto_address properties

string

Crypto asset (USDC or USDT).

string

Blockchain network.

string

Wallet address.

object

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

Show us_bank_account properties

string

Account owner name.

string

Last four digits of the account number.

string

ABA routing number.

string

Bank name.

string

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

string

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

object

Recipient address.

Show address properties

string

Street line 1.

string

Street line 2.

string

City.

string

State or subdivision.

string

Postal code.

string

ISO 3166-1 alpha-3 country code.

object

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

Show swift_bank_account properties

string

Account owner name.

string

Account owner type: individual or business.

string

First name (for individual owners).

string

Last name (for individual owners).

string

Business name (for business owners).

string

Short business description.

string

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

string

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

string

Bank name.

string

Bank Identifier Code (SWIFT/BIC).

string

Last four characters of the IBAN.

array

Declared purpose(s) of funds.

object

Recipient address (same shape as us_bank_account.address).

object

Bank address (same shape as us_bank_account.address).

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"
  }
}

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