For agents
REST mirror of the MCP tools. Organizer keys for /host; facility keys for /venue.
Machine schema: OpenAPI 3.1.
GET /api/v1/meanyGET /api/v1/gamesgames:readGET /api/v1/games/{slug}games:readGET /api/v1/venues/{slug}venues:readGET /api/v1/host/gameshost:games:readGET /api/v1/host/games/{id}host:games:readGET /api/v1/host/games/{id}/sharehost:games:readGET /api/v1/host/games/{id}/announcementhost:games:readGET /api/v1/venue/gamesvenue:games:readGET /api/v1/venue/games/{id}venue:games:readGET /api/v1/venue/games/{id}/sharevenue:games:readGET /api/v1/venue/games/{id}/announcementvenue:games:read| Endpoint | Scope | Notes |
|---|---|---|
GET /api/v1/me | any | Key + rate tier |
GET /api/v1/games | games:read | Discover search |
GET /api/v1/games/{slug} | games:read | Public game |
GET /api/v1/venues/{slug} | venues:read | Approved venue + upcoming |
GET /api/v1/host/games | host:games:read | Organizer key; range filters |
GET /api/v1/host/games/{id} | host:games:read | Host game |
GET /api/v1/host/games/{id}/share | host:games:read | Short share URL |
GET /api/v1/host/games/{id}/announcement | host:games:read | Pasteable text + link |
GET /api/v1/venue/games | venue:games:read | Facility key; upcoming|all |
GET /api/v1/venue/games/{id} | venue:games:read | Venue game |
GET /api/v1/venue/games/{id}/share | venue:games:read | Short share URL |
GET /api/v1/venue/games/{id}/announcement | venue:games:read | Pasteable text + link |
curl "https://gopikup.app/api/v1/games?lat=40.7&lng=-74&sport=soccer" \
-H "Authorization: Bearer gpk_live_…"