NomadMap API & Developer Hub
Platform Home MCP Server (AI) llms.txt OpenAPI Spec (JSON)
OpenAPI 3.0.3 REST / JSON Public Read · Token Actions MCP Server: /mcp

NomadMap Discovery & Events API

Access global digital nomad events, venues, curated collections, coworking & cafe opening hours, geolocation coordinates, direct booking links, and live court timeslots programmatically. Built for web applications, automated ingestion, and AI agents.

Base API Path: https://nomadmap.io/api  ·  MCP Endpoint: https://nomadmap.io/mcp

1. Authentication & Member Tiers

All GET, search, and discovery requests are completely open and public. Account tokens are used only for user-scoped actions (favorites, RSVPs, saved events).

# Primary Header (Recommended)
Authorization: Bearer nm_your_token_here

# Alternative Header
X-API-Key: nm_your_token_here
User TierAccess LevelPermissions
AnonymousPublic ReadGET discovery, events, places, collections, cities, categories
free / genRegistered MemberRSVP to events, bookmark favorites, view saved events
plus / proPremium MemberUnlock gated spots, direct booking links & exclusive timeslots

2. Event, Place & Collection Semantics

NomadMap treats scheduled gatherings, physical venues, and curated guides uniformly:

  • Events vs. Places: Events include start_dt (`DD.MM.YYYY HH:mm`) and ISO 8601 start_dt_iso. Places (coworkings, courts, cafes) have start_dt: null and display opening_hours.
  • Collections & Guides: Curated lists (type: "collection") containing ordered spots in collection_items, with automatic sibling navigation (prev_item / next_item).
  • Direct Booking Links: booklink provides external court, ticket, or venue reservation links (e.g. Simplifica, Playtomic, AirCourts).
  • Access Gating (min_user_type): Spots marked with plus or pro show sanitized previews to unauthorized users with is_locked: true.
  • Timeslots & Sports Courts: Places include structured court availability in timeslots_data.
  • Stable Slugs: Clean URLs like madeira-padel-courts work both on the web and in GET /api/data/event/{id}.
  • Pagination: Default batch size max: 12 with { size, total, offset, max, data } envelopes.

3. Quick Developer Workflows

A. List Active Nomad Cities & Counts 
curl -s "https://nomadmap.io/api/data/cities"
B. Search Events by Keyword & Setting 
curl -s "https://nomadmap.io/api/data/event?search=padel&setting=outdoor"
C. Search Physical Places & Coworking 
curl -s "https://nomadmap.io/api/data/places?loc=Funchal"
D. Proximity Radius (50km from GPS) 
curl -s "https://nomadmap.io/api/data/event?lat=32.65&lng=-16.91&dist=50"
E. Get Event or Place by Slug 
curl -s "https://nomadmap.io/api/data/event/padel-e-lazer"
F. Query via MCP (JSON-RPC 2.0) 
curl -s -X POST "https://nomadmap.io/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Interactive OpenAPI Explorer

Try API requests live directly in your browser