# Action Tokens

Action Tokens is a location-based rewards and AR platform. Partners integrate via a versioned REST API.

## Public API

- Human docs: https://action-tokens.com/docs
- OpenAPI 3.1: https://action-tokens.com/api/ar/v1/openapi
- API root (unauthenticated discovery): https://action-tokens.com/api/ar/v1
- Partner dashboard (get a key): https://action-tokens.com/ar-platform/dashboard
- Platform overview: https://action-tokens.com/ar-platform

Base URL: https://action-tokens.com/api/ar/v1
Auth: Authorization: Bearer <act_live_...>  (server-side only)
Idempotency: Idempotency-Key header on POST /experiences, /pins, /collections, /bounties
Rate limit: 120 requests / 60s per key. 429 includes Retry-After.

## Endpoints

GET  /health
GET  /experiences?externalId=&isActive=&metadata=&cursor=&limit=
POST /experiences          (upserts when externalId already exists)
GET  /experiences/{id}
PATCH /experiences/{id}
GET  /pins?externalId=&isActive=&bbox=&metadata=&cursor=&limit=
POST /pins                 (upserts when externalId already exists)
GET  /pins/{id}
PATCH /pins/{id}
DELETE /pins/{id}
GET  /pins/nearby?lat=&lng=&radius=
GET  /collections?externalUserId=&cursor=&limit=
POST /collections
POST /launch               (optional hosted AR; partners may use their own viewer)
GET  /bounties
POST /bounties
GET  /bounties/nearby?lat=&lng=&radius=

Pin metadata JSON, title, caption, and altitude are stored on the pin and returned from nearby + collections.
mediaType accepts image | video | model.
Collect allows partner GPS tolerance (default 15m) on top of collectionRadiusM.
Webhooks: set webhook_url in the dashboard. Events: pin.created, pin.updated, pin.deleted, pin.collected, experience.created, experience.updated.

Bounties created via POST /bounties land on the shared community bounty map at https://action-tokens.com/bounties

## Hosted map & embed widget

Partners configure a custom slug in the dashboard Map tab.
- Branded map: https://action-tokens.com/m/{slug}
- Embeddable iframe: https://action-tokens.com/embed/{slug}
- Public JSON (no auth): https://action-tokens.com/api/maps/{slug}