> For the complete documentation index, see [llms.txt](https://docs.verygoodsecurity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verygoodsecurity.com/cmp/products-and-services/card-attributes.md).

# Card Attributes

The VGS Card Attributes Service offers a robust and dynamic direct-to-network BIN (Bank Identification Number) database. Unlike standard, static BIN lookups, this service provides continuously updated and comprehensive card insights directly from the card networks. This empowers our clients with an unparalleled understanding of their customers and the intricate makeup of their payment cards. We continue to expand our data sources to ensure clients have access to the most up-to-date card information.

By providing deep visibility into card behavior, including issuer details, card type (credit, debit, prepaid), funding source, regional information, and recurring payment support, the VGS Card Attributes Service enables businesses to make exceptionally swift and informed decisions. This critical intelligence allows them to:

* **Optimize Payment Routing:** Intelligently direct transactions to the most efficient and cost-effective networks, leading to higher authorization rates and reduced processing fees.
* **Strengthen Fraud Prevention:** Leverage enriched card data to identify and mitigate potential fraud risks more accurately, by cross-referencing card attributes with transaction patterns and user behavior.
* **Enhance Customer Experience:** Streamline the checkout process by pre-populating fields, offer tailored promotions based on card benefits, and proactively manage subscription payments by identifying non-reloadable cards.
* **Ensure Regulatory Compliance:** Easily adhere to evolving payment regulations and regional mandates by having accurate and up-to-date card information at their fingertips.
* **Drive Business Growth:** Uncover valuable insights into customer spending habits and preferences, enabling more effective marketing strategies, loyalty programs, and product development.

In essence, the VGS Card Attributes Service offer a powerful, real-time intelligence layer that transforms raw card information into actionable insights, ultimately helping businesses protect their operations and unlock new avenues for growth.

#### Card Attributes via CMP <a href="#card-attributes-via-cmp" id="card-attributes-via-cmp"></a>

The Card Attributes service supports Visa, Mastercard, Discover and Amex cards and other additional networks. Enhanced card attributes will be visible in Create Card and GET Card API responses.

Clients will have to sign up to get comprehensive attributes by enabling attributes through account settings in CMP, or by contacting customer support **`(support@vgs.io)`**. These comprehensive attributes will also be visible in the Create Card and GET Card API responses.&#x20;

The Card Attributes service also supports `PAN` and `DPAN` BIN lookup. For DPAN, the data will be provided if available in our database.&#x20;

The Card Attribute Service response return 8-digit BINs for Mastercard and Visa, and 6-digit BINs for Discover and American Express (Amex).

**The comprehensive list of attributes and their definition**

<table data-header-hidden><thead><tr><th width="195.43896484375"></th><th width="200.7379150390625"></th><th width="216.789794921875"></th><th></th></tr></thead><tbody><tr><td><strong>Field Name</strong></td><td><strong>Description</strong></td><td><strong>Examples</strong></td><td><strong>Attributes Type</strong></td></tr><tr><td><code>card_number_length</code></td><td>The number of digits in the card number.</td><td>16</td><td>Enriched</td></tr><tr><td><code>card_brand</code></td><td>The name of the card brand.</td><td>MASTERCARD, VISA, DISCOVER, AMERICAN EXPRESS<br><br><a href="/pages/oQrI9dGIpimvjPVWHZtb">Full list here</a>.</td><td>Basic</td></tr><tr><td><code>card_type</code></td><td>The category of the card. </td><td>CREDIT, DEBIT, CHARGE CARD</td><td>Basic</td></tr><tr><td><code>card_segment_type</code></td><td>A classification that helps identify the cardholder's spending habits or income level.</td><td>PERSONAL, COMMERCIAL</td><td>Enriched</td></tr><tr><td><code>virtual_card</code></td><td>Indicates whether the card is a digital-only card without a physical plastic version.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>prepaid_card</code></td><td>Specifies if the card is a prepaid card, which is loaded with funds beforehand and isn't linked to a bank account.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>product_name</code></td><td>The specific name of the card product.</td><td>CLASSIC, STANDARD, CORPORATE, PLATINUM, SIGNATURE, TRADITIONAL REWARDS</td><td>Enriched</td></tr><tr><td><code>issuer_bin</code></td><td>The Bank Identification Number (BIN), which is the first 6 or 8 digits of a card number that identifies the issuing institution.</td><td>First 6 or 8 digits</td><td>Enriched</td></tr><tr><td><code>country_name</code></td><td>The full name of the country where the card was issued.<br><br>Tied to the The ISO 3166-1 numeric-3 codes for the country, but presented in a human readable format indicating the full name of the country. </td><td>UNITED STATES, GERMANY<br><br><a href="https://www.iso.org/obp/ui/#search/code/">Full list here.</a></td><td>Enriched</td></tr><tr><td><code>country_numeric</code></td><td>The ISO 3166-1 numeric-3 codes for the country.</td><td>840, 276<br><br><a href="https://www.iso.org/obp/ui/#search/code/">Full list here.</a></td><td>Enriched</td></tr><tr><td><code>reloadable</code></td><td>Indicates whether the prepaid card can be reloaded with additional funds.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>hsa</code></td><td>Indicates if the card is a Health Savings Account (HSA) card. This allows you to pay for eligible medical expenses with pre-tax money.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>fsa</code></td><td>Specifies if the card is a Flexible Spending Account (FSA) card, which is similar to an HSA but has different rules for fund rollovers and eligibility.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>ebt</code></td><td>Indicates if the card is an Electronic Benefits Transfer (EBT) card, used to deliver government benefits.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>issuer_name</code></td><td>The name of the financial institution that issued the card.</td><td>U.S. EQUITY ADVANTAGE, INC, FISERV SOLUTIONS</td><td>Enriched</td></tr><tr><td><code>issuer_phone_number</code></td><td>The phone number for the card issuer's customer service.</td><td>352-378-2125</td><td>Enriched</td></tr><tr><td><code>issuer_website</code></td><td>The website for the card issuer.</td><td><a href="http://www.suntrust.com/">http://www.suntrust.com/</a> </td><td>Enriched</td></tr><tr><td><code>commercial_level2</code></td><td>Indicator of Commercial Level 2 interchange rate eligibility.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>commercial_level3</code></td><td>Indicator of Commercial Level 3 interchange rate eligibility.</td><td>True, False</td><td>Enriched</td></tr><tr><td><code>regulated</code></td><td>Indicates the regulatory status of the card.</td><td>Y, N</td><td>Enriched</td></tr><tr><td><code>additional_card_brand</code></td><td>The name of the card brand.</td><td>BANCONTACT, CB<br><br><a href="/pages/oQrI9dGIpimvjPVWHZtb">Full list here</a>.</td><td>Enriched</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verygoodsecurity.com/cmp/products-and-services/card-attributes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.