Events Feed — How to Use
This guide walks you through accessing the BusinessCalendar.ai events feed API. Follow the steps below to start retrieving structured event data.
⚠️ Before You Start
Browser access will not work. The events feed endpoint requires specific HTTP headers. You must use
curl, a REST client, or your application's HTTP library to make requests.Make sure you have reviewed the AI Access Policy and agree to the Data License before proceeding.
Required Headers
Every request to the events feed must include the following headers for identification and policy compliance:
- 1
X-AI-Consumer— Your organization or application name (e.g., "MyCalendarApp") - 2
X-AI-Purpose— Brief description of how you use the data (e.g., "event-aggregation") - 3
X-AI-Key— (Optional) Your API key if you have been issued one for elevated access
Example: Fetch All Events
curl — List Eventscurl -X GET https://api.amaspc.com/api/events \
-H "X-AI-Consumer: MyCalendarApp" \
-H "X-AI-Purpose: event-aggregation" \
-H "Accept: application/json"
Example: Fetch Single Event
curl — Event Detailcurl -X GET https://api.amaspc.com/api/events/evt_12345 \
-H "X-AI-Consumer: MyCalendarApp" \
-H "X-AI-Purpose: calendar-sync" \
-H "Accept: application/json"
Response Format
The events feed returns JSON with the following structure:
JSON Response{
"events": [
{
"id": "evt_12345",
"title": "Q1 Business Networking Mixer",
"date": "2026-04-15T18:00:00-07:00",
"end_date": "2026-04-15T20:00:00-07:00",
"location": {
"name": "Olympia Chamber of Commerce",
"address": "809 Legion Way SE, Olympia, WA 98501",
"lat": 47.0379,
"lng": -122.9007
},
"category": "Networking",
"description": "Join fellow business professionals...",
"organizer": "Olympia Chamber of Commerce",
"url": "https://api.amaspc.com/events/evt_12345",
"source": "BusinessCalendar.ai"
}
],
"total": 142,
"page": 1,
"per_page": 25
}
Troubleshooting
- ❓403 Forbidden — Missing required headers. Make sure
X-AI-ConsumerandX-AI-Purposeare set. - ❓429 Too Many Requests — You have exceeded the rate limit. Wait and retry with exponential backoff.
- ❓Empty Response — Check that you are requesting the correct endpoint path and using valid query parameters.
- ❓HTML Instead of JSON — You may be hitting the frontend URL instead of the API. Ensure the path starts with
/api/.
Related Resources
- 🚀AI & Developer Gateway — Overview and quickstart
- 📋AI Access Policy — Rules and restrictions
- ⚖️AI Data License — Legal terms