API Documentation
Access battery.mom data programmatically. Build your own EV comparison tools, integrate with your applications, or analyze Southeast Asian EV market data.
Rate Limits
100 requests per hour per IP address. Contact us for higher limits.
Base URL
https://battery.mom/apiGET
/vehicles
Retrieve electric vehicle data. Filter by country, availability, and search terms.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
country | string | Filter by country (SG, MY, ID, TH, VN, PH) |
available | boolean | Show only available vehicles (default: true) |
search | string | Search in vehicle names |
limit | number | Maximum results (default: 50, max: 1000) |
Example Request
curl "https://battery.mom/api/vehicles?country=SG&available=true&limit=10"
Example Response
[
{
"id": "uuid",
"country": "SG",
"name": "Tesla Model 3",
"modelTrim": "Long Range",
"batteryCapacityKwh": 75,
"rangeWltpKm": 580,
"efficiencyKwhPer100km": 13.0,
"basePriceLocalCurrency": 85000,
"batteryTechnology": "NMC",
"isAvailable": true,
"updatedAt": "2024-01-15T10:30:00Z"
}
]
GET
/vehicles/[id]
Get detailed information for a specific vehicle by ID.
Example Request
curl "https://battery.mom/api/vehicles/550e8400-e29b-41d4-a716-446655440000"
POST
/suggest-correction
Submit a correction for vehicle or BESS data. All submissions are reviewed before being applied.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | "ev" or "bess" |
country | string | Yes | Country code (SG, MY, ID, TH, VN, PH) |
vehicleName | string | Yes | Vehicle or product name |
field | string | Yes | Field being corrected |
currentValue | string | Yes | Current value in database |
suggestedValue | string | Yes | Suggested correction |
source | string | No | Source URL |
email | string | No | Contact email |
notes | string | No | Additional notes |
Example Request
curl -X POST "https://battery.mom/api/suggest-correction" \
-H "Content-Type: application/json" \
-d '{
"type": "ev",
"country": "SG",
"vehicleName": "Tesla Model 3 Long Range",
"field": "Battery capacity",
"currentValue": "75",
"suggestedValue": "82",
"source": "https://tesla.com/model3/specs",
"email": "user@example.com"
}'
Data License & Attribution
Our data is compiled from publicly available sources and manufacturer specifications. When using battery.mom data in your applications, please attribute us appropriately.
Suggested attribution:
Data provided by battery.momNeed help with the API or have questions about the data?
Contact Us