List cardholders

GET

/baas/Clients/{clientId}/cardholders

Early access - contact your account manager to enable card issuing for your platform.

Returns the people related to a business client who can hold its cards: directors, shareholders and other authorized persons provided during onboarding. Use the cardholder id as cardholderId when issuing a card to the client.

cardholderName is the name printed on the person's cards. The first card issued to the person sets it, and later cards must use the same name. It is null until the first card is issued.

Cards of an individual client are always issued to the client itself, so this endpoint returns 422 Unprocessable Content for an individual client. Returns 404 Not Found if the client does not exist or belongs to another integrator.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://my.test-1.account.finlego.com/api/child-brand-integration/baas/Clients//cardholders' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

[
    {
        "id": "5d0b7c3e-1f2a-4b6c-8d9e-0a1b2c3d4e5f",
        "firstName": "Anna",
        "lastName": "Schmidt",
        "cardholderName": "ANNA SCHMIDT"
    }
]

🟠400Bad Request

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Modified at 2026-09-29 11:12:37

List card products

Issue card