---
page_source: https://docs.juspay.io/amazon-pay-later/docs/amazon-pay-later-emi-flow/eligibility-check-api
page_title: Eligibility Check API
---

## API Version: default


# Eligibility Check



The Eligibility Check API is used to verify whether a customer is eligible to use Amazon Pay Later (EMI) before initiating a transaction. This step is mandatory. It must be called before displaying or initiating the Amazon Pay Later (EMI) payment option.

> **Note**
> * If `is_eligible : true`, proceed with transaction initiation
> * If `is_eligible : false`, block Amazon Pay Later (EMI) and present an alternative payment method




# API Header



To verify whether a customer is eligible to use Amazon Pay Later (EMI) for a given transaction amount.## Endpoints:
- Sandbox: https://sandbox.juspay.in/customers/test_cust/eligibility

- Production: https://api.juspay.in/customers/test_cust/eligibility

## Request Type: 
GET

## Content-Type: 
application/json

## Authorization:

#### Basic Auth:
Consists of two parts.

* Username: API Key obtained from Juspay dashboard
* Password: Empty string
- Value:  Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
- Tags: required, Base64 Encoded Username:Password
## Headers:

#### Content-Type:
application/x-www-form-urlencoded
- Tags: String, Mandatory
## Sample Code Snippets:
### Sample Request:

#### Sample Request Code Snippet:

```sample request
curl --location 'https://api.juspay.in/customers/test_cust/eligibility' \
--header 'Authorization: Basic ********' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'amount=1' \
--data-urlencode 'gateway_reference_id=amazonpay_emi_test' \
--data-urlencode 'mobile_number=7********5'


```

### Sample Response:

#### Eligibility Success Response:
```plaintext
{
    "payment_methods_eligibility": [
        {
            "status": "SUCCESS",
            "description": "Amazon Pay Later + EMI",
            "eligibility_strategy": "USER",
            "payment_method": "AMAZONPAYLATER_EMI",
            "payment_method_type": "CONSUMER_FINANCE",
            "is_eligible": true
        }
    ]
}


```

#### Eligibility Failure Response:
```plaintext
{
    "payment_methods_eligibility": [
        {
            "status": "SUCCESS",
            "description": "Amazon Pay Later + EMI",
            "eligibility_strategy": "USER",
            "payment_method": "AMAZONPAYLATER_EMI",
            "payment_method_type": "CONSUMER_FINANCE",
            "is_eligible": false
        }
    ]
}


```

## Path Parameters:

#### customer-id:
Customer ID for which the eligibility is to be checked
- Tags: String, Mandatory
## Body Parameters:
### Parameters:

#### amount:
- Description: Amount to check eligibility. 
- Value: value
- Tags: String, Mandatory

#### gateway_reference_id:
- Description: Reference ID configured in case of a multi MID setup.
- Tags: String, Mandatory

#### mobile_number:
- Description: The mobile number that will be used to verify eligibility. 
- Value:  7209123423
- Tags: String, Mandatory
## API Responses:
### 200:

#### payment_methods_eligibility:
- Description: An array containing eligibility details for the requested payment method.
- Value:
  - **Status**:
    - Description: The Juspay mapped error status for the corresponding gateway error code.
    - Value: SUCCESS
    - Tags: String
  - **Description**:
    - Description: Description about the payment method
    - Value: Amazon Pay Later + EMI
    - Tags: String
  - **Eligibility_strategy**:
    - Description: Different strategies for eligibility, such as transaction eligibility and user eligibility.
    - Value: USER
    - Tags: String
  - **Payment_method**:
    - Description: Name of the payment method that has eligibility criteria.
    - Value: AMAZONPAYLATER_EMI
    - Tags: String
  - **Payment_method_type**:
    - Description: Type of the payment method.
    - Value: CONSUMER_FINANCE
    - Tags: String
  - **Is_eligible**:
    - Description: Indicates whether the customer is eligible to use Amazon Pay Later (EMI). `true` means eligible; `false` means not eligible.
    - Value: true
    - Tags: Boolean
- Tags: Array