Electricity Bill Verification

Electricity Bill Verification: Instantly verify customer identities by cross-checking electricity bill details to ensure authenticity and reduce fraud.

electricity_bill_verification

POST https://secctrl.tutelar.io/api/v1/services/business_profile/electricity_bill_verification

Sample Request Body

Body

Type

Mandatory

Description

customer_id

string

Yes

Unique Customer ID allotted to the customer by each Electricity Distribution Company

service_provider

string

Yes

The Electricity Distribution Company for which the bill or customer is to be authenticated (Refer Table below for list of covered service providers)

consent

string

Yes

Consent is required to make the API request

mobile_number

string

Registered mobile number. Field is mandatory for code - KERALA

Sample Post Parameters

{
    "consumer_id": "0958400XXX",
    "service_provider": "CHENNAI_SOUTH",
    "consent": "Y",
    "mobile_number": "987654XXXX"
}

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "13c09db3-ba60-4bfd-9c77-552c2b53eb45",
    "status": "completed",
    "result": {
        "consumer_name": "M MUNIRAMAIAH",
        "bill_no": "xxxxxxxxxx",
        "bill_due_date": "01-03-2026",
        "consumer_number": "xxxxxxxxxx",
        "bill_amount": "Rs.4739",
        "bill_issue_date": "01-02-2026",
        "amount_payable": "Rs.4739",
        "total_amount": "Rs.4739",
        "bill_date": "01-02-2026",
        "address": "J abc abc, - - 560102. KAR, IND",
        "email_address": "[email protected]",
        "mobile_number": "xxxxxxxxxx"
    },
    "requested_at": "2026-03-03T07:10:01.373Z",
    "completed_at": "2026-03-03T07:10:02.310Z"
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Consumer ID should not be empty",
        "field": "consumer_id",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Service Provider should not be empty",
        "field": "service_provider",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid Service Provider Code",
        "field": "service_provider",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "consent should not be empty!",
        "field": "consent",
        "code": "BAD_REQUEST"
    }
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "91084d90-4468-43c8-b537-cd7a69d2e2b1",
    "status": "in_progress",
    "requested_at": "2026-03-03T14:40:18.115Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "96a7dad5-d7c7-4348-9baf-7f38c3e19efd",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-03-03T09:59:51.738Z",
    "completed_at": "2026-03-03T09:59:54.317Z"
}

Get details

GET https://secctrl.tutelar.io/api/v1/services/business_profile/electricity_bill_verification

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Document reference id

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "13c09db3-ba60-4bfd-9c77-552c2b53eb45",
    "status": "completed",
    "result": {
        "consumer_name": "M MUNIRAMAIAH",
        "bill_no": "xxxxxxxxxx",
        "bill_due_date": "01-03-2026",
        "consumer_number": "xxxxxxxxxx",
        "bill_amount": "Rs.4739",
        "bill_issue_date": "01-02-2026",
        "amount_payable": "Rs.4739",
        "total_amount": "Rs.4739",
        "bill_date": "01-02-2026",
        "address": "J abc abc, - - 560102. KAR, IND",
        "email_address": "[email protected]",
        "mobile_number": "xxxxxxxxxx"
    },
    "requested_at": "2026-03-03T07:10:01.373Z",
    "completed_at": "2026-03-03T07:10:02.310Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "91084d90-4468-43c8-b537-cd7a69d2e2b1",
    "status": "in_progress",
    "requested_at": "2026-03-03T14:40:18.115Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "96a7dad5-d7c7-4348-9baf-7f38c3e19efd",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-03-03T09:59:51.738Z",
    "completed_at": "2026-03-03T09:59:54.317Z"
}

PreviousTAN Verification NextSearch

Last updated 9 hours ago

hashtagelectricity_bill_verification

hashtagSample Request Body

hashtagSample Post Parameters

hashtagGet details

hashtagQuery parameters description is given below,