LPG Details using Mobile

Fetch real-time LPG consumer information linked to a registered mobile number. Returns consumer profile, distributor details, product pricing, and booking eligibility.

Use Case

Leverage this API to verify and retrieve LPG consumer details before initiating payments or bookings. It’s well-suited for platforms facilitating LPG bill payments through BBPS, utility automation systems, and B2B payment aggregators handling large-scale transactions for corporates or residential communities.

Request

API URL: https://api.bulkpe.in/client/lpgDetailsFromMobile

Method: POST

Auth: Please refer to the Authorization page.

{ "mobile": "98XXXXXX10", //Enter Registered Mobile "reference": "TEST0000001" // Unique Reference ID of Choice }

Sample cURL request

curl --location 'https://api.bulkpe.in/client/lpgDetailsFromMobile' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <your_token>' \ --data '{ "mobile": "98XXXXXX10", "reference": "TEST0000001" }'

Response

{ "status": true, "statusCode": 200, "data": { "customerName": "Kavi", "customerAddress": { "AddressLine3": "ABCD NAGAR", "AddressLine2": "1", "AddressLine1": "MGR STREET, MADURAI", "State": "Tamil Nadu", "StateCode": "TN", "Country": null, "City": "MADURAI", "District": "MADURAI", "Pincode": "615748", "DistrictCode": "TN035" }, "customerMobile": "98XXXXXX10", "customerCategory": "Domestic", "customerType": "Double Bottle Connection", "customerNo": "1234", "consumerId": "7500000012345678", "consumerCategory": "Domestic", "tubeChangeDate": 1720742400, "tubeChangeDueDate": 1877558400, "distributorName": "JAYAKUMAR INDANE GAS AGENCY", "distributorAddress": { "AddressLine3": "MADURAI DISTRICT", "AddressLine2": "MELAVEETHI, MADURAI", "AddressLine1": "PLAT NO 57,THIYAGI MGR NAGAR EXT", "State": null, "StateCode": "TN", "Country": "India", "City": "MADURAI", "District": "MADURAI", "Pincode": null, "DistrictCode": "TN035" }, "distributorContact": "81XXXXXX93 / 96XXXXXX33 / 94XXXXXX04", "distributorCode": "0000XXXXX5", "distributorBacklogDays": "13", "paymentEligible": "Y", "bookingEligible": "Y", "bookingEligibilityFailureReason": null, "trackingId": "TEST0000001", "miDueDate": 1119225600, "orderDetails": { "TotalDue": null, "OrderStatus": null, "OrderType": null, "OrderSubType": null, "ListofOrderLineItems": null, "OrderChannel": null, "OrderNumber": null, "OrderId": null, "OrderTotal": null, "Source": null, "OrderRefNo": null, "OrderDate": null }, "productDetails": [ { "ProductPriceDet": { "PTDCharges": null, "DigitalPaymentIncentive": null, "SubsidyAmount": null, "RSP": "949" }, "ProductName": "14.2 Kg LPG Cylinder - Filled", "PromotionId": "1-6XXXXX", "ProductCode": "M000XX", "DefaultProduct": "Y", "Quantity": "2", "ProductId": "1-6CXXXX", "UnitSize": "14.2" } ], "reference": "TEST0000001" }, "message": "verified" }

Note:

All timestamp fields (tubeChangeDate, tubeChangeDueDate,miDueDate) are returned in Unix epoch format. Convert to IST before displaying to end users.

The reference field must be unique per request for reconciliation purposes.