REST API
Integrate ride-share history into your own tools.
The Dromos API gives you programmatic access to VIN lookups, search history, and credit balance. API access is included on every paid plan.
Token auth
A single API key per account. Regenerate any time from your dashboard.
Credit-based
Each VIN lookup via the API costs one credit, same as the dashboard.
JSON responses
Clean, consistent JSON. Platform match, trip count, location, and vehicle identity.
Base URL
https://dromos.io/api/
Authentication
Pass your API key as a token in the Authorization header on every request.
Authorization: Token your_api_key_here
Endpoints
GET
/api/vehicles/lookup/?vin={VIN}
Look up a VIN. Returns ride-share status, trip count, rental location, listing dates, and vehicle identity. Costs one credit.
{
"vin": "1HGCM82633A123456",
"make": "Honda",
"model": "Accord Sport",
"year": 2019,
"ride_share_found": true,
"trip_count": 847,
"location": "Miami, FL",
"listed_from": "2021-03",
"listed_to": "2024-01"
}
GET
/api/vehicles/history/
Returns your full search history, paginated. Includes VIN, result, and timestamp for each lookup.
GET
/api/credits/
Returns your current credit balance.
Example request
curl -X GET "https://dromos.io/api/vehicles/lookup/?vin=1HGCM82633A123456" \
-H "Authorization: Token your_api_key_here"