...

Quickstart

Get started with the AirPinpoint API in under 5 minutes

Get up and running with AirPinpoint in just a few steps.

Prerequisites

  • An Apple Mac with Find My enabled
  • An iCloud account with Find My enabled
  • An AirPinpoint account

Use a dedicated iCloud account

We recommend using a dedicated iCloud account for managing your AirTags, not your personal one.

Setup

1. Create an account

Sign up at airpinpoint.com/register and start your free trial.

2. Connect iCloud

Link your iCloud account to access your AirTags:

  1. Go to your Dashboard
  2. Follow the iCloud sign-in prompts
  3. Complete 2FA verification if enabled

Note

See our detailed iCloud guide if you run into issues.

3. Get your API key

  1. Open Dashboard Settings
  2. Click Create API Key
  3. Copy and save your key securely

Make your first request

Once you have your API key, test it with a simple request:

GET/trackables

Lists all your trackable devices

Get Key

Example response

JSON
{
  "trackables": [
    {
      "id": "trk_abc123",
      "name": "Keys",
      "model": "AirTag",
      "lastSeen": "2024-01-15T10:30:00Z"
    }
  ]
}

Get location data

Fetch the latest location for a specific device:

GET/trackables/{trackableId}/locations

Returns location history for a device. Sign in to auto-populate your trackable ID.

Get Key

Path Parameters

Response

JSON
{
  "locations": [
    {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "timestamp": "2024-01-15T10:30:00Z",
      "accuracy": 10
    }
  ]
}

Authentication methods

We support two equivalent authentication methods:

Terminal
# Using Authorization header (recommended)
curl -X GET "https://api.airpinpoint.com/v1/trackables" \
  -H "Authorization: Bearer YOUR_API_KEY"
 
# Using X-API-Key header
curl -X GET "https://api.airpinpoint.com/v1/trackables" \
  -H "X-API-Key: YOUR_API_KEY"

Tip

Store your API key in environment variables rather than hardcoding it in your code.

Next steps

Location Tracking

Learn about location data formats and polling strategies

Geofencing

Set up virtual boundaries and receive alerts

Webhooks

Get real-time notifications for location events

API Reference

Complete endpoint documentation