# Airpinpoint API

> REST API for tracking AirTags and Find My devices. Get real-time locations, location history, geofence alerts, and webhook notifications for fleet and asset tracking.

## Instructions for AI Agents

- Base URL: https://api.airpinpoint.com/v1
- Auth: pass API key as Bearer token in Authorization header OR as X-API-Key header. Both are equivalent.
- Rate limit: 100 requests/minute per API key
- All timestamps are ISO 8601 UTC
- Location history defaults to last 7 days if no start_time/end_time provided
- Geofence radius: 10-5000 meters. Limit: 10 geofences per account.
- Webhook signature: HMAC-SHA256 of JSON payload using webhookSecret, sent in X-Airpinpoint-Signature header
- Webhook retries: 3 attempts with backoff (5s, 30s, 120s)
- Share links: valid 1-168 hours
- Pagination: use skip/limit on all list endpoints

## Docs

- [Quickstart](https://airpinpoint.com/docs/quickstart): Setup, first API call, auth methods
- [API Reference](https://airpinpoint.com/docs/api): All endpoints, error codes, rate limits
- [Trackables](https://airpinpoint.com/docs/trackables): List/get devices, battery info, battery reset
- [Locations](https://airpinpoint.com/docs/locations): Current location, history with time range query params
- [Geofences](https://airpinpoint.com/docs/geofences): CRUD geofences, webhook config, test webhooks
- [Webhooks](https://airpinpoint.com/docs/webhooks): Payload format, signature verification, retry policy, delivery history
- [Share Links](https://airpinpoint.com/docs/share-links): Generate temporary public location share URLs
- [Account](https://airpinpoint.com/docs/account): Get/update account info

## Optional

- [Airpinpoint Essentials](https://airpinpoint.com/docs/airpinpoint-essentials): Dashboard UI guide, auto check-in/out, billing plans
- [Setup (Self-Service)](https://airpinpoint.com/docs/setup): Link your own AirTags via Mac
- [Troubleshooting](https://airpinpoint.com/docs/troubleshooting): Common setup issues

## Full Documentation

- [llms-full.txt](https://airpinpoint.com/llms-full.txt): Complete API documentation as a single markdown file for AI consumption