Electricity

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 addressverification.
Attitude towards Credit/Payments
Another benefit of an electricity bill verification is that other bill details like the current bill amount and due date, outstanding bills, payment history and more are available. Such information is valuable because they present the payment making trend of the individual, and this shows how reliable or financially responsible they are as individuals. So, businesses, especially financial institutions can decide from electricity bill verification if their customers are to be trusted. To know more about the latest developments in KYC and electricity bill verification, reach out to us at
API Endpoint's
UAT Endpoint
POST https://preproduction.signzy.app/api/v3/electricitybills/fetch
POST https://preproduction.signzy.app/api/v3/electricitybills/fetch
﻿
Production Endpoint
POST https://api.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
JSON
{
    "electricityProvider": "MAHAVITRAN",
    "consumerNo": "173241540245",
    "mobileNumber": "",
    "installationNumber": ""
}
{
    "electricityProvider": "MAHAVITRAN",
    "consumerNo": "173241540245",
    "mobileNumber": "",
    "installationNumber": ""
}
﻿
﻿
Field
Type
Required
Description
essentials.consumerNo
String
Yes
consumerNumber on electricity bill
essentials.electricityProvider
String
Yes
electricityProvider name short form
(Please refer to the Electricity Board supported table below)
Ex-APEPDCL
essentials.installationNumber
String
No
installationNumber to verify
essentials.mobileNo
String
No
mobileNo to verify
Response
JSON
{
    "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"
        }
    }
}
{
    "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"
        }
    }
}
﻿
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)
﻿

Fuel Price API

Email Scraper - Consent

Docs powered by Archbee

TABLE OF CONTENTS

Electricity Board supported

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

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

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.