API catalog
RFC 9727 API catalog in Linkset JSON format.
Developer Docs
OweMeter API and Agent Discovery
This page is the human-readable entry point for OweMeter's public API discovery surface. Automated clients should prefer the API catalog, OpenAPI description, OAuth metadata, MCP server card, and Agent Skills index linked below.
Discovery Endpoints
OpenAPI
OpenAPI 3.1 description for the public and representative protected endpoints.
OpenID configuration
OIDC discovery metadata mirrored on the app domain.
OAuth authorization server
OAuth 2.0 authorization server metadata for automated clients.
OAuth protected resource
Resource metadata that points clients to the right authorization server.
MCP server card
SEP-1649 style discovery document for the public MCP endpoint.
Agent skills index
Agent Skills discovery index for public OweMeter capabilities.
Authentication
Public discovery endpoints are unauthenticated. Protected export and receipt routes use OweMeter's Clerk-backed identity stack. Automated clients should discover auth by reading the OpenID or OAuth metadata on this domain, then follow the underlying Clerk issuer for authorization and token endpoints.
HTTP API Surface
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET | /api/status | public | Health and discovery status for the public HTTP surface. |
| GET | /api/blog | public | Paginated published blog feed with optional category and limit filters. |
| GET | /api/mcp | public | Read-only MCP endpoint for discovery, help topics, and public blog search. |
| GET | /api/export/expenses/{groupId} | session | Generate CSV or PDF expense exports for an authorized group member. |
| GET | /api/export/settlements/{groupId} | session | Generate CSV or PDF settlement exports for an authorized group member. |
| GET | /api/export/summary/{groupId} | session | Generate CSV or PDF summary exports for an authorized group member. |
| POST | /api/receipts/upload | session | Upload receipt files for an expense when the caller is a group member. |
| GET | /api/receipts/{receiptId}/{variant} | session | Fetch an original, display, or thumbnail receipt asset for authorized members. |
| GET | /api/cron/run | secret | Trigger scheduled reminder and recurring-expense jobs with a cron secret. |
| GET | /api/group-reminders/open | public | Pixel endpoint used for reminder email open tracking. |
| GET | /api/group-reminders/click | public | Redirect endpoint used for reminder click tracking. |