Developer Platform

Access the AtlasBrokers API to search brokers, retrieve reviews, and integrate insurance tools into your applications. Build with our REST API, MCP Server, and Embed Widget API.

Authentication

All API requests require an API key passed in the Authorization header. Generate your key in Account Settings.

Header format

Authorization: Bearer atlas_your_api_key_here

Keys are prefixed with atlas_. Keep your API key secure and never expose it in client-side code.

Base URL

https://atlasbrokers.ca/api/v1

REST API Endpoints

GET /api/v1/brokers

Search and filter insurance brokers across Canada.

Query Parameters

`q`	string	Free-text search query (name, description)
`province`	string	Filter by province code (e.g. ON, BC, AB)
`city`	string	Filter by city name
`insuranceType`	string	Filter by insurance line (e.g. Auto, Home, Business)
`page`	integer	Page number (default: 1)
`limit`	integer	Results per page (default: 20, max: 100)

Response

{
  "data": [
    {
      "id": "clx...",
      "name": "Smith Insurance Group",
      "slug": "smith-insurance-group",
      "description": "Full-service insurance brokerage...",
      "province": "ON",
      "city": "Toronto",
      "averageRating": 4.7,
      "reviewCount": 42
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1250,
    "totalPages": 63
  }
}

GET /api/v1/brokers/:slug

Retrieve a full broker profile by slug.

Response

{
  "data": {
    "id": "clx...",
    "name": "Smith Insurance Group",
    "slug": "smith-insurance-group",
    "email": "info@smithinsurance.ca",
    "phone": "(416) 555-1234",
    "website": "https://smithinsurance.ca",
    "description": "Full-service insurance brokerage...",
    "rating": { "averageRating": 4.7, "totalReviews": 42 },
    "locations": [
      { "province": "ON", "city": "Toronto", "address": "..." }
    ],
    "insuranceLines": ["Auto", "Home", "Commercial"],
    "specialties": ["High-value homes", "Fleet"],
    "languages": ["English", "French"]
  }
}

GET /api/v1/reviews/:brokerId

Fetch paginated reviews for a specific broker.

Query Parameters

`page`	integer	Page number (default: 1)
`limit`	integer	Results per page (default: 20, max: 100)

Response

{
  "data": [
    {
      "id": "clx...",
      "rating": 5,
      "title": "Outstanding service",
      "content": "They helped me find the best rate...",
      "authorName": "Jane D.",
      "createdAt": "2025-12-01T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "totalPages": 3
  }
}

Code Examples

cURL

# Search brokers in Ontario
curl -H "Authorization: Bearer atlas_your_key" \
  "https://atlasbrokers.ca/api/v1/brokers?province=ON&limit=10"

# Get broker detail
curl -H "Authorization: Bearer atlas_your_key" \
  "https://atlasbrokers.ca/api/v1/brokers/smith-insurance-group"

# Get broker reviews
curl -H "Authorization: Bearer atlas_your_key" \
  "https://atlasbrokers.ca/api/v1/reviews/clx_broker_id_here"

JavaScript (fetch)

const API_KEY = "atlas_your_key";
const BASE_URL = "https://atlasbrokers.ca/api/v1";

// Search brokers
const res = await fetch(
  `${BASE_URL}/brokers?province=ON&city=Toronto&limit=20`,
  {
    headers: { Authorization: `Bearer ${API_KEY}` },
  }
);
const { data, pagination } = await res.json();
console.log(`Found ${pagination.total} brokers`);

// Get broker reviews
const reviewsRes = await fetch(
  `${BASE_URL}/reviews/${data[0].id}`,
  {
    headers: { Authorization: `Bearer ${API_KEY}` },
  }
);
const reviews = await reviewsRes.json();

MCP Server (JSON-RPC 2.0)

AtlasBrokers exposes an MCP-compatible server at /api/mcp for AI agent integrations using the JSON-RPC 2.0 protocol.

Endpoint

POST https://atlasbrokers.ca/api/mcp
Content-Type: application/json
Authorization: Bearer atlas_your_api_key_here

Available Tools

`search_brokers`	tool	Search brokers by province, city, insurance type, or free text
`get_broker`	tool	Retrieve a full broker profile by slug
`get_reviews`	tool	Fetch paginated reviews for a broker
`create_lead`	tool	Create a new lead in a workspace CRM
`get_quote`	tool	Generate an instant insurance quote
`compare_policies`	tool	Compare two insurance policies side-by-side

Available Resources

`broker://directory`	resource	Full broker directory with metadata, locations, and ratings
`broker://carriers`	resource	List of all 30 supported insurance carriers in Canada

Example: tools/list

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "search_brokers",
        "description": "Search insurance brokers across Canada",
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": { "type": "string" },
            "province": { "type": "string" },
            "city": { "type": "string" },
            "insuranceType": { "type": "string" },
            "limit": { "type": "integer", "default": 20 }
          }
        }
      }
    ]
  }
}

Example: tools/call — search_brokers

Request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_brokers",
    "arguments": {
      "province": "ON",
      "city": "Toronto",
      "insuranceType": "Auto",
      "limit": 5
    }
  }
}

Example: tools/call — create_lead

Request

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_lead",
    "arguments": {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "phone": "(416) 555-9876",
      "insuranceType": "Home",
      "notes": "Looking for high-value home coverage"
    }
  }
}

Embed Widget API

Embed insurance quote forms, broker directories, or review widgets directly into your website with a single script tag.

Quick Start

HTML snippet

<div id="atlas-widget"></div>
<script
  src="https://atlasbrokers.ca/widget.js"
  data-key="atlas_your_api_key_here"
  data-type="quote"
  data-theme="dark"
  async
></script>

Supported data-type values: quote, directory, reviews. Supported themes: light, dark, auto.

POST /api/v1/embed/quotes

Submit a quote request through the embed widget API.

Request

POST /api/v1/embed/quotes
Content-Type: application/json
Authorization: Bearer atlas_your_api_key_here

{
  "insuranceType": "Auto",
  "province": "ON",
  "postalCode": "M5V 2T6",
  "details": {
    "vehicleYear": 2024,
    "vehicleMake": "Toyota",
    "vehicleModel": "Camry",
    "driverAge": 32,
    "cleanRecord": true
  }
}

Response

{
  "data": {
    "quoteId": "qt_abc123",
    "insuranceType": "Auto",
    "quotes": [
      {
        "carrier": "Intact Insurance",
        "monthlyPremium": 142.50,
        "annualPremium": 1710.00,
        "coverage": "Comprehensive",
        "deductible": 500
      },
      {
        "carrier": "Aviva Canada",
        "monthlyPremium": 156.00,
        "annualPremium": 1872.00,
        "coverage": "Comprehensive",
        "deductible": 500
      }
    ],
    "expiresAt": "2026-03-10T00:00:00.000Z"
  }
}

GET /api/v1/embed/brokers

Fetch brokers for the directory embed widget.

Request

GET /api/v1/embed/brokers?province=ON&city=Toronto&limit=6
Authorization: Bearer atlas_your_api_key_here

Response

{
  "data": [
    {
      "name": "Smith Insurance Group",
      "slug": "smith-insurance-group",
      "city": "Toronto",
      "province": "ON",
      "averageRating": 4.7,
      "reviewCount": 42,
      "photoUrl": "https://atlasbrokers.ca/photos/smith.jpg",
      "insuranceLines": ["Auto", "Home", "Commercial"]
    }
  ],
  "total": 128
}

Rate Limits

API requests are rate-limited. If you exceed the limit, you will receive a 429 Too Many Requests response. Wait and retry after a short delay.

Default rate limit	100 requests per minute
Max page size	100 results per request
Response format	JSON

Error Codes

All error responses follow a consistent JSON format with an error field.

`401`	Missing or invalid API key
`404`	Resource not found
`422`	Invalid request parameters
`429`	Rate limit exceeded

Error response format

{
  "error": "Invalid or inactive API key"
}

Ready to Build?

Generate your API key and start integrating AtlasBrokers data into your applications today.

Get Your API Key