Gas Connection Verification API

Endpoint Overview

POST /api/v1/gas-connection/verify

Description

The Gas Connection Verification API enables real-time verification of LPG gas connections across major providers in India. This endpoint validates customer details by cross-referencing mobile numbers with gas provider databases, returning comprehensive consumer information including connection status, distributor details, and service history. The API supports multiple gas providers and delivers instant verification results for seamless customer onboarding and service delivery.

This verification service helps businesses confirm the authenticity of gas connections, reduce fraud, and streamline customer verification processes in sectors requiring utility validation.

Key Benefits

Instant Verification: Real-time validation of gas connection details across major providers

Comprehensive Data: Complete consumer profile including distributor information and service history

Multi-Provider Support: Works with major LPG providers like Indane Gas

Fraud Prevention: Helps identify invalid or fraudulent gas connection claims

Use Cases

Financial Services

E-commerce & Delivery

Utilities & Telecom

Loan Applications: Verify utility connections as proof of residence during loan processing

KYC Compliance: Use gas connection details as additional identity verification

Credit Assessment: Validate customer address and utility payment history

Insurance Underwriting: Confirm residential status for home and life insurance policies

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.app

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

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	JWT Bearer token for API authentication
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
mobile_number	string	Yes	10-digit mobile number registered with the gas connection (without country code)
provider_name	string	Yes	Gas provider name. Supported values: "indane"

Example Request

{
    "mobile_number": "9876543210",
    "provider_name": "indane"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Main response data containing all gas connection information
data.client_id	string	Unique identifier for the verification request
data.mobile_number	string	Verified mobile number
data.provider_name	string	Gas provider name that was queried
data.indane_gas	object	Provider-specific gas connection details (varies by provider)
data.indane_gas.consumer_id	string	Unique consumer identifier from the gas provider
data.indane_gas.consumer_number	string	Consumer connection number
data.indane_gas.consumer_name	string	Name of the registered consumer
data.indane_gas.consumer_details	object	Detailed consumer information including connection type and status
data.indane_gas.consumer_details.consumer_relation_type	string	Type of gas connection (e.g., "LPG")
data.indane_gas.consumer_details.consumer_category	string	Consumer category (e.g., "Domestic", "Commercial")
data.indane_gas.consumer_details.consumer_status	string	Current status of the connection (e.g., "ACTIVE", "INACTIVE")
data.indane_gas.consumer_details.consumer_type	string	Connection type description
data.indane_gas.consumer_details.consumer_address	object	Complete registered address of the consumer
data.indane_gas.distributor_details	object	Information about the gas distributor/dealer
data.indane_gas.distributor_details.distributor_name	string	Name of the gas distributor
data.indane_gas.distributor_details.distributor_contact	string	Contact number of the distributor
data.indane_gas.distributor_details.distributor_address	object	Complete address of the distributor
status_code	number	HTTP status code (200 for success)
success	boolean	Indicates if the request was successful
message	string	Human-readable response message
message_code	string	Machine-readable response code

Example Successful Response

{
    "data": {
        "client_id": "gas_connection_XYZ1234567890",
        "mobile_number": "9876543210",
        "provider_name": "indane",
        "indane_gas": {
            "consumer_id": "7500000099999999",
            "consumer_number": "CX99999999",
            "consumer_name": "Ramesh Kumar",
            "consumer_details": {
                "consumer_relation_type": "LPG",
                "consumer_category": "Domestic",
                "mi_due_date": "2015-06-20",
                "relationship_uc_mid": "RL000000199999999",
                "consumer_status": "ACTIVE",
                "tube_change_date": "2012-03-15",
                "consumer_sub_status": "ACTIVE",
                "consumer_type": "Single Bottle Connection",
                "tube_change_due_date": "2022-03-15",
                "consumer_address": {
                    "line_1": "VILLAGE: RAJPUR",
                    "line_2": "PATNA",
                    "line_3": "NA",
                    "state": "Bihar",
                    "state_code": "BH",
                    "country": null,
                    "city": "NA",
                    "district": "PATNA",
                    "pin_code": "800001",
                    "district_code": "BR001"
                }
            },
            "distributor_details": {
                "distributor_code": "0000999999",
                "distributor_backlog_days": "2",
                "distributor_name": "RAJPUR INDANE GAS SERVICE",
                "distributor_contact": "9123456789",
                "distributor_address": {
                    "address_line_1": "MAIN ROAD, RAJPUR BAZAR",
                    "address_line_2": "NEAR PANCHAYAT BHAWAN",
                    "address_line_3": "PO- RAJPUR, DIST.-PATNA",
                    "state": null,
                    "state_code": "BH",
                    "country": "India",
                    "city": "PATNA",
                    "district": "PATNA",
                    "pin_code": "800002",
                    "district_code": "BR001"
                }
            }
        }
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

{
    "status_code": 401,
    "success": false,
    "message": "Token is missing. Please provide proper Authorization header with Bearer token",
    "message_code": "missing_token"
}

Returned when the JWT token is invalid, expired, or missing.

Integration Best Practices

Security Recommendations

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

Implement token refresh mechanisms to handle expired tokens gracefully

Use HTTPS for all API communications to protect sensitive data

Validate and sanitize mobile numbers before sending requests

Log API responses for audit trails while masking sensitive information

User Experience Guidelines

Provide clear feedback during verification process with loading indicators

Handle different provider formats gracefully in your user interface

Display comprehensive consumer information in a user-friendly format

Implement proper error handling with meaningful messages for end users

Cache successful verifications temporarily to reduce redundant API calls

Code Samples

cURL

Python

Node.js

Related APIs

Electricity Connection Verification: Verify electricity meter connections and consumer details

Water Connection Verification: Validate municipal water connection registrations

Mobile Number Verification: Confirm mobile number ownership and operator details

Address Verification: Cross-verify addresses across multiple utility databases

Compliance and Legal Considerations

Ensure proper consent is obtained from users before verifying their gas connection details

Store and process personal information in compliance with applicable data protection laws

Use verified data only for legitimate business purposes as per your privacy policy

Implement appropriate data retention and deletion policies for consumer information

Be aware that gas connection data may contain sensitive personal and address information

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/gas-connection/verify' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "mobile_number": "9876543210", "provider_name": "indane" }'

{ "data": { "client_id": "gas_connection_XYZ1234567890", "mobile_number": "9876543210", "provider_name": "indane", "indane_gas": { "consumer_id": "7500000099999999", "consumer_number": "CX99999999", "consumer_name": "Ramesh Kumar", "consumer_details": { "consumer_relation_type": "LPG", "consumer_category": "Domestic", "mi_due_date": "2015-06-20", "relationship_uc_mid": "RL000000199999999", "consumer_status": "ACTIVE", "tube_change_date": "2012-03-15", "consumer_sub_status": "ACTIVE", "consumer_type": "Single Bottle Connection", "tube_change_due_date": "2022-03-15", "consumer_address": { "line_1": "VILLAGE: RAJPUR", "line_2": "PATNA", "line_3": "NA", "state": "Bihar", "state_code": "BH", "country": null, "city": "NA", "district": "PATNA", "pin_code": "800001", "district_code": "BR001" } }, "distributor_details": { "distributor_code": "0000999999", "distributor_backlog_days": "2", "distributor_name": "RAJPUR INDANE GAS SERVICE", "distributor_contact": "9123456789", "distributor_address": { "address_line_1": "MAIN ROAD, RAJPUR BAZAR", "address_line_2": "NEAR PANCHAYAT BHAWAN", "address_line_3": "PO- RAJPUR, DIST.-PATNA", "state": null, "state_code": "BH", "country": "India", "city": "PATNA", "district": "PATNA", "pin_code": "800002", "district_code": "BR001" } } } }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Gas Connection Verify

Gas Connection Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses