---
title: Lead Doc Upload
description: Upload and update KYC documents for a lead (Signatory, Company, or Wet).
---

This API is used to uploading and updating (Signatory/Company/Wet) KYC document.

#### POST

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

## 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>); | `ysssdsds00cf07619128fc1d384fbb79dbc4fc1b262fd50d4371019c9e6d28294b6` |
| processor-key  required | Text | Will be provided by airpay | `xvIvkudaKczCf8sapHZv5iadqzPEB9dPRvtLr4idn4SzmMjfuWgVvSsXEn==` |

## Request Body

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| lead_id  required | text | User ID of the merchant(length 1-10) | `12345` |
| document_type_id  required | numeric | Document type Id (length 1-10) (Note:Not required for wet document upload) | `111` |
| page_1  required | text | Front page of document.File in base64encode format (length 1-200) | `data:image/jpeg;base64,/9j/4QAYRXhpZgAASUkqAA` |
| page_2  required | text | Back page of document.File in base64encode format (length 1-200) | `data:image/jpeg;base64,/9j/4QAYRXhpZgAASUkqAA` |
| page_3  optional | text | In case if multiple pages are there. File in base64encode format (length 1-200) | `data:image/jpeg;base64,/9j/4QAYRXhpZgAASUkqAA` |
| page_4  optional | text | In case if multiple pages are there. File in base64encode format (length 1-200) | `data:image/jpeg;base64,/9j/4QAYRXhpZgAASUkqAA` |

## 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 (encrypted)

```
curl --location 'https://kraken.airpay.co.in/airpay/ms/leads/api/docUpload' \
--header 'Content-Type: application/json' \
--header 'AFFILIATE: s5018c4e6770be10ceb89171fd8a1b00' \
--header 'CHECKSUM: ysssdsds00cf07619128fc1d384fbb79dbc4fc1b262fd50d4371019c9e6d28294b6' \
--header 'AIRPAYKEY: xvIvkudaKczCf8sapHZv5iadqzPEB9dPRvtLr4idn4SzmMjfuWgVvSsXEn==' \
--data '{
"query": "v34WYbISGPr/iybDrHf7IOgcYvG5KC+S0yUEvvjPj1Iw4ikNoGyefQjzHGWDsgWKUwTE4lzTlAzLeZf6LYxfLxE1iiTXKfUMyFKdUx0WKX9hwvsm1gLZs7EbtUCR+zVQLCNRDrgqZslxi+GBTbSi2NGMWc/6CzfvWd15vCNWvEI3FZGlj534mNnGq0zGkqv/F0Qx1o9yRO+veHqHunzt72n7L4hp8taT/zvNTG1ioeul4cmzEi3pgbueg+9TEeEZhr5T2tHUjqETWG2328z2XCwTd1/ZRL6j8CBUxPxYTO+gXO+/AIECGWEdsYAW3ZJFqF4/6CeX3LoL3+d93m2e/UzOiPE5X7XEJQDMyiU6KjWYOnO3Be0vRVrRblbmiGO3RREc095BTmW4lblQGmstOtUTySCZ5ZMaKeRvMKtPKQ/qpd1FbYIBFw7aI+xnENasat4691TDiinZGfKnXFMi7LV/HhSM3PjVLg8xmBj9/tde0/Tdfj0KloPIHLXYEHelHhwe0ShvqtdibooE2YKMITLL2dLF0Q7rrXqu6T2YJciVQc4RBa6qJLspJMBDho4RIYJ6ZXsFGZCdwmyTlBYF3Lyk4tHsP3cLKZ0u2NsqmrAM/qcsI/k5t1m7taf/zwBt8FnZt2izfD2mjTmZayvOURtHgZB2yUQj6esq5yq/Tmcfm0Bp9rdpjrCRS+qz6mQqlUYAnoG4CPO+tj9ugmJcA4v0/HWq2YVaF+gPwHjL0D0lv27plBt/jA/nQisGgAquT/COQW+AlU96ZlBPnz0n9scm8TH2xOu9mCJ69UZ80fzAa3VkG/XhgZr2WFgb+iWzIQ6CfKV4YOs4V5PrgDC7p9L/v9dgpJw"
}'
```

### Success Response (decrypted)

```json
{
    "status": "200",
    "message": "success",
    "data": {
        "lead_id": "12345",
        "message": "File uploaded successfully."
    }
}
```

### Error Response (decrypted)

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