GET/api/partner/v1/drivers/{driverId}/card

Driver card status

Can this driver be charged today?

Reports the card on file and whether it is usable right now. isValid is the flag to gate a rental on: hasCard only says a card exists — it can still be expired, a wallet that keeps the card details, or suppressed after the issuer declined it repeatedly.

Authorization

X-Api-Key header

Send your partner key on every request. The key is bound to exactly one owner account.

Path parameters

driverIdstringpathrequired

Our driver id OR your own external driver id.

Response

200 · application/json

successbooleanrequired

dataobject

Whether the driver can be charged today.

userIdstring

externalIdstringnullable

hasCardboolean

A card is on file with us.

isValidboolean

On file AND chargeable now — not expired, not a Link wallet, not suppressed. Gate on this.

brandstringnullable

last4stringnullable

expMonthintegernullable

expYearintegernullable

expiredboolean

fundingstringnullable

"credit" | "debit" | "prepaid" | "unknown".

cardCountrystringnullable

isWalletboolean

Saved through Stripe Link — the wallet keeps the card, so it can never be charged later.

suppressedboolean

Temporarily not attempted after declines / issuer refusal.

suppressionReasonstringnullable

paymentMethodIdstringnullable

errorstringnullable

Status codes

200The driver's card status.

401Missing, unknown or revoked API key.

404The resource does not exist under this owner.