Quickstart

This guide gets you from API access to your first successful Livepin data call in a few minutes. You will generate credentials, create a bearer token, and fetch vehicle + latest location data.

1) Set your base URL

Livepin collections use LIVEPIN_API_BASE_URL as an environment variable.

export LIVEPIN_API_BASE_URL="https://api.livepin.in"

2) Access the Tracking Portal

Get your API credentials from the Livepin Access Tracking Portal:

https://app.livepin.in

3) Call your first protected endpoint

Once you have a JWT, pass it as a bearer token.

curl "$LIVEPIN_API_BASE_URL/api/vehicles" \
  -H "Authorization: Bearer $JWT_TOKEN"

4) Fetch latest locations

curl "$LIVEPIN_API_BASE_URL/api/vehicles/latest_locations" \
  -H "Authorization: Bearer $JWT_TOKEN"

5) Add report retrieval

Most dashboards combine current location with one or more report endpoints.

curl "$LIVEPIN_API_BASE_URL/api/vehicles/reports/km-report" \
  -H "Authorization: Bearer $JWT_TOKEN"

What's next?

You now have the minimum production-ready flow: authenticate, list vehicles, and fetch live coordinates.

• Authentication and token flows
• Vehicle and location endpoints
• Report endpoints for analytics
• Error handling patterns