Skip to main content
GET
/
cardholders
/
{id}
Get Cardholder
curl --request GET \
  --url https://api.fyatu.com/api/v3/cardholders/{id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.fyatu.com/api/v3/cardholders/{id}"

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

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

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3/cardholders/{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.fyatu.com/api/v3/cardholders/{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 => [
    "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/cardholders/{id}"

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

}
HttpResponse<String> response = Unirest.get("https://api.fyatu.com/api/v3/cardholders/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3/cardholders/{id}")

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": "Cardholder retrieved successfully",
  "data": {
    "id": "ch_a1b2c3d4e5f6",
    "externalId": "EXT-0001",
    "firstName": "Alice",
    "lastName": "Example",
    "email": "alice@example.com",
    "phone": "+15550001234",
    "dateOfBirth": "1990-01-01",
    "gender": "FEMALE",
    "address": {
      "line1": "123 Example Street",
      "city": "Springfield",
      "state": "Illinois",
      "country": "US",
      "zipCode": "62701"
    },
    "document": {
      "type": "PASSPORT",
      "number": "XX0000000"
    },
    "kyc": {
      "status": "ACCEPTED",
      "idFrontUrl": null,
      "idBackUrl": null,
      "selfieUrl": null
    },
    "metadata": null,
    "status": "ACTIVE",
    "cardsCount": 1,
    "createdAt": "2026-01-10T14:30:00Z",
    "updatedAt": "2026-01-15T09:45:00Z"
  },
  "meta": {
    "requestId": "req_d4e5f6g7h8i9",
    "timestamp": "2026-01-17T10:00:00Z"
  }
}
{
  "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": "Wallet not found",
  "error": {
    "code": "RESOURCE_NOT_FOUND"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}

Overview

Retrieve detailed information about a specific cardholder, including personal details, address, document information, and KYC status.

Path Parameters

ParameterTypeDescription
idstringUnique cardholder identifier

Response Fields

FieldTypeDescription
idstringCardholder ID
externalIdstringYour system’s identifier
firstNamestringFirst name
lastNamestringLast name
emailstringEmail address
phonestringPhone number
dateOfBirthstringDate of birth
genderstringGender
addressobjectAddress details
documentobjectDocument details
kycobjectKYC status and documents
statusstringCardholder status
cardsCountintegerNumber of active cards
createdAtstringCreation timestamp
updatedAtstringLast update timestamp

Example Usage

<?php
$cardholderId = 'ch_a1b2c3d4e5f6';

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

$result = json_decode($response, true);
$ch = $result['data'];

echo "Name: {$ch['firstName']} {$ch['lastName']}\n";
echo "Email: {$ch['email']}\n";
echo "KYC Status: {$ch['kyc']['status']}\n";
echo "Cards: {$ch['cardsCount']}\n";
const cardholderId = 'ch_a1b2c3d4e5f6';

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

const result = await response.json();
const ch = result.data;

console.log(`Name: ${ch.firstName} ${ch.lastName}`);
console.log(`Email: ${ch.email}`);
console.log(`KYC Status: ${ch.kyc.status}`);
console.log(`Cards: ${ch.cardsCount}`);

Example Response

{
  "success": true,
  "status": 200,
  "message": "Cardholder retrieved successfully",
  "data": {
    "id": "ch_a1b2c3d4e5f6",
    "externalId": "EXT-0001",
    "firstName": "Alice",
    "lastName": "Example",
    "email": "alice@example.com",
    "phone": "+15550001234",
    "dateOfBirth": "1990-01-01",
    "gender": "FEMALE",
    "address": {
      "line1": "123 Example Street",
      "city": "Springfield",
      "state": "Illinois",
      "country": "US",
      "zipCode": "62701"
    },
    "document": {
      "type": "PASSPORT",
      "number": "XX0000000"
    },
    "kyc": {
      "status": "VERIFIED",
      "idFrontUrl": "https://cdn.fyatu.com/example/id-front.jpg",
      "idBackUrl": "https://cdn.fyatu.com/example/id-back.jpg",
      "selfieUrl": "https://cdn.fyatu.com/example/selfie.jpg"
    },
    "status": "ACTIVE",
    "cardsCount": 1,
    "createdAt": "2026-01-10 14:30:00",
    "updatedAt": "2026-01-15 09:45:00"
  },
  "meta": {
    "requestId": "req_d4e5f6g7h8i9",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

KYC Status Values

StatusDescription
UNSUBMITTEDNo KYC documents have been submitted
PENDINGDocuments submitted, awaiting review
VERIFIEDKYC verification completed successfully
REJECTEDKYC verification failed
The cardsCount field shows the number of active (non-terminated) cards associated with this cardholder.

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

id
string
required

Unique cardholder identifier

Response

Cardholder retrieved successfully

success
boolean
Example:

true

status
integer
Example:

200

message
string
Example:

"Cardholder retrieved successfully"

data
object
meta
object