Built to be driven by code

REST endpoints for links, analytics, QR codes, barcodes, and conversion tracking; signed webhooks on every scan; and an MCP server so an AI assistant can manage links without the dashboard. API access is included on Enterprise at $19.99 a month.

Get an API key See pricing

Authentication

Send your key as a Bearer token. Keys are stored as SHA-256 hashes and scoped to one workspace. The API allows 100 requests per minute per workspace.

curl https://reroutehq.com/api/v1/analytics \
  -H "Authorization: Bearer $RR_API_KEY"

{
  "totalScans": 18422,
  "topLinks": [
    { "shortId": "menu", "scans": 6120 },
    { "shortId": "q3-flyer", "scans": 4380 }
  ],
  "countries": [
    { "country": "US", "count": 11204 },
    { "country": "CA", "count": 3311 }
  ]
}

Endpoints

GET/api/v1/links

List links with search, tag filter, sort, and pagination (up to 100 per page).

POST/api/v1/links

Create a link. Optional custom short ID, tags, iOS and Android URLs, expiry, or scan limit.

GET/api/v1/links/:id

Fetch one link by UUID.

PATCH/api/v1/links/:id

Update destination, tags, pixels, expiry, scan limit, or active state.

DELETE/api/v1/links/:id

Soft-delete a link (sets isActive to false).

POST/api/v1/links/bulk

Create, update, or soft-delete up to 100 links in one call.

GET/api/v1/links/:id/analytics

Per-link scan analytics for a date range.

GET/api/v1/analytics

Time series, totals, top links, devices, browsers, countries, cities, UTM, and referrers.

GET/api/v1/analytics/export

Export raw scan events as CSV (up to 50,000 rows).

POST/api/v1/qr

Render a QR code as PNG or SVG (100–4096 px) with custom colors.

POST/api/v1/barcode

Render UPC-A, EAN-13, EAN-8, ITF-14, GS1-128, or Code 128 with check-digit checks.

POST/api/v1/track

Record a conversion for a scan click ID (rr_cid) to attribute revenue.

MCP server

Point an MCP client at POST /api/mcp. Use the same Bearer API key and the same workspace rate limit as REST. Transport is stateless JSON-RPC (no SSE stream). Four tools: list_links, create_link, get_analytics, and track_conversion.

claude_desktop_config.json

{
  "mcpServers": {
    "reroute": {
      "url": "https://reroutehq.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Full tool arguments and response shapes are in the dashboard Developers documentation. Machine-readable REST: /api/v1/openapi. MCP analytics uses a trailing daysBack window, not the full REST time-series export.

Webhooks

Register an HTTPS endpoint. On each scan the platform sends event scan.created, signed with HMAC-SHA256 in the x-reroute-signature header. Delivery runs after the redirect, so a slow endpoint does not delay the scanner.

Rate limits

API, per workspace100 / min
Redirects, per IP60 / min
Auth attempts, per IP10 / min

Every response carries the standard X-RateLimit headers.

Full reference lives in the dashboard

Create an account to get a key. The Developers tab has request and response shapes, webhook payloads, conversion attribution (rr_cid), and MCP tools. OpenAPI is public at /api/v1/openapi.

Create an account