Quickstart
Get up and running with the TagLogger API in 5 minutes
1. Create an API Key
Open Settings → API Keys in your dashboard and click Create API key. Pick the permissions your integration needs, then copy the key—for your security it is shown only once. Creating your first key turns on API access for your workspace automatically.
Keys are prefixed so you can recognize them at a glance, and treat the whole string as a secret:
tl_live_xxxxxxxxxxxxxSee Authentication for how keys, headers, and scopes work.
2. Make Your First Request
List all your AirTags:
curl https://api.taglogger.com/v1/tags \ -H "Authorization: Bearer tl_live_xxxxxxxxxxxxx"
Successful responses are JSON envelopes of the form { "data": [ ... ], "nextCursor": null }. If you haven't added any tags yet, data comes back as an empty array. That's the expected first response, not an error.
3. Explore the API
Browse the API Reference for every endpoint, or download the OpenAPI specification to generate a typed client.
4. Real-Time Updates
Set up webhooks to receive notifications when your tags move or go offline. See Webhooks for details.
Next Steps
Troubleshooting
If a request is rejected, the JSON error body names the exact problem—an invalid key, a missing scope, or a rate limit. See Errors for every code and how to resolve it. You can revoke a key and create a new one at any time from Settings → API Keys.