---
title: Lead status
description: This API lists all the statuses of leads.
---

This API lists all the statuses of leads

## POST

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

## Header

| Field | Type | Description |
| --- | --- | --- |
| content-type | String | application/json (required) |
| affiliate | Text | Will be provided by Airpay (required) |
| checksum | Text | $string = $param.self+ $header.code::$secret_key; sha256(<concate all values+SECRET KEY>); (required) |
| processor-key | Text | Will be provided by airpay ( required) |

## Parameter

| Field | Type | Description |
| --- | --- | --- |
| lead_id | numeric | User ID of the merchant(length 10, required) |

## Request-Example (before encryption): 

```
{"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 200

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

## Success-Response(encrypted):

```
{
    "query": "rs99z04gcan1h7x3G+qX8aCygyzXP9dJp1PvI0WHtbw2MnyTPASISPgZXyIYk3r+5hDMPVA7dE4061VbmBO+yR9uqUUIBaC5Tc6JwmJqN6KXgwWzHzUyQQtYFyqCbo3wAeTFuhEpJKFaYXSz2MGmZkxF36fjMFNLaKQGBCMZvOPM3QtHc4bcLa/VZ6TJDkVRmmB54iZmRw="
}
```
## Success-Response(decrypted):
```
{
    "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"
        },
        "signatory_info": {
            "1": {
                "signatory_name": "Signatory one",
                "signatory_email": "signatoryone@example.com",
                "signatory_phone": "1234567890",
                "signatory_address": "123 Main St, City",
                "signatory_pep": "N",
                "signatory_dob": "01-01-1990",
                "signatory_pan": "ABCDE1234G",
                "signatory_primary_contact": "N",
                "signatory_address_proof": "122",
                "signatory_pdconsent": "N",
                "signatory_gender": "F"
            },
            "2": {
                "signatory_name": "Signatory two",
                "signatory_email": "signatorytwo@example.com",
                "signatory_phone": "1234567890",
                "signatory_address": "Test Apartment",
                "signatory_pep": "N",
                "signatory_dob": "01-01-1990",
                "signatory_pan": "ABCDE1235G",
                "signatory_primary_contact": "Y",
                "signatory_address_proof": "121",
                "signatory_pdconsent": "N",
                "signatory_gender": "M"
            },
            "3": {
                "signatory_name": "Signatory three",
                "signatory_email": "signatorythree@example.com",
                "signatory_phone": "1234567890",
                "signatory_address": "Test Apartment",
                "signatory_pep": "N",
                "signatory_dob": "11-01-1990",
                "signatory_pan": "ABCDE1236G",
                "signatory_primary_contact": "N",
                "signatory_address_proof": "122",
                "signatory_pdconsent": "Y",
                "signatory_gender": "F"
            },
            "4": {
                "signatory_name": "Signatory four",
                "signatory_email": "signatoryfour@example.com",
                "signatory_phone": "1234567890",
                "signatory_address": "Test Apartment",
                "signatory_pep": "N",
                "signatory_dob": "01-01-1990",
                "signatory_pan": "ABCDE1230I",
                "signatory_primary_contact": "Y",
                "signatory_address_proof": "124",
                "signatory_pdconsent": "N",
                "signatory_gender": "M"
            }
        },
        "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(encrypted):


```
{
    "query": "hFcg8NHxe+h90jcIFt79jM0OwnJ0CPwEdzykGfWsHv0dahsjdhasPl3/KFoStiBD5TXocY9d/nbwGBDDBEi4J9Qjsyy9StVSyHB0+H8qOLp4LxPZtRxbw8MWOdVlCKWvCqUDeQamLvKurHFRZF7Fd5FLo+/7CgX7Kp/iRYFKh1JWn1QGmnUMH91exc="
}
```
## Error-Response(decrypted):

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