# 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

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/electricity_bill_verification`

#### Sample Request Body

<table><thead><tr><th width="167">Body</th><th width="148">Type</th><th>Mandatory</th><th width="217">Description</th></tr></thead><tbody><tr><td>customer_id</td><td>string</td><td>Yes</td><td>Unique Customer ID allotted to the<br>customer by each Electricity<br>Distribution Company</td></tr><tr><td>service_provider</td><td>string</td><td>Yes</td><td>The Electricity Distribution Company<br>for which the bill or customer is to be<br>authenticated (Refer Table below for<br>list of covered service providers)</td></tr><tr><td>consent</td><td>string</td><td>Yes</td><td>Consent is required to make the API<br>request</td></tr><tr><td>mobile_number</td><td>string</td><td>No</td><td>Registered mobile number. Field is<br>mandatory for code - KERALA</td></tr></tbody></table>

#### Service Code Provider

<table><thead><tr><th width="167">State or UT</th><th width="420.91015625">Service Provider</th><th width="159.47265625">Code</th></tr></thead><tbody><tr><td>Andhra Pradesh</td><td>Southern Power Distribution Company of Andhra Pradesh Limited</td><td>APSPDCL</td></tr><tr><td>Andhra Pradesh</td><td>Eastern Power Distribution Company of Andhra Pradesh Limited</td><td>APEPDCL</td></tr><tr><td>Assam</td><td>Assam Power Distribution Company Limited</td><td>APDCL</td></tr><tr><td>Bihar</td><td>North Bihar Power Distribution Company Limited</td><td>NBPDCL</td></tr><tr><td>Bihar</td><td>South Bihar Power Distribution Company Limited</td><td>SBPDCL</td></tr><tr><td>Calcutta</td><td>Calcutta Electric Supply Corporation Limited</td><td>CESC</td></tr><tr><td>Chandigarh</td><td>Chandigarh Electricity Department</td><td>CH_ELEC</td></tr><tr><td>Chhattisgarh</td><td>Chhattisgarh State Power Distribution Company Limited</td><td>CSPDCL</td></tr><tr><td>Daman &#x26; Diu</td><td>Daman and Diu Electricity Department</td><td>DAMAN_DIU</td></tr><tr><td>Delhi</td><td>Tata Power Delhi Distribution</td><td>TATA_DL</td></tr><tr><td>Delhi</td><td>BSES Yamuna Power Ltd / BSES Rajdhani Power Ltd</td><td>BSES_DL</td></tr><tr><td>Goa</td><td>Goa Electricity- for Tisvadi, Ponda &#x26; Verna</td><td>GOA_ELEC</td></tr><tr><td>Goa</td><td>Goa Electricity- for others</td><td>UPAY_GOA</td></tr><tr><td>Gujarat</td><td>Uttar Gujarat VIJ Company Ltd.</td><td>UGVCL</td></tr><tr><td>Gujarat</td><td>Pashchim Gujarat VIJ Company Ltd.</td><td>PGVCL</td></tr><tr><td>Gujarat</td><td>Madhya Gujarat VIJ Company Limited</td><td>MGVCL</td></tr><tr><td>Gujarat</td><td>Dakshin Gujarat VIJ Company Limited</td><td>DGVCL</td></tr><tr><td>Gujarat</td><td>Torrent Power Limited - Ahmedabad</td><td>TORRENT_AHD</td></tr><tr><td>Gujarat</td><td>Torrent Power Limited - Surat</td><td>TORRENT_SURAT</td></tr><tr><td>Gujarat</td><td>Torrent Power Limited - Agra</td><td>TORRENT_AGRA</td></tr><tr><td>Gujarat</td><td>Torrent Power Limited - Bhiwandi</td><td>TORRENT_BHIWANDI</td></tr><tr><td>Gujarat</td><td>Torrent Power Limited - Dahej</td><td>TORRENT_DAHEJ</td></tr><tr><td>Haryana</td><td>Dakshin Haryana Bijli Vitran Nigam</td><td>DHBVN</td></tr><tr><td>Haryana</td><td>Uttar Haryana Bijli Vitran Nigam</td><td>UHBVN</td></tr><tr><td>Himachal Pradesh</td><td>Himachal Pradesh State Electricity Board Ltd</td><td>HPSEB</td></tr><tr><td>Jharkhand</td><td>Jharkhand Bijli Vitran Nigam Limited</td><td>JBVNL</td></tr><tr><td>Karnataka</td><td>Mangalore Electricity Supply Company Limited</td><td>MESCOM</td></tr><tr><td>Karnataka</td><td>Bangalore Electricity Supply Company Ltd</td><td>BESCOM</td></tr><tr><td>Karnataka</td><td>Chamundeshwari Electricity Supply Company Limited Mysore</td><td>CESCOM</td></tr><tr><td>Karnataka</td><td>Gulbarga Electricity Supply Company Limited</td><td>GESCOM</td></tr><tr><td>Karnataka</td><td>Hubli Electricity Supply Company Limited</td><td>HESCOM</td></tr><tr><td>Kerala</td><td>Kerala State Electricity Board</td><td>KERALA</td></tr><tr><td>Madhya Pradesh</td><td>Madhya Pradesh Paschim Kshetra Vidyut Vitran Company Limited</td><td>MPWZ</td></tr><tr><td>Madhya Pradesh</td><td>Madhya Pradesh Madhya Kshetra Vidyut Vitran Company Limited</td><td>MPCZ</td></tr><tr><td>Madhya Pradesh</td><td>Madhya Pradesh Poorv Kshetra Vidyut Vitran Company Limited</td><td>MPEZ</td></tr><tr><td>Maharashtra</td><td>TATA-Power - Mumbai</td><td>TATA_MUMBAI</td></tr><tr><td>Maharashtra</td><td>MAHAVITARAN-Maharashtra State Electricity Distribution Co. Ltd (MSEDCL)</td><td>MAHAVITRAN</td></tr><tr><td>Maharashtra</td><td><p>Brihanmumbai Electric Supply &#x26; Transport Undertaking</p><p>for Greater Mumbai (BEST_MH)</p></td><td>BEST_MH</td></tr><tr><td>Meghalaya</td><td>Meghalaya Energy Corporation Limited</td><td>MeECL</td></tr><tr><td>Orissa</td><td>Supply Company of Orissa Limited (North, South, West, Central)</td><td>ORISSA</td></tr><tr><td>Punjab</td><td>Punjab State Power Corporation Limited</td><td>PSPCL</td></tr><tr><td>Rajasthan</td><td>Jaipur Vidhyut Vitran Nigam Ltd</td><td>JAIPUR</td></tr><tr><td>Rajasthan</td><td>Ajmer Vidhyut Vitran Nigam Ltd</td><td>AJMER</td></tr><tr><td>Rajasthan</td><td>Jodhpur Vidhyut Vitran Nigam Ltd</td><td>JODHPUR</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Chennai_North</p></td><td>CHENNAI_NORTH</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Villupuram</p></td><td>VILLUPURAM</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Coimbatore</p></td><td>COIMBATORE</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Erode</p></td><td>ERODE</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Madurai</p></td><td>MADURAI</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Trichy</p></td><td>TRICHY</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Tirunelvel</p></td><td>TIRUNELVEL</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Vellore</p></td><td>VELLORE</td></tr><tr><td>Tamil Nadu</td><td><p>Tamil Nadu Generation and Distribution Corporation</p><p>Limited - Chennai_South</p></td><td>CHENNAI_SOUTH</td></tr><tr><td>Telangana</td><td>The Southern Power Distribution Company of Telangana Limited</td><td>TSSPCL</td></tr><tr><td>Tripura</td><td>Tripura State Electricity Corporation Limited</td><td>TRIPURA</td></tr><tr><td>Uttar Pradesh</td><td>Kanpur Electricity Supply Company</td><td>KESCO</td></tr><tr><td>Uttar Pradesh</td><td>UP Vidyut Vitran Nigam Limited (All Zones)</td><td>UPPCL</td></tr><tr><td>WEST BENGAL</td><td><p>WEST BENGAL STATE ELECTRICITY DISTRIBUTION</p><p>COMPANY LIMITED</p></td><td>WBENGAL</td></tr></tbody></table>

#### Sample Post Parameters

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

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "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": "abc@gmail.com",
        "mobile_number": "xxxxxxxxxx"
    },
    "requested_at": "2026-03-03T07:10:01.373Z",
    "completed_at": "2026-03-03T07:10:02.310Z"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "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"
    }
}
```

{% endtab %}

{% tab title="200 : In progress" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

## Get details

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/electricity_bill_verification`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "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": "abc@gmail.com",
        "mobile_number": "xxxxxxxxxx"
    },
    "requested_at": "2026-03-03T07:10:01.373Z",
    "completed_at": "2026-03-03T07:10:02.310Z"
}
```

{% endtab %}

{% tab title="200: Inprogress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}