In development — launching Q3 2026

API Reference

A fully RESTful API for every MapState resource — properties, sources, sync, embed tokens, and workspace management. Build your own integrations, automate your data pipeline, and manage multiple workspaces programmatically.

Authentication

Bearer token

All API requests require a Bearer token in the Authorization header. Generate API keys from Settings → API.

GET /api/v1/properties
Authorization: Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
GET /api/v1/properties

Returns a paginated list of properties in your workspace.

{
  "data": [
    {
      "id": "prop_01j8k...",
      "title": "3BR Apartment, Haussmann",
      "price_amount": 850000,
      "geo_lat": 48.8584,
      "geo_lng": 2.2945,
      "is_published": true,
      "quality_score": 85
    }
  ],
  "meta": {
    "total": 1842,
    "page": 1,
    "per_page": 50,
    "pages": 37
  }
}
POST /api/v1/sources/{id}/sync

Trigger a sync for a source programmatically. Returns a run object with counts.

{
  "success": true,
  "run_id": "run_01j9m...",
  "created": 124,
  "updated": 38,
  "unchanged": 1680,
  "errors": 0,
  "duration_ms": 2340
}

What's coming in v1

Full CRUD for properties & sources
Bulk import endpoint (up to 10k records)
Workspace & user management
Embed token generation
Sync run history & logs
Webhooks for outbound events
GraphQL layer (v2)
SDK for Node.js and Python