All API endpoints require a valid API key. Pass it as a Bearer token in the Authorization header. Keys are prefixed with atlas_.
Authorization: Bearer atlas_your_key_hereGenerate API keys in your workspace settings under Settings → API Keys. Keys can be scoped and revoked at any time.
Fetch brokers in Toronto with a single API call:
curl -X GET "https://atlasbrokers.ca/api/v1/brokers?province=Ontario&city=Toronto&limit=5" \
-H "Authorization: Bearer atlas_your_key_here"Returns a paginated list of published Canadian brokers. Filter by province, city, and service type. Results are sorted alphabetically by name.
| Name | In | Type | Description |
|---|---|---|---|
| q | query | string | Full-text search — matches broker name or description. |
| province | query | string | Filter by province name, case-insensitive. |
| city | query | string | Filter by city name, case-insensitive. Combines with province. |
| insuranceType | query | string | Filter by service type: Auto, Home, Commercial, Life, Real Estate, Mortgage, etc. |
| page | query | integer | Page number, 1-indexed. Default: 1. |
| limit | query | integer | Results per page. Max 100. Default: 20. |
{
"data": [
{
"id": "cld1234abc",
"name": "Atlas Insurance Group",
"slug": "atlas-insurance-group",
"description": "Independent brokerage serving Ontario since 2005.",
"province": "Ontario",
"city": "Toronto",
"averageRating": 4.7,
"reviewCount": 312
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1250,
"totalPages": 63
}
}curl -X GET "https://atlasbrokers.ca/api/v1/brokers?province=Ontario&city=Toronto&limit=5" \
-H "Authorization: Bearer atlas_your_key_here"Returns full details for a single published broker, including all locations, insurance lines, specialties, languages, and rating breakdown.
| Name | In | Type | Description |
|---|---|---|---|
| slugrequired | path | string | URL-friendly broker identifier. Found in the `slug` field of list results. |
{
"data": {
"id": "cld1234abc",
"name": "Atlas Insurance Group",
"slug": "atlas-insurance-group",
"email": "hello@atlasinsurance.ca",
"phone": "+1-416-555-0100",
"website": "https://atlasinsurance.ca",
"description": "Independent brokerage serving Ontario since 2005.",
"foundingYear": 2005,
"teamSize": "10-50",
"isVerified": true,
"rating": {
"averageRating": 4.7,
"totalReviews": 312
},
"locations": [
{
"province": "Ontario",
"city": "Toronto",
"address": "123 Bay Street",
"postalCode": "M5H 2R4",
"isPrimary": true
}
],
"insuranceLines": [
"Auto",
"Home",
"Commercial"
],
"specialties": [
"High-value homes",
"Small business"
],
"languages": [
"English",
"French"
]
}
}curl -X GET "https://atlasbrokers.ca/api/v1/brokers/atlas-insurance-group" \
-H "Authorization: Bearer atlas_your_key_here"401UnauthorizedMissing, invalid, or expired API key.403ForbiddenYour key does not have access to this resource.404Not FoundThe requested resource does not exist or is not published.422Unprocessable EntityRequest validation failed. Check the error message for details.429Too Many RequestsRate limit exceeded. Reduce request frequency.500Internal Server ErrorSomething went wrong on our end. Please try again or contact support.