Skip to main content
The Tavryn REST API lets you drive the full procurement automation lifecycle programmatically: ingest SaaS and cloud contracts, trigger autonomous negotiation agents, approve spending decisions, query USDC wallet balances, and retrieve verified savings receipts. All API routes are served from your Tavryn deployment URL and every response is JSON.

Base URL

All API endpoints are relative to your Tavryn deployment URL. Replace <your-deployment-url> in every example with the origin of your Tavryn instance (for example, https://tavryn.app if you are using the hosted service).
If you are using the Tavryn hosted service, your base URL is https://tavryn.app. Self-hosted deployments use the domain you configured during setup.

Response Envelope

Every Tavryn endpoint wraps its payload in a standard envelope so you can check success before processing data. Successful response
Error response
The optional details field appears on validation errors and carries structured diagnostic information — for example, the list of specific fields that failed schema validation. For non-validation errors details is omitted.

HTTP Status Codes

Rate Limiting

Tavryn uses a sliding-window rate limiter on agent and cron routes to protect the autonomous pipeline from runaway callers. When you exceed the limit, the API returns HTTP 429 with a resetMs field indicating exactly how many milliseconds remain before your window resets.
Different agent routes carry different per-minute limits. POST /api/agent/run-now and GET /api/cron/daily are the most restrictive at 10 requests per minute. Other agent sub-routes (analyze, negotiate, reply, command) allow 20–30 requests per minute. Always implement backoff logic using the resetMs value returned in the 429 response body.
HTTP 429 response body

Available Endpoints

Contracts

Agent

Approvals

Transactions & Receipts

Business & Settings

Wallet

Import

Webhooks

Cron (Server-to-Server)

Demo

All endpoints (except /api/demo/session and /api/demo/reset-and-run) require an authenticated session or the appropriate secret header. See the Authentication page for details.

Explore the Reference

Authentication

Learn how session cookies, the businessId tenant scope, and the CRON_SECRET header work together to authenticate every API call.

Contracts

Create and manage the SaaS and cloud contracts that Tavryn monitors for upcoming renewal waste.

Agent

Trigger autonomous negotiation, waste analysis, and the full procurement loop on demand.

Approvals

Preview and consume cryptographically signed 1-tap approval links for spending decisions.

Wallet & Receipts

Query your USDC balance on the Arc network and retrieve verified savings receipts.

Business Settings

Fetch and update your organization’s spending policies and category budgets.