---
title: Lead Status
description: List all statuses and details of a lead.
---

This API lists all the statuses of leads

#### POST

```
https://kraken.airpay.co.in/airpay/ms/leads/api/createlead
```

## Header

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| content-type  required | String | application/json | `Content-Type: application/json` |
| affiliate  required | Text | Will be provided by airpay | `s5018c4e6770be10ceb89171fd8a1b00` |
| checksum  required | Text | string = param + header_code + secret_key;<br>sha256(<concate all values+SECRET KEY>); | `jda5100cf07619128fc1d384fbb79dbc4fc1b262fd50d4371019c9e6d2994b6` |
| processor-key  required | Text | Will be provided by airpay | `xvIvkudaKczCf8sapHZv5iadqzPEB9dPRvtLr4idn4SzmMjfuWgVvSsXEn==` |

## Request Body

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| lead_id  required | numeric | User ID of the merchant(length 1-10) | `12345` |

## Success 200

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| status  required | Numeric | 400- fail,200-success(length 1-3) | `200` |
| message  required | Text | success, fail | `Success` |
| data  required | Text | Json response { "status": status code, "message": response message, "data":[ {"parameter":"array required data"}] } | `[]` |

## Request Example (before encryption)

```json
{"lead_id": "12345"}
```

## Request Example (encrypted)

```
curl --location 'https://kraken.airpay.co.in/airpay/ms/leads/api/createlead' \
--header 'Content-Type: application/json' \
--header 'AFFILIATE: s5018c4e6770be10ceb89171fd8a1b00' \
--header 'CHECKSUM: jda5100cf07619128fc1d384fbb79dbc4fc1b262fd50d4371019c9e6d2994b6' \
--header 'AIRPAYKEY: xvIvkudaKczCf8sapHZv5iadqzPEB9dPRvtLr4idn4SzmMjfuWgVvSsXEn==' \
--data '{
    "query":"07huijf1aeogtw926xXFgWbuoNAPfwhZ+vmOuX0c03Angi/kAK3FOYBesdg="
}'
```

### Success Response (decrypted)

```json
{
    "status": "200",
    "message": "Success",
    "data": {
        "lead_id": "12345",
        "lead_status": "Processing",
        "basic_info": {
            "fname": "John S",
            "lname": "Doe",
            "email": "johndoe1@example.com",
            "phone": "1234567890"
        },
        "company_info": {
            "company_name": "ABC Company Pvt Ltd",
            "company_address": "123 Main St, City",
            "merchant_legal_name": "ABC Legal Name",
            "company_website": "http://www.example.com",
            "company_cin": "U00000AB0000CDE123456",
            "company_annual_turnover": "0 - 1L"
        },
        "business_info": {
            "business_type": 3,
            "business_category": 118,
            "business_pan": "ABCDE1234F",
            "business_gstin": "12ABCDE1234F1Z5",
            "business_address": "Test Apartment",
            "business_city": "Kochi",
            "business_pincode": "123456",
            "business_state": "Kerala",
            "business_country": "India"
        },
        "bank_info": {
            "bank_account_type": "C",
            "bank_account_holder_name": "John S Doe",
            "bank_account_number": "1234567890",
            "bank_ifsc_code": "ABCD1234567"
        },
        "company_kyc_status": {
            "document name 1": "uploaded",
            "document name 2": "pending",
            "document name 3": "pending",
            "document name 4": "pending"
        },
        "signatory_kyc_status": {
            "1": "uploaded",
            "2": "pending",
            "3": "pending",
            "4": "pending"
        }
    }
}
```

### Error Response (decrypted)

```json
{
    "status": "400",
    "message": "Failed",
    "data": {
        "error": {
            "lead_id": "12345",
            "message": ""
        }
    }
}
```