Trackables
List and manage your tracked devices
Trackables represent your AirTags and other Find My-enabled devices.
List all trackables
Returns all devices linked to your account with their latest location.
Response
JSON
{
"trackables": [
{
"id": "trk_abc123",
"model": "AirTag",
"name": "Delivery Van #3",
"enabled": true,
"pairedAt": "2024-01-10T09:15:22Z",
"lastKnownLocation": {
"latitude": 37.7749,
"longitude": -122.4194,
"timestamp": "2024-01-15T14:30:00Z",
"horizontalAccuracy": 10
},
"batteryInfo": {
"batteryLevel": 1,
"estimatedDaysRemaining": 200
}
}
]
}Query parameters
| Parameter | Default | Description |
|---|---|---|
limit | 50 | Results per page (1-100) |
skip | 0 | Results to skip for pagination |
Get a trackable
Retrieve details for a single device.
GET
/trackables/{trackableId}Get details for a specific device. Sign in to auto-populate your trackable ID.
Path Parameters
Trackable fields
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier |
model | string | Device type (AirTag, iPhone, etc.) |
name | string | Name from Find My |
enabled | boolean | Whether tracking is active |
pairedAt | string | When device was linked |
lastKnownLocation | object | Most recent location data |
batteryInfo | object | Battery status (AirTags only) |
Battery information
AirTags include battery status:
JSON
{
"batteryInfo": {
"batteryLevel": 1,
"lastBatteryReset": "2024-01-01T00:00:00Z",
"batteryMonths": 12,
"estimatedDaysRemaining": 200
}
}| Field | Description |
|---|---|
batteryLevel | 0=full, 1=medium, 2=low, 3=critical |
lastBatteryReset | When battery was last replaced |
batteryMonths | Expected battery life |
estimatedDaysRemaining | Calculated remaining days |
Get battery status
Terminal
curl -X GET "https://api.airpinpoint.com/v1/trackables/{trackableId}/battery" \
-H "Authorization: Bearer YOUR_API_KEY"Reset battery (after replacement)
Terminal
curl -X POST "https://api.airpinpoint.com/v1/trackables/{trackableId}/battery" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"batteryMonths": 12}'Tip
Reset the battery counter whenever you replace an AirTag battery to keep estimates accurate.
Location endpoints
For location-specific operations, see:
