LoginSign up

AirPinpoint API Quickstart Guide

This guide will help you get started with the AirPinpoint API to track your Apple devices.

AirPinpoint API Quickstart Guide

This guide will help you get started with the AirPinpoint API to track your Apple devices.

Prerequisites

  • An Apple Mac with Find My enabled
  • An iCloud account with Find My enabled. We strongly recommend using a dedicated iCloud account (instead of a personal one) for managing your AirTags.
  • An AirPinpoint account

Steps

  1. Sign up for an account

  2. Start a free trial or choose a paid plan

    • From your dashboard, select "Start Free Trial" or choose a paid plan

  3. Sign into iCloud

  4. Get an API key

    • In your dashboard, click "Create API Key"
    • Copy the generated API key

  5. Make your first API request

    • Replace TRACKABLE_ID_HERE with your device's ID and YOUR_API_KEY with your actual API key
curl -X GET "https://api.airpinpoint.com/v1/trackables/TRACKABLE_ID_HERE" \
  -H "Authorization: Bearer YOUR_API_KEY"
  1. View the response
    • You should receive a JSON response with your device's details, with timestamps in UTC

Authentication

We support two methods of authentication (same key for both):

  1. API Key (X-API-Key header)
  2. Bearer Token (Authorization: Bearer token)

Here are examples of both authentication methods:

  1. Using X-API-Key Key:
curl -X GET "https://api.airpinpoint.com/v1/trackables/YOUR_TRACKABLE_ID/locations" \
  -H "X-API-Key: YOUR_API_KEY"
  1. Using Bearer Token:
curl -X GET "https://api.airpinpoint.com/v1/trackables/YOUR_TRACKABLE_ID/locations" \
  -H "Authorization: Bearer YOUR_API_KEY"

Replace YOUR_API_KEY with your actual credentials.

For security reasons, we recommend using environment variables to store your API key or token, rather than hardcoding them in your requests.

Next Steps