Cardholders
Returns a list of Issuing Cardholder objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
View-Specific Information
SELECT
The driver uses the Stripe API to filter the results by the following columns and operators while the rest of the filter is executed client-side within the driver.
| Column | Supported Operators |
| Id | = |
| Created | =, >, >=, <, <= |
| = | |
| Status | = |
| Type | = |
You can select from Cardholders with the following queries:
SELECT * FROM Cardholders WHERE Id = 'ich_1OctV22eZvKYlo2C6ETSndgk'
SELECT * FROM Cardholders WHERE Created = '2024-01-18 02:16:47.0'
SELECT * FROM Cardholders WHERE Email = '[email protected]'
Columns
| Name | Type | References | Description |
| Id [KEY] | String | The unique identifier for the cardholder. | |
| BillingAddressCity | String | City, district, suburb, town, or village. | |
| BillingAddressCountry | String | The two-letter country code. | |
| BillingAddressLine1 | String | Address line 1 (for example, street, PO Box, or company name). | |
| BillingAddressLine2 | String | Address line 2 (for example, apartment, suite, unit, or building). | |
| BillingAddressPostalCode | String | ZIP or postal code. | |
| BillingAddressState | String | State, county, province, or region. | |
| String | The cardholder's email address. | ||
| MetadataAggregate | String | The set of key-value pairs that you can attach to the object. | |
| Name | String | The cardholder's name. This is printed on cards issued to them. | |
| IsCompanyTaxIdProvided | Boolean | Indicates whether the company's business tax Id number was provided. | |
| Created | Datetime | The time at which the object was created, measured in seconds since the Unix epoch. | |
| Individual | String | Additional information about an individual cardholder. | |
| Livemode | Boolean | Indicates whether the object exists in live mode. Returns false if the object exists in test mode. | |
| Object | String | The string representing the object's type. Objects of the same type share the same value. | |
| PhoneNumber | String | The cardholder's phone number. | |
| RequirementsDisabledReason | String | The reason the cardholder is disabled. If present, all cards decline authorizations with the cardholder_verification_required reason. | |
| RequirementsPastDue | String | An array of fields that need to be collected in order to verify and re-enable the cardholder. | |
| SpendingControlsAllowedCategories | String | An array of strings containing categories of authorizations to allow. | |
| SpendingControlsBlockedCategories | String | An array of strings containing categories of authorizations to decline. | |
| SpendingControlsSpendingLimits | String | The amount-based rules that limit spending across this cardholder's cards. | |
| SpendingControlsSpendingLimitsCurrency | String | The currency of the amounts within spending_limits. | |
| Status | String | Specifies whether to permit authorizations on this cardholder's cards. | |
| Type | String | The type of cardholder. One of individual or company. | |
| PreferredLocales | String | The cardholder's preferred locales (languages), ordered by preference. Locales can be de, en, es, fr, or it. This changes the language of the 3D Secure flow and one-time password messages sent to the cardholder. | |
| SpendingControlsAllowedMerchantCountries | String | An array of strings representing countries from which authorizations are allowed. Authorizations from merchants in all other countries are declined. Country codes should be ISO 3166 alpha-2 country codes, such as US. Cannot be set with blocked_merchant_countries. Provide an empty value to unset this control. | |
| SpendingControlsBlockedMerchantCountries | String | An array of strings representing countries from which authorizations are declined. Country codes should be ISO 3166 alpha-2 country codes, such as US. Cannot be set with allowed_merchant_countries. Provide an empty value to unset this control. |