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. An owner key acts for its one owner; an integration token also needs the owner's id in the X-Owner-Id header.

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.