Trackable Devices

The Trackable Devices endpoints allow you to manage and interact with AirTags and other trackable devices associated with your account.

List Trackable Devices

Retrieve a list of all trackable devices associated with the authenticated user's account.

Endpoint

GET /trackables

Example Request

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

Example Response

{
  "trackables": [
    {
      "id": "tag_123456",
      "name": "Car Keys",
      "type": "airtag",
      "last_seen": "2023-06-15T14:30:00Z",
      "battery_level": 0.85
    },
    {
      "id": "tag_789012",
      "name": "Backpack",
      "type": "airtag",
      "last_seen": "2023-06-15T13:45:00Z",
      "battery_level": 0.72
    }
  ]
}

Get Trackable Device Details

Retrieve detailed information about a specific trackable device.

Endpoint

GET /trackables/{trackable_id}

Example Request

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

Example Response

{
  "id": "tag_123456",
  "name": "Car Keys",
  "type": "airtag",
  "last_seen": "2023-06-15T14:30:00Z",
  "battery_level": 0.85,
  "location": {
    "latitude": 37.7749,
    "longitude": -122.4194,
    "accuracy": 10
  },
  "is_lost_mode": false
}

Add or Modify a Trackable Device

To add or modify a trackable device, you should directly modify or remove them in your iCloud account. If you're on an enterprise plan, you can use the API to add or modify trackable devices. View the enterprise docs for more info