API Reference

123 endpoints across 22 categories. All authenticated endpoints require a Supabase session or Bearer token.

Authentication

Most endpoints require authentication via Supabase Auth. Include a valid session cookie or pass a Bearer token in the Authorization header:

Authorization: Bearer <supabase_access_token>

Endpoints marked with "No auth" are public or use rate-limiting only.

System

Health checks, configuration status, and platform statistics.

Opportunities

CRUD for government and business opportunities tracked in the pipeline.

Clients

Client relationship management with opportunity and pipeline statistics.

Proposals

Proposal creation, management, and AI-powered generation.

Intel

Intelligence feed items, processing, and reports.

Documents

Document upload, listing, entity extraction, and management.

Team

Team member management and task assignments.

Competitors

Track and monitor competitors in your market.

Watchlist

Keyword and topic watchlists for monitoring opportunities and intel.

Alerts

System alerts and notifications.

Digest

Periodic intelligence digests with multiple output formats.

Search and AI

Semantic search, AI Q&A, entity comparison, and summarization.

Entities

Extracted entities (organizations, people, topics) from documents.

Export

Export data in CSV or JSON format.

Reports and Briefs

Generate reports and strategic briefs.

Inbox

Review inbox for document processing results and entity conflicts.

Conflicts

Entity and data conflict resolution.

Webhooks

Manage webhook subscriptions for real-time event notifications.

Settings

User and platform settings.

Analytics

Platform analytics and performance metrics.

Processing

Document processing pipeline, job queue, and worker management.

Admin

Administrative endpoints, cron jobs, scrapers, and workers.

Rate Limiting

All endpoints are rate-limited. When exceeded, you will receive a 429 response with a retryAfter field in seconds. Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1708000000

Error Responses

All errors return JSON with an error field:

{ "error": "Unauthorized" }           // 401
{ "error": "Not found" }               // 404
{ "error": "Too many requests...", "retryAfter": 30 }  // 429
{ "error": "Internal server error" }   // 500