ROLLIN API reference.

REST API over HTTPS. JSON request and response bodies. Authentication via the X-Api-Key header. Ten endpoints. Free tier covers 1,000 requests per month with no credit card. Starter tier ($9.99/mo) unlocks full address precision, photos, hours, and 5,000 monthly requests.

Base URL: https://joinrollin.com/api/v1. Full OpenAPI 3.1 spec at /openapi.yaml.

Authentication

Send your API key in the X-Api-Key header on every request. Keys start with a tier prefix: rlf_ (free), rls_ (starter), rld_ (developer), rlb_ (business), rle_ (enterprise).

curl -H "X-Api-Key: $ROLLIN_API_KEY" "https://joinrollin.com/api/v1/health"

A missing or invalid key returns 401 Unauthorized. A revoked or expired key returns 403 Forbidden.

Errors

Errors return standard HTTP status codes with a JSON body of the form { "error": { "code": "…", "message": "…" } }.

Rate limits

Per-minute and per-month limits scale with tier. Hitting a limit returns 429 with a Retry-After header (seconds). The /v1/health endpoint is unauthenticated and uncounted.

Pagination

List endpoints accept a limit parameter (default 20, max 100) and return a next_cursor field when more results are available. Pass the cursor back as cursor to fetch the next page.

Search venues by location, query, or both. Results are pre-sorted by accessibility score, descending.

Query parameters

curl -H "X-Api-Key: $ROLLIN_API_KEY" \
  "https://joinrollin.com/api/v1/locations?lat=40.7580&lng=-73.9855&radius=500&min_score=70&limit=20"

{
  "locations": [
    {
      "id": "abc-123-def",
      "name": "Devoción",
      "category": "cafe",
      "score": 86,
      "address": "69 Grand St, Brooklyn, NY 11249",
      "lat": 40.7148,
      "lng": -73.9614,
      "wheelchair_entry": true,
      "accessible_restroom": true,
      "level_entry": true,
      "accessible_parking": false,
      "wide_aisles": true,
      "elevator": null
    }
  ],
  "count": 20,
  "next_cursor": "eyJvZmZzZXQiOjIwfQ=="
}

Full venue detail including all six accessibility features, address, photos (Starter+), hours (Starter+), and verification status. Includes the sensory block — measured lighting and sound levels — on paid tiers (null where no readings exist yet); Free tier receives a locked stub {"locked": true, "min_tier": "developer"}.

curl -H "X-Api-Key: $ROLLIN_API_KEY" \
  "https://joinrollin.com/api/v1/locations/abc-123-def"

{
  "id": "abc-123-def",
  "name": "Devoción",
  "score": 86,
  "category": "cafe",
  "cuisine_type": "coffee",
  "address": "69 Grand St",
  "city": "Brooklyn",
  "state": "NY",
  "phone": "+17184843090",
  "website": "https://devocion.com",
  "hours": { "mon": "7-19" },
  "features": {
    "wheelchair_entry": true,
    "accessible_restroom": true,
    "level_entry": true,
    "accessible_parking": false,
    "wide_aisles": true,
    "elevator": null
  },
  "verified": true,
  "last_updated": "2026-04-22T18:13:00Z"
}

Fetch up to 50 locations by id in one request — one round trip instead of 50. Same location shape and tier gating as detail. Invalid or unknown ids are dropped silently; compare requested vs found in the response. Free-tier daily location limits apply.

curl -X POST -H "X-Api-Key: $ROLLIN_API_KEY" -H "Content-Type: application/json" \
  -d '{"ids": ["285b526b-fe60-4554-9c41-bb5ca8c298f7", "037fdaa9-e83a-4141-9a71-b8db62ba637e"]}' \
  "https://joinrollin.com/api/v1/locations/batch"

Incremental sync feed: locations whose profile or sensory data changed in the last days days (1–30, default 7). Minimal payload with a changed array (profile, sensory) — re-fetch full records via detail or batch. Poll daily to stay in sync instead of re-pulling entire regions.

curl -H "X-Api-Key: $ROLLIN_API_KEY" \
  "https://joinrollin.com/api/v1/changes?days=7&state=NY"

Coverage stats — 15 US states, 48 metro regions, total scored venues per region.

Detailed score breakdown — per-feature value, weight, and confidence.

curl -H "X-Api-Key: $ROLLIN_API_KEY" \
  "https://joinrollin.com/api/v1/score/abc-123-def"

{
  "id": "abc-123-def",
  "score": 86,
  "breakdown": {
    "wheelchair_entry": { "value": true, "weight": 22, "confidence": 0.95 },
    "accessible_restroom": { "value": true, "weight": 22, "confidence": 0.88 },
    "level_entry": { "value": true, "weight": 18, "confidence": 0.92 }
  }
}

Submit accessibility feedback or corrections for a venue. Reviewed by the ROLLIN team.

Body

curl -X POST -H "X-Api-Key: $ROLLIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"abc-123","type":"correction","message":"..."}' \
  "https://joinrollin.com/api/v1/feedback"

Current usage stats for the authenticated key. Shows used vs. limit across the per-minute, per-day, and per-month windows, plus the current tier.

curl -H "X-Api-Key: $ROLLIN_API_KEY" \
  "https://joinrollin.com/api/v1/usage"

{
  "tier": "starter",
  "minute": { "used": 3, "limit": 30 },
  "day": { "used": 42, "limit": 167 },
  "month": { "used": 1284, "limit": 5000 }
}

Public trial proxy. No API key required. IP-rate-limited to 5 requests, optionally tracked per-session via the X-Trial-Session header. Mirrors the regular endpoints under /v1/trial/locations, /v1/trial/locations/:id, /v1/trial/score/:id, /v1/trial/regions, /v1/trial/feedback, and /v1/trial/health with free-tier restrictions applied. Used by the MCP server’s trial mode.

# Public trial proxy — no key, IP-rate-limited (5 calls)
curl "https://joinrollin.com/api/v1/trial/locations?lat=40.7580&lng=-73.9855"

Status check. No API key required, doesn't count against quota. Use for liveness probes.

curl "https://joinrollin.com/api/v1/health"

{ "status": "ok", "version": "1.4.0" }

SDKs

Python — auto-generated by Stainless. Type-safe, async support, pagination built in.

OpenAPI 3.1 — full spec. Generate clients in any language with openapi-generator or Stainless.

TypeScript and Go SDKs are on the roadmap.

MCP server

The ROLLIN MCP server gives Claude Desktop, Cursor, VS Code, and any MCP-compatible client direct access to ROLLIN data through five tools. Two ways to connect: the hosted server (a URL, nothing to run) or the npm package via npx.

Hosted server (recommended)

Streamable HTTP at https://joinrollin.com/api/mcp. Send your API key as an Authorization: Bearer or X-Api-Key header. Any tier works, including Free.

claude mcp add --transport http rollin https://joinrollin.com/api/mcp \
  --header "X-Api-Key: $ROLLIN_API_KEY"