# MapleSpike — Canadian Government Data API
> Primary-source infrastructure for AI agents that cite.

## API
Base URL: https://api.maplespike.ca/v1
Auth: Authorization: Bearer header or X-API-Key header
Response: { success, data, quality, citation, meta }

### Endpoints
- GET /v1/health — API health check with usage stats
- GET /v1/openapi.json — Full OpenAPI 3.1 specification
- GET /v1/me — Current tenant info and API keys
- GET /v1/usage — Current billing period usage
- GET /v1/gov/releases — Latest government data releases
- GET /v1/gov/search — Full-text search across all sources
- GET /v1/citation/:hash — Retrieve citation by SHA-256 hash
- POST /v1/register — Create account and API key
- GET /v1/verify/:token — Verify email address
- POST /v1/ai/ask — Ask a question, get a sourced answer (edge AI)
- POST /v1/ai/search — Semantic search with edge embeddings
- GET /v1/ai/models — List available AI models
- POST /v1/ai/analyze — Analyze text for bias, sentiment, claims
- POST /v1/auth/refresh — Refresh JWT token
- POST /v1/auth/logout — Clear session
- POST /v1/billing/checkout — Create checkout session
- GET /v1/billing/plans — Available pricing plans
- GET /v1/keys — List API keys
- POST /v1/keys — Create API key
- DELETE /v1/keys/:id — Delete API key
- POST /v1/keys/:id/rotate — Rotate API key
- GET /v1/signals — Cross-reference signals (requires engine)
- GET /v1/extraction/tasks — List browser extraction tasks for no-API portals
- POST /v1/extraction/results — Submit extracted data from browser client
- GET /v1/extraction/cached/:source_id — Get cached browser extraction results

### Data Categories
- committees — House of Commons and Senate committee evidence
- lobbying — Federal and provincial lobbying registry communications
- procurement — CanadaBuys contract awards and tenders
- gazette — Canada Gazette Parts I, II, III
- elections — Third-party advertiser registry, election data, political donations
- oversight — OAG, PBO, Ethics Commissioner, CRTC, Competition Bureau
- courts — Federal court decisions via CanLII
- influence — Tracked IOs, NGOs, think tanks, narrative tracking
- immigration — IRCC permanent resident data, LMIA, express entry, study/work permits
- defence — DND personnel, defence procurement
- health — Health Canada datasets, drug products, pharmaceuticals
- transport — Transport Canada, infrastructure, GTFS transit data
- indigenous — Indigenous services, statistics, First Nations data
- provincial — All 13 provinces and territories: ON, QC, BC, AB, SK, MB, NB, NS, NL, PE, NT, YT, NU
- municipal — Municipal open data across Canadian cities
- economic — StatCan CPI, GDP, labour, population, trade, Bank of Canada rates
- international — World Bank WDI, UN Comtrade, OECD, Eurostat, WHO, UNDP, UNHCR
- environment — NPRI, NRCAN, climate, fisheries, parks, species at risk
- corporate — SEDI insider trades, SEDAR+ filings, corporate registry, CIPO patents/trademarks
- housing — CMHC housing data, real estate, municipal housing
- extraction — Browser-extracted data from no-API government portals (NWT, Nunavut)