Get Electricity Operator Code List

Endpoint Overview

GET /api/v1/utility/electricity/operator-code-list

Description

This API endpoint retrieves a comprehensive list of electricity operator codes mapped to their respective states across India. The endpoint provides a standardized reference for electricity operators, enabling applications to present users with accurate options when processing electricity bill payments or verifying utility information.

Key Benefits

Simplifies electricity bill payment integration by providing standardized operator codes

Enables region-specific service offerings based on state and operator availability

Reduces errors in utility bill payments by using validated operator codes

Supports nationwide coverage with comprehensive state-operator mappings

Use Cases

Fintech

Government Services

Utility Management

Integrate electricity bill payment options within financial applications

Validate electricity operator details during utility payment processing

Build state-specific payment flows based on available operators

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	JWT Bearer token for authentication. Format: `Bearer <your_token>`
Content-Type	Yes	Set to `application/json`

Request Body

This endpoint does not require a request body as it's a GET request that returns a static list of operator codes.

Process Response

Response Parameters

Parameter	Type	Description
data	Array	List of electricity operators with their state and code information
data[].state	String	Name of the Indian state or region
data[].operator_code	String	Unique code identifying the electricity operator
status_code	Integer	HTTP status code of the response (200 for success)
message_code	String	Short code indicating the result of the request
message	String	Human-readable message describing the result
success	Boolean	Indicates whether the request was successful

Example Successful Response

{
    "data": [
        {
            "state": "Assam",
            "operator_code": "AS"
        },
        {
            "state": "Rajasthan",
            "operator_code": "AJ"
        },
        {
            "state": "Andra Pradesh",
            "operator_code": "APS"
        },
        // Additional operators omitted for brevity
    ],
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Authentication Error

Server Error

{
    "status_code": 401,
    "message_code": "unauthorized",
    "message": "Invalid or expired token",
    "success": false
}

This error occurs when the JWT token is missing, invalid, or expired.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data security

Implement proper error handling for authentication failures

User Experience Guidelines

Cache the operator list to reduce API calls and improve application performance

Implement a search or filter functionality to help users find their state/operator quickly

Group operators by state when displaying options to users

Include both state and operator code in user interfaces for clarity

Code Samples

cURL

Python

Node.js

Related APIs

Electricity Bill Payment API - Allows payment of electricity bills using operator codes

Electricity Bill Verification API - Verifies electricity bill details before payment

Utility Provider Status API - Checks operational status of utility providers

Compliance and Legal Considerations

When implementing electricity bill payment services, ensure compliance with local regulations regarding utility payments and data privacy. Different states may have specific requirements for handling utility payment information. Always inform users about how their utility information will be used and stored in accordance with data protection laws.

{ "data": [ { "state": "Assam", "operator_code": "AS" }, { "state": "Rajasthan", "operator_code": "AJ" }, { "state": "Andra Pradesh", "operator_code": "APS" }, { "state": "West Bengal", "operator_code": "BG" }, { "state": "Karnataka", "operator_code": "BS" }, { "state": "Bses Rajdhani Delhi", "operator_code": "BR" }, { "state": "Bses Yamuna Delhi", "operator_code": "BY" }, { "state": "Chandigarh", "operator_code": "CD" }, { "state": "Chattisgarh", "operator_code": "CH" }, { "state": "Karnataka", "operator_code": "CS" }, { "state": "Daman And Diu", "operator_code": "DDM" }, { "state": "Gujarat", "operator_code": "DG" }, { "state": "Haryana", "operator_code": "DH" }, { "state": "Delhi Tata", "operator_code": "DL" }, { "state": "Dadara Nagar Havelli", "operator_code": "DNH" }, { "state": "Goa", "operator_code": "GO" }, { "state": "Karnataka", "operator_code": "GS" }, { "state": "Himachal Pradesh", "operator_code": "HP" }, { "state": "Karnataka", "operator_code": "HS" }, { "state": "Rajasthan", "operator_code": "JD" }, { "state": "Rajasthan", "operator_code": "JP" }, { "state": "Kanpur", "operator_code": "KP" }, { "state": "West Bengal", "operator_code": "KC" }, { "state": "Gujarat", "operator_code": "MG" }, { "state": "Maharashtra", "operator_code": "MH" }, { "state": "Madhya Pradesh", "operator_code": "MPC" }, { "state": "Madhya Pradesh", "operator_code": "MPE" }, { "state": "Madhya Pradesh", "operator_code": "MPW" }, { "state": "Karnataka", "operator_code": "MS" }, { "state": "Mumbai Tata Maharashtra", "operator_code": "MU" }, { "state": "Mumbai Adani Maharashtra", "operator_code": "AEML" }, { "state": "Bihar", "operator_code": "NB" }, { "state": "Nagaland", "operator_code": "NG" }, { "state": "Odisha", "operator_code": "OD" }, { "state": "Gujarat", "operator_code": "PG" }, { "state": "Punjab", "operator_code": "PN" }, { "state": "Bihar", "operator_code": "SB" }, { "state": "Torrent Gujarat", "operator_code": "TG" }, { "state": "Telangana", "operator_code": "TL" }, { "state": "Tamil Nadu", "operator_code": "TN" }, { "state": "Tripura", "operator_code": "TR" }, { "state": "Gujarat", "operator_code": "UG" }, { "state": "Haryana", "operator_code": "UH" }, { "state": "Uttarakhand", "operator_code": "UK" }, { "state": "Uttar Pradesh", "operator_code": "UP" } ], "status_code": 200, "message_code": "success", "message": "Success", "success": true }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Get State List

Get Electricity Operator Code List#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses