Documentation: gethapn.readme.io
API base URL: https://api.iotgps.io/v1
Everything is served over HTTPS — plain HTTP is not supported — and responses come back as JSON.
What the API is
The Hapn API is a set of HTTPS endpoints for working with your devices and your platform data: device messages, positions, alerts and insights. You can also subscribe to events with webhooks and manage those subscriptions programmatically, rather than polling for changes.
It runs on the same pipeline that powers the Hapn apps, so what you get through the API is the same data, at the same speed, as what you see on the map.
What you can build with it
- Location and device data — real-time and historical positions, device status, battery levels and sensor readings.
- Device management — configuration and behaviour, including bulk operations for larger fleets.
- Places and geofences — boundary management with entry and exit events.
- Alerts — alert configuration and triggered event notifications.
- Trips and activity — trip analysis and usage insights.
- Users and accounts — account management with permission controls.
Typical uses: pushing tracking data into an existing rental or dispatch system, driving your own dashboards, or automating something that would otherwise be manual work in the app.
Getting access
API access is enabled per account — it isn't on by default.
- Ask us to enable it. Contact your account manager, or support@gethapn.com.
- Get your credentials. The Customer Success team issues your client ID and client secret.
- Exchange them for a token. The Authentication guide in the documentation covers swapping your client ID and secret for a Bearer token, which every request then carries.
AEMP: a different thing worth not confusing
In Settings → API Credentials you'll also find AEMP tokens. AEMP (ISO 15143-3) is the standard telematics feed for construction and heavy equipment — it's how you hand your fleet's data to a customer, an OEM or a third-party system that speaks that standard. It is not the REST API described above, and the two are requested separately. See Connecting an OEM Telematics Provider to Hapn for the other direction — pulling a manufacturer's data into Hapn.
Getting help
- The documentation at gethapn.readme.io is the reference for endpoints, authentication and payload formats.
- Your account manager, if you have a dedicated one.
- Support at support@gethapn.com, or submit a ticket. Our team can help with authentication problems, endpoint questions and data formatting.
When you get in touch about an API problem, include the endpoint you called, the time, and the response you got back — it turns a long thread into a short one.
Comments
0 comments
Article is closed for comments.