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>'
{
  "success": true,
  "status": 200,
  "message": "Cardholder retrieved successfully",
  "data": {
    "id": "ch_1a2b3c4d5e6f7890abcdef1234567890",
    "externalId": "USR-78945",
    "firstName": "James",
    "lastName": "Wilson",
    "email": "[email protected]",
    "phone": "+12025551234",
    "dateOfBirth": "1988-03-22",
    "gender": "MALE",
    "address": {
      "line1": "742 Evergreen Terrace",
      "city": "Springfield",
      "state": "Illinois",
      "country": "US",
      "zipCode": "62701"
    },
    "document": {
      "type": "PASSPORT",
      "number": "XY7891234"
    },
    "kyc": {
      "status": "VERIFIED",
      "idFrontUrl": "https://secure.fyatu.com/kyc/id_front_abc123.jpg",
      "idBackUrl": "https://secure.fyatu.com/kyc/id_back_abc123.jpg",
      "selfieUrl": "https://secure.fyatu.com/kyc/selfie_abc123.jpg"
    },
    "status": "ACTIVE",
    "cardsCount": 2,
    "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"
  }
}

​
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_1a2b3c4d5e6f7890abcdef1234567890';

$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";

​
Example Response

{
  "success": true,
  "status": 200,
  "message": "Cardholder retrieved successfully",
  "data": {
    "id": "ch_1a2b3c4d5e6f7890abcdef1234567890",
    "externalId": "USR-78945",
    "firstName": "James",
    "lastName": "Wilson",
    "email": "[email protected]",
    "phone": "+12025551234",
    "dateOfBirth": "1988-03-22",
    "gender": "MALE",
    "address": {
      "line1": "742 Evergreen Terrace",
      "city": "Springfield",
      "state": "Illinois",
      "country": "US",
      "zipCode": "62701"
    },
    "document": {
      "type": "PASSPORT",
      "number": "XY7891234"
    },
    "kyc": {
      "status": "VERIFIED",
      "idFrontUrl": "https://secure.fyatu.com/kyc/id_front_abc123.jpg",
      "idBackUrl": "https://secure.fyatu.com/kyc/id_back_abc123.jpg",
      "selfieUrl": "https://secure.fyatu.com/kyc/selfie_abc123.jpg"
    },
    "status": "ACTIVE",
    "cardsCount": 2,
    "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