Electricity Fetch v3

Introduction

At Signzy, we use advanced and state of the art application program interface or APIs for a thorough and accurate electricity bill verification of any individual, by pulling out data from each state’s electricity board. Thanks to cutting edge technological innovations, we are able to access accurate and complete database to carry out electricity bill verification that any business may need. Here are the various kinds of information about an individual that can be verified using a thorough electricity bill verification process.

Identity

An electricity bill verification is proof of a person’s identity as it clearly states their legal name. So, any business can be sure that their customer is exactly who they claim to be, and not an identity thief.

Residential Address

The residential address of the individual is also clearly stated in their electricity bill or Utility bill. Therefore, an electricity bill verification proves that any business’ customer provides the correct information about themselves, without any intention of fraud. Plus, in case a fraud does happen, businesses have a way of contacting and tracking down anyone if they had incorporated a utility bill for address verification.

API Endpoint's

POST https://api-preproduction.signzy.app/api/v3/electricitybills/fetch

POST https://api.signzy.app/api/v3/electricitybills/fetch

Headers

Key	Value
Authorization	access token (returned as id field of login request)
Content-type	application/json

Request Data

{
    "electricityProvider": "MAHAVITRAN",
    "consumerNo": "173241540245",
    "mobileNumber": "",
    "installationNumber": ""
}

Field	Type	Required	Description
consumerNo	String	Yes	consumerNumber on electricity bill
electricityProvider	String	Yes	electricityProvider name short form (Please refer to the Electricity Board supported table below) Ex-APEPDCL
installationNumber	String	No	installationNumber to verify
mobileNo	String	No	mobileNo to verify

Response

{
    "result": {
        "name": "MR TUKARAM SHANKAR ",
        "address": "ATXXXXXXXXXXXXXXXXXXXXXXXXXXXXXTAS",
        "amountPayable": "330.00",
        "billAmount": "330.00",
        "billDate": "07/06/2024",
        "billDueDate": "",
        "billIssueDate": "",
        "billNo": "",
        "consumerNo": "173241540245",
        "email": "",
        "mobileNumber": "",
        "TariffCode": "",
        "SectionName": "",
        "DueAmount": "",
        "accountId": "",
        "billingUnit": "5886DOUND",
        "consumptionUnits": "",
        "electricityProvider": "MSEDCL",
        "splitAddress": {
            "district": [],
            "state": [
                []
            ],
            "city": [],
            "pincode": "",
            "country": [
                "IN",
                "IND",
                "INDIA"
            ],
            "addressLine": "ATXXXXXXXXXXXXXXXXXXXXXXXXXXXXXTAS"
        }
    }
}

Response Parameters

Response Parameter	Data Type	Parameter Description
name	String	Name of the account holder.
address	String	Full address of the consumer.
amountPayable	String	Amount currently due for payment.
billAmount	String	Total amount of the bill issued (As per latest bill)
billDate	String	Date the bill was generated (As per latest bill) in the format dd/mm/yyyy
billDueDate	String	Due date for the payment of the bill.(As per latest bill) in the format dd/mm/yyyy
billIssueDate	String	Date the bill was issued.(As per latest bill) in the format dd/mm/yyyy
billNo	String	Bill number or unique identifier of the bill.
consumerNo	String	Unique consumer number or ID.
email	String	Email address associated with the account.
mobileNumber	String	Mobile number associated with the account.
TariffCode	String	Code indicating the tariff type for billing.
SectionName	String	Name of the billing section.
DueAmount	String	Additional amount due if not paid by the due date.
accountId	String	Unique identifier for the consumer's account.
billingUnit	String	Billing unit or division serving the consumer.
consumptionUnits	String	Total electricity units consumed in the billing period.
electricityProvider	String	Name of the electricity provider.
splitAddress	Object	Contains the structured address details.
district	Array	List of districts associated with the address.
state	Array	List of states associated with the address.
city	Array	List of cities associated with the address.
pincode	String	Postal code of the address.
country	Array	List of country codes related to the address.
addressLine	String	Partial or complete address line.

Error Codes

Error Code	Description
400	Bad Request - The request is missing a required parameter, or the parameter values are invalid.
401	Unauthorized - The API request is not authorized. The API key or token provided is either invalid or does not have sufficient permissions to perform the requested action.
403	Forbidden - The API request is forbidden. The API key or token provided is valid, but the account associated with the key or token does not have sufficient permissions to perform the requested action.
404	Not Found - The requested resource could not be found. This error is typically returned when the URL is incorrect or when the requested resource has been deleted or moved.
429	Too Many Requests - The request exceeds the rate limit for the API. This error is typically returned when the API client has sent too many requests within a certain period of time.
500	Internal Server Error - The server encountered an unexpected error while processing the request. This error is typically returned when there is a problem with the API server.
503	Service Unavailable - The API service is temporarily unavailable. This error is typically returned when the API server is undergoing maintenance or is overloaded with too many requests.

Electricity Board supported ANDHRA PRADESH - EASTERN POWER DISTRIBUTION COMPANY OF ANDHRA PRADESH LIMITED (APEPDCL)
ANDHRA PRADESH - SOUTHERN POWER DISTRIBUTION COMPANY OF ANDHRA PRADESH LIMITED (APSPDCL)
ASSAM - ASSAM POWER DISTRIBUTION COMPANY LIMITED (APDCL)
BIHAR - NORTH BIHAR POWER DISTRIBUTION COMPANY LIMITED (NBPDCL)
BIHAR - SOUTH BIHAR POWER DISTRIBUTION COMPANY LIMITED (SBPDCL)
CHANDIGARH - CHANDIGARH STATE POWER DISTRIBUTION COMPANY LTD (CH_ELEC)
CHHATTISGARH - CHHATTISGARH STATE POWER DISTRIBUTION COMPANY LIMITED (CSPDCL)
DADRA & NAGAR HAVELI - DNH POWER DISTRIBUTION CORPORATION LTD (DNH)
DADRA & NAGAR HAVELI - DNH POWER DISTRIBUTION CORPORATION LTD (DNH)
DELHI - DELHI MUNCIPAL COUNCIL (MUNCIPAL_DL)
DELHI - NORTH - TATA POWER DELHI DISTRIBUTION LIMITED (TATA_DL)
GOA - GOA ELECTRICITY- FOR OTHERS (UPAY_GOA)
GOA - GOA ELECTRICITY- FOR TISVADI, PONDA & VERNA (GOA_ELEC)
GUJARAT - MADHYA GUJARAT VIJ COMPANY LIMITED (MGVCL)
GUJARAT - PASHCHIM GUJARAT VIJ COMPANY LTD. (PGVCL)
GUJARAT - UTTAR GUJARAT VIJ COMPANY LTD. (UGVCL)
GUJARAT - DAKSHIN GUJARAT VIJ COMPANY LIMITED (DGVCL)
HARYANA - DAKSHIN HARYANA BIJLI VITRAN NIGAM (DHBVN)
HARYANA - UTTAR HARYANA BIJLI VITRAN NIGAM (UHBVN)
KARNATAKA - HUBLI ELECTRICITY SUPPLY COMPANY LIMITED (HESCOM)
KARNATAKA - BANGALORE ELECTRICITY SUPPLY COMPANY LTD (For NON-RAPDRP TOWNS)
KARNATAKA - GULBARGA ELECTRICITY SUPPLY COMPANY LIMITED (GESCOM)
KARNATAKA - MANGALORE ELECTRICITY SUPPLY COMPANY LIMITED (MESCOM)
KARNATAKA - CHAMUNDESHWARI ELECTRICITY SUPPLY COMPANY LIMITED MYSORE (CESCOM)
KARNATAKA - BANGALORE ELECTRICITY SUPPLY COMPANY LTD (BESCOM)
KERALA - KERALA STATE ELECTRICITY BOARD (KSEB)
MADHYA PRADESH - MADHYA PRADESH MADHYA KSHETRA VIDYUT VITRAN COMPANY LIMITED (MPCZ)
MADHYA PRADESH - MADHYA PRADESH POORV KSHETRA VIDYUT VITRAN COMPANY LIMITED (MPEZ)
MADHYA PRADESH - MADHYA PRADESH PASCHIM KSHETRA VIDYUT VITRAN COMPANY LIMITED (MPWZ)
MAHARASHTRA - RELIANCE ENERGY - MUMBAI (RELIANCE_MH)
MAHARASHTRA - MAHAVITARAN-MAHARASHTRA STATE ELECTRICITY DISTRIBUTION CO. LTD (MSEDCL)
MAHARASHTRA - TATA-POWER - MUMBAI (TATA_MUMBAI)
NAGALAND - NAGALAND DEPARTMENT OF POWER (NAGALAND)
ORISSA - CENTRAL ELECTRICITY SUPPLY UTILITY OF ORISSA LTD (ORISSA_CENTRAL)
ORISSA - SUPPLY COMPANY OF ORISSA LIMITED (NORTH, SOUTH & WEST) (ORISSA)
PUNJAB - PUNJAB STATE POWER CORPORATION LIMITED (PSPCL)
SIKKIM - SIKKIM ENERGY AND POWER DEPT (SIKKIM)
TAMIL NADU - TAMIL NADU GENERATION AND DISTRIBUTION CORPORATION LIMITED (TNEB)
TELANGANA - THE SOUTHERN POWER DISTRIBUTION COMPANY OF TELANGANA LIMITED (TSSPDCL)
UTTARAKHAND - UTTARAKHAND POWER CORPORATION LTD (UPCL)
WEST BENGAL - CALCUTTA ELECTRIC SUPPLY CORPORATION (CESC)
WEST BENGAL - WEST BENGAL STATE ELECTRICITY DISTRIBUTION COMPANY LTD (WBSEDCL)