API Reference
Olympus API Reference
Core conventions for authentication, endpoints, and error handling across all Olympus APIs.
Base URL
All endpoints are served over HTTPS.
https://api.olympus.new-odyssey.com
Authentication
Use a bearer token from your dashboard.
Authorization: Bearer YOUR_API_KEY
Rate Limits
Tiered by plan with generous burst limits.
429 on limit exceeded
Example request
Every Olympus API uses the same auth header and JSON responses. Start with a search request to validate your key.
Prefer an SDK? Browse language clientscurl "https://api.olympus.new-odyssey.com/v1/business/search?name=Acme%20Inc&state=CA" \ -H "Authorization: Bearer YOUR_API_KEY"
Endpoints by product
Browse core endpoints and jump into product docs.
JANUS
GET /v1/business/search
Search for business entities by name and state
GET /v1/business/{entity_id}
Get detailed entity information
CHIRON
GET /v1/license/verify
Verify a professional license by number, state, and profession
GET /v1/license/search
Search for licenses by professional name
DELPHI
GET /v1/filings/search
Search SEC filings by ticker, form type, and date
GET /v1/financials/{cik}
Get normalized financial statements
WS /v1/stream
Real-time WebSocket feed of new filings
DAEDALUS
GET /v1/permits/search
Search permits by location, type, and date
GET /v1/contractors/{license}
Get contractor permit history and profile
GET /v1/properties/{address}
Get all permits for a property
ATLAS
GET /v1/zip/{zip_code}
Get comprehensive data for a ZIP code
POST /v1/zip/batch
Query multiple ZIP codes at once
GET /v1/zip/{zip_code}/nearby
Find nearby ZIP codes within radius
PLUTUS
GET /v1/tax/rate
Get tax rate for an address
POST /v1/tax/calculate
Calculate tax amount for a transaction
POST /v1/tax/batch
Batch lookup for multiple addresses
Error codes
Olympus returns consistent HTTP status codes and machine-readable error payloads across all APIs.
400 Bad Request
Invalid parameters or malformed request.
401 Unauthorized
Missing or invalid API key.
403 Forbidden
Insufficient permissions for this endpoint.
404 Not Found
Resource not found or unsupported route.
429 Rate Limited
Request limit exceeded for your plan.
500 Server Error
Unexpected error on Olympus servers.