Pan Card Comprehensive

Submit Document

ind_pan_comprehensive

POST https://secctrl.tutelar.io/api/v1/kyc/identity/ind_pan_comprehensive

Post Parameters description is given below

Post Parameter	Type	Is Mandatory	Description
pan_number	String	yes	Pan Card Number

Sample Post Parameters

{
    "pan_number": "CNPPG0000D"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "fca2faf4-1026-4430-9a61-d40657970083",
    "status": "completed",
    "result": {
        "document_number": "CNPPG0000D",
        "name_on_document": "RAMESH GOWTHAM",
        "first_name": "RAMESH",
        "middle_name": "",
        "last_name": "GOWTHAM",
        "mobile_number": "6382526000",
        "date_of_birth": "1999-07-10",
        "gender": "M",
        "address": {
            "line_1": "",
            "line_2": "Kandhasamy street",
            "street_name": "Timiri S.O",
            "zip": "632512",
            "city": "Timiri",
            "state": "TAMIL NADU",
            "country": "INDIA",
            "full": "Kandhasamy street Timiri S.O 632512 Timiri TAMIL NADU INDIA"
        },
        "aadhaar_seeding_status": true,
        "masked_aadhaar": "XXXXXXXX0870"
    },
    "requested_at": "2024-04-18T09:57:18.907Z",
    "completed_at": "2024-04-18T09:57:20.523Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "in_progress",
    "requested_at": "2024-04-18T13:11:12.428Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid PAN Number",
        "field": "pan_number",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d9a02bb2-1357-49bd-a1ab-94d06f7f419c",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-18T13:14:13.968Z",
    "completed_at": "2024-04-18T13:14:15.000Z"
}

Get Pan Detail

Get Pan Detail

GET https://secctrl.tutelar.io/api/v1/kyc/identity/ind_pan_comprehensive

Query Parameters description is given below

query Parameter	Type	Is Mandatory	Description
reference_id	String	Yes	reference id

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "07bf7cd6-b03a-4f9d-a0b2-9e5154ee675b",
    "result": {
        "document_status": "SUCCESS",
        "document_number": "CNPPG4873D",
        "name_on_document": "RAMESH GOWTHAM",
        "first_name": "RAMESH",
        "middle_name": "",
        "last_name": "GOWTHAM",
        "mobile_number": "6382526132",
        "date_of_birth": "1999-07-10",
        "gender": "M",
        "address": {
            "line_1": "45",
            "line_2": "Kandhasamy mudhaliyar street",
            "street_name": "Timiri S.O",
            "zip": "632512",
            "city": "Timiri",
            "state": "TAMIL NADU",
            "country": "INDIA",
            "full": "45 Kandhasamy mudhaliyar street Timiri S.O 632512 Timiri TAMIL NADU INDIA"
        },
        "source": null,
        "aadhaar_seeding_status": true,
        "masked_aadhaar": "XXXXXXXX0870"
    },
    "requested_at": "2023-12-19T10:49:26.781Z",
    "completed_at": "2023-12-19T10:49:27.822Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "in_progress",
    "requested_at": "2024-04-18T13:11:12.428Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d9a02bb2-1357-49bd-a1ab-94d06f7f419c",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-18T13:14:13.968Z",
    "completed_at": "2024-04-18T13:14:15.000Z"
}