Developer
Ceven API
Programmatic access to the agents, the workflows, and the data they produce. Trigger any workflow, read any artifact, subscribe to any event.
What you can do
Benchmark pricing
Query market rates for any procurement category. Get p25/p50/p75 ranges backed by real transaction data.
Manage contracts
Upload contracts and get AI-extracted terms, renewal dates, risk flags, and compliance gaps.
Track spend
Push invoice and PO data. Get savings opportunities, anomaly detection, and budget variance alerts.
Search vendors
Look up vendors by category with ratings, compliance status, and negotiation history.
Receive webhooks
Get notified when contracts expire, spend spikes, savings are confirmed, or approvals are needed.
Run procurement agents
Trigger AI agents for invoice auditing, vendor sourcing, negotiation prep, and license optimization.
Authentication
API access requires an approved key. Submit the request form below to apply. Once approved, include your key as a Bearer token in every request:
curl -H "Authorization: Bearer ck_live_..." https://api.ceven.io/v1/benchmarks?category=saasAll requests must use HTTPS. Plaintext HTTP requests are rejected.
Endpoints
Full endpoint documentation is provided with your API key. Below are the primary resources.
/v1/benchmarks
Query market pricing benchmarks for a procurement category.
Spend category (e.g. saas, telecom, office-cleaning, insurance).
Geographic filter (e.g. US-West, EU, APAC).
{
"category": "saas",
"p25": 8.50,
"p50": 12.00,
"p75": 18.00,
"unit": "per seat/month",
"sample_size": 1240
}/v1/vendors
Search your vendor directory. Returns vendors scoped to your workspace.
Search query.
Filter by spend category.
/v1/contracts/upload
Upload a contract PDF. Returns AI-extracted terms including pricing, renewal dates, termination rights, and risk flags.
/v1/savings
List verified savings records. Filter by date range, vendor, or category.
Start date.
End date.
Filter by vendor name.
Webhooks
Subscribe to events and receive POST requests at your endpoint when things happen in your workspace. Configure webhooks from the dashboard or via the API.
A contract is within 90 days of expiry.
A savings opportunity has been verified.
Spend anomaly detected (spike, duplicate, off-market).
A purchase request needs approval.
A new vendor completed onboarding.
A contract was uploaded and analyzed.
Each webhook delivery includes an HMAC signature in the X-Ceven-Signature header for verification.
Quick start
Python
import requests
benchmarks = requests.get(
"https://api.ceven.io/v1/benchmarks",
headers={"Authorization": "Bearer ck_live_..."},
params={"category": "saas"}
).json()
print(f"Market median: $" + "{benchmarks['p50']}" + "/seat/month")JavaScript
const res = await fetch(
"https://api.ceven.io/v1/benchmarks?category=saas",
{ headers: { Authorization: "Bearer ck_live_..." } }
);
const data = await res.json();
console.log(`Market median: $${data.p50}/seat/month`);Errors
Standard HTTP status codes. Error responses include a machine-readable code and human-readable message.