# Eligibility Error Codes source: https://developer.mastercard.com/eligibility-api/documentation/code-and-formats/eligibility-error-codes/index.md ## Eligibility Error Codes {#eligibility-error-codes} Error codes specific to Eligibility API are listed below. These codes apply to the `benefits/searches`, `products/searches`, `/card-identifiers`, `/cards/{card_number_id}/bundles`, and `widgets/access-tokens` operations documented in the [API Reference](https://developer.mastercard.com/eligibility-api/documentation/api-reference/index.md); see the [Use Cases](https://developer.mastercard.com/eligibility-api/documentation/usecases/index.md) page for which operation each code is most likely to be returned from. | **Error/Reason Code** | **Error Description** | **Typical causes** | **Resolution Steps** | |-----------------------|-------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | BENEFITINFO_VAL_001 | Validation Error -- BIN Number should be numeric. | Non-numeric input sent to `benefits/searches` or `products/searches` where a BIN was expected. | Provide a valid numeric BIN number. | | BENEFITINFO_VAL_002 | Validation Error -- Card number/BIN number must be 6 digits for a BIN, or 12 through 19 digits for a card number. | The identifier is too short, too long, or mixes BIN and full-card formats. | Provide a BIN with 6 digits or a card number with 12 through 19 digits. | | BENEFITINFO_VAL_003 | No products found for bin/card number. | The supplied BIN or card number is syntactically valid but has no matching product record. | Try a different bin/card number. | | BENEFITINFO_VAL_004 | Validation Error -- Card number/Bin number is required. | The request body omitted both `cardNumber` and `cardNumberId` on `benefits/searches` or `products/searches`. | Enter a Card number or BIN number. | | BENEFITINFO_VAL_005 | Products found, Selection Required. | The BIN/card maps to multiple products and the request did not narrow the result. | Select a product and retry the request with the required product value. | | BENEFITINFO_VAL_006 | No Benefits found. | The BIN/card is valid but no active benefits match the supplied criteria. | Try a different bin/card number or verify the expected benefits in [Testing](https://developer.mastercard.com/eligibility-api/documentation/testing/index.md#sample-test-data). | | BENEFITINFO_VAL_007 | In order to best service your account. Please allow me to transfer you to your bank for more information. | The cardholder must be redirected to their issuer for more information. | User must be transferred to their bank. | | BENEFITINFO_VAL_008 | In order to best service your account. Please allow me to transfer you to your bank for more information. | The cardholder must be redirected to their issuer for more information. | User must be transferred to their bank. | | BENEFITINFO_VAL_010 | Validation Error - Bin is invalid. | The request used a BIN that is not provisioned in sandbox, or a full card number was truncated into an unsupported BIN-only lookup. Most often returned by `benefits/searches`, `products/searches`, or `/card-identifiers`. | **Self-service first:** Use a verified sandbox BIN such as `512345` or the working sandbox card number `5555555555554444` from [Testing](https://developer.mastercard.com/eligibility-api/documentation/testing/index.md#sample-test-data). If a documented sample still fails, [contact support](https://developer.mastercard.com/eligibility-api/documentation/support/index.md). | | BENEFITINFO_VAL_011 | Validation Error -- Benefit Date is invalid. | `effectiveDate` does not match the required `YYYY-MM-DD` format or is otherwise invalid. | Enter a valid Benefit Date. | | BENEFITINFO_VAL_014 | Validation Error -- Product Code is invalid. | An unsupported product code was supplied to `benefits/searches` or `products/searches`. | Enter a valid Product Code. | | BENEFITINFO_VAL_015 | Validation Error -- Product Group Code is invalid. | An unsupported product-group value was supplied where product metadata is filtered. | Enter a valid Product Group Code. | | BENEFITINFO_VAL_016 | Validation Error -- Service Provider Code is invalid. | The request used a provider code that is not valid for the selected card, BIN, or bundle lookup. | Enter a valid Service Provider Code. | | BENEFITINFO_VAL_018 | Validation Error -- Benefit Code is invalid. | The request filtered by a benefit code the service does not recognize. | Enter a valid Benefit Code. | | BENEFITINFO_VAL_019 | Validation Error -- Card Holder Language Code is invalid. | A language code outside the supported set was supplied. | Enter a valid Card Holder Language Code. | | BENEFITINFO_VAL_020 | Validation Error - MAC Benefit Category is invalid. | The request filtered by a benefit category value the service does not recognize. | Enter a valid MAC Benefit Category. | | BENEFITINFO_VAL_022 | Validation Error -- Please enter Y or N for Distinct Benefit/ All Instances. | A flag field expected `Y` or `N` but received a different value. | Enter Y or N for Distinct Benefit/ All Instances. | | BENEFITINFO_VAL_023 | Please provide complete card number. | `/card-identifiers` received a partial card number. | Enter a complete card number. | | BENEFITINFO_VAL_025 | Invalid Card. | The supplied card number is malformed or does not pass service validation. | Enter a valid card number. | | BENEFITINFO_VAL_026 | Invalid encryption key used. Please re-try with the correct key | `/card-identifiers` was called with an encryption key that does not match the configured sandbox keys. | Enter a valid encryption key. | | BENEFITINFO_VAL_027 | Required field missing, Apikey. | A required authentication field or API key is missing from the request. | Provide a valid API key. | | BENEFITINFO_VAL_029 | Not authorized to view benefits for given card number | The authenticated caller is not permitted to access the requested benefit data. | Ensure you have the necessary permissions. | | BENEFITINFO_VAL_030 | An unknown exception occurred while processing the request. | An unexpected server-side condition prevented the request from completing. | Retry the request or contact support. | | BENEFITINFO_VAL_031 | Invalid Card Identifier. | `/cards/{card_number_id}/bundles` or a card-identifier-based lookup received a malformed or unknown `cardNumberId`. | Enter a valid card identifier. | | BENEFITINFO_VAL_032 | Invalid Card Number. | `/card-identifiers` received a card number that fails validation, such as a non-Luhn value. | Please ensure a Luhn-verified card number is entered. | ### No Benefits Found {#no-benefits-found} If there are no benefits found that meet the request criteria the HTTP Status code will be **200 OK** and the return body will have the following structure: ```json { "data": [] } ``` ## Next Steps {#next-steps} * Reproduce these scenarios against Sandbox using the sample and negative test cases in [Testing](https://developer.mastercard.com/eligibility-api/documentation/testing/index.md). * Review the request parameters tied to each code in the [API Reference](https://developer.mastercard.com/eligibility-api/documentation/api-reference/index.md). * Still stuck? Contact [Support](https://developer.mastercard.com/eligibility-api/documentation/support/index.md).