Welcome to the AirPinpoint API documentation. Our platform enables tracking of Apple AirTags and 3rd party devices.

1. Real-time Location Tracking: Live location data for AirTags and Apple MFI devices
2. Live Tracking Links: Share device locations with anyone
3. Geofencing: Get notifications when devices cross virtual boundaries
4. Enterprise: Fully managed iCloud, self-hosting capabilities, advanced geofencing features

Getting Started

To start using the AirPinpoint API:

1. Sign up for an account if you haven't already.
2. Choose a subscription plan or start with a free trial.
3. Create an API Key
4. Run the setup iCloud command on a Mac (below 15.0) signed in with your Apple ID with FindMy enabled. After you do this successfully, refresh and you'll see your AirTags and devices. IF you do not have access to a Mac, contact us and we can help you set up your account.

   Important: The Mac is only needed for this one-time setup step. Once configured, your devices will continue tracking through our infrastructure without requiring any Mac or iPhone to stay powered on.

5. Run the quickstart command

Once you've completed these steps, enable some tags and you'll be ready to start tracking! Our infrastructure handles all the tracking - you don't need to keep any devices powered on or connected.

API Reference

Dashboard

Wwhat you'll see when you log in - a table and a simple map showing where all your stuff is.

What you get:

• See where your devices are right now on the map
• Check battery life and when devices were last spotted
• Quick settings for each device
• Share tracking links with your team

Here's a simple example of retrieving a device's latest location:

curl -X GET "https://api.airpinpoint.com/v1/trackables/tag_123456/locations?limit=1" \
     -H "Authorization: Bearer YOUR_API_KEY"

Advanced Usage

AirPinpoint is intended to be used with AirPinpoint Tags, official Apple AirTags and MFI 3rd party Tags. Our tags last 3-5 years on a single battery. Apple AirTags ~1 year on a single battery. 3rd party tags vary from 6 months to 2 years.