Verify Account

curl --request GET \
  --url https://api.fyatu.com/api/v3/accounts/{clientId} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.fyatu.com/api/v3/accounts/{clientId}', 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.fyatu.com/api/v3/accounts/{clientId}",
  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://api.fyatu.com/api/v3/accounts/{clientId}"

	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://api.fyatu.com/api/v3/accounts/{clientId}")

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

{
  "success": true,
  "status": 200,
  "message": "Account verified successfully",
  "data": {
    "clientId": "clt_a1b2c3d4e5f6",
    "name": "Alice Example",
    "accountType": "PERSONAL",
    "isActive": true,
    "status": "ACTIVE",
    "kycVerified": true,
    "canReceive": true
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-08T10:30:00+00:00"
  }
}

{
  "success": false,
  "status": 401,
  "message": "Unable to identify business",
  "error": {
    "code": "AUTH_TOKEN_INVALID"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}

{
  "success": false,
  "status": 404,
  "message": "Account not found or inactive",
  "error": {
    "code": "RESOURCE_NOT_FOUND"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-08T10:30:00+00:00"
  }
}

GET

accounts

{clientId}

Verify Account

curl --request GET \
  --url https://api.fyatu.com/api/v3/accounts/{clientId} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.fyatu.com/api/v3/accounts/{clientId}', 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.fyatu.com/api/v3/accounts/{clientId}",
  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://api.fyatu.com/api/v3/accounts/{clientId}"

	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://api.fyatu.com/api/v3/accounts/{clientId}")

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

{
  "success": true,
  "status": 200,
  "message": "Account verified successfully",
  "data": {
    "clientId": "clt_a1b2c3d4e5f6",
    "name": "Alice Example",
    "accountType": "PERSONAL",
    "isActive": true,
    "status": "ACTIVE",
    "kycVerified": true,
    "canReceive": true
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-08T10:30:00+00:00"
  }
}

{
  "success": false,
  "status": 401,
  "message": "Unable to identify business",
  "error": {
    "code": "AUTH_TOKEN_INVALID"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}

{
  "success": false,
  "status": 404,
  "message": "Account not found or inactive",
  "error": {
    "code": "RESOURCE_NOT_FOUND"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-08T10:30:00+00:00"
  }
}

Overview

Verify a Fyatu account before making a payout. This confirms the account exists, is active, and can receive funds.

Always verify the recipient account before making a payout to prevent failed transactions and lost funds.

Path Parameters

Parameter	Type	Description
`clientId`	string	The recipient’s Fyatu client ID

Response

Field	Type	Description
`clientId`	string	Verified client ID
`name`	string	Account holder’s name
`accountType`	string	Account type (PERSONAL, BUSINESS)
`status`	string	Account status
`kycVerified`	boolean	Whether account is KYC verified
`canReceive`	boolean	Whether account can receive payouts

Example Usage

<?php
$clientId = 'clt_a1b2c3d4e5f6';

$response = file_get_contents(
    "https://api.fyatu.com/api/v3/accounts/{$clientId}",
    false,
    stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => 'Authorization: Bearer ' . $accessToken
        ]
    ])
);

$result = json_decode($response, true);

if ($result['success']) {
    $account = $result['data'];

    if (!$account['canReceive']) {
        echo "Account cannot receive payouts: Status is {$account['status']}\n";
        exit;
    }

    // Show confirmation to user
    echo "Recipient: {$account['name']}\n";
    echo "Account Type: {$account['accountType']}\n";
    echo "KYC Verified: " . ($account['kycVerified'] ? 'Yes' : 'No') . "\n";

    // Proceed with payout...
} else {
    echo "Account not found\n";
}

const clientId = 'clt_a1b2c3d4e5f6';

const response = await fetch(
  `https://api.fyatu.com/api/v3/accounts/${clientId}`,
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`
    }
  }
);

const result = await response.json();

if (result.success) {
  const account = result.data;

  if (!account.canReceive) {
    console.log(`Account cannot receive payouts: Status is ${account.status}`);
    return;
  }

  // Show confirmation to user
  console.log(`Recipient: ${account.name}`);
  console.log(`Account Type: ${account.accountType}`);
  console.log(`KYC Verified: ${account.kycVerified ? 'Yes' : 'No'}`);

  // Proceed with payout...
} else {
  console.log('Account not found');
}

Example Response

{
  "success": true,
  "status": 200,
  "message": "Account verified successfully",
  "data": {
    "clientId": "clt_a1b2c3d4e5f6",
    "name": "Alice Example",
    "accountType": "PERSONAL",
    "status": "ACTIVE",
    "kycVerified": true,
    "canReceive": true
  },
  "meta": {
    "requestId": "req_verify123",
    "timestamp": "2026-01-08T10:00:00+00:00"
  }
}

Status Values

Status	canReceive	Description
`ACTIVE`	`true`	Account is active and can receive
`INACTIVE`	`false`	Account is inactive
`SUSPENDED`	`false`	Account is suspended
`DELETED`	`false`	Account is deleted

Best Practices

Always Verify First: Verify the account before showing payout confirmation to user
Display Name: Show the recipient’s name for user confirmation
Check canReceive: Only proceed if canReceive is true
Handle Not Found: Account may have been deleted or never existed

For better UX, verify the account as the user types and show the recipient’s name before they confirm the payout.

Error Responses

Error Code	HTTP	Description
`RESOURCE_NOT_FOUND`	404	Account not found
`AUTH_TOKEN_INVALID`	401	Invalid or expired token

Authorizations

Authorization

string

header

required

JWT access token obtained from /auth/token

Path Parameters

clientId

string

required

Recipient's Fyatu client ID

Example:

"clt_a1b2c3d4e5f6"

Response

Account verified successfully

success

boolean

Example:

true

status

integer

Example:

200

message

string

data

object

Show child attributes

Overview

Authentication

Account

Collections

Payouts

Cardholders

Cards

Verify Account

Overview

Path Parameters

Response

Example Usage

Example Response

Status Values

Best Practices

Error Responses

Authorizations

Path Parameters

Response

​Overview

​Path Parameters

​Response

​Example Usage

​Example Response

​Status Values

​Best Practices

​Error Responses

Authorizations

Path Parameters

Response

Overview

Path Parameters

Response

Example Usage

Example Response

Status Values

Best Practices

Error Responses