...

API Reference

Complete reference for the AirPinpoint REST API

The AirPinpoint API lets you programmatically access location data, manage devices, and configure geofences.

Authentication

All requests require an API key in the Authorization header.

Terminal
curl -X GET "https://api.airpinpoint.com/v1/trackables" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get your API key

Generate an API key from your dashboard settings. Keep it secure—treat it like a password.

Base URL

Code
https://api.airpinpoint.com/v1

Try it live

Test the locations endpoint directly. If you're signed in, your API key will be auto-populated.

GET/trackables/{trackableId}/locations

Returns the most recent location for a trackable device. Sign in to auto-populate your trackable ID and API key.

Get Key

Path Parameters

Endpoints

EndpointDescription
/trackablesList and manage tracking devices
/trackables/{id}/locationsGet location history
/geofencesCreate and manage geofences
/share-linksGenerate sharing links
/webhooksConfigure event webhooks

Rate limits

  • 100 requests/minute per API key
  • Exceeding limits returns 429 Too Many Requests

Error responses

Errors return a JSON object with details:

JSON
{
  "error": {
    "code": "invalid_request",
    "message": "Required parameter 'trackableId' is missing"
  }
}

Status codes

CodeDescription
200Success
400Bad request—check your parameters
401Unauthorized—invalid or missing API key
404Resource not found
429Rate limit exceeded
500Server error

Webhooks

Note

Webhooks require an Enterprise plan.

Configure webhooks to receive real-time notifications for:

  • Location updates
  • Geofence entry/exit events
  • Low battery alerts
  • Device status changes

Set up webhooks in your dashboard settings or via the Webhooks API.