API examples
Examples
Start the API and PostgreSQL with make up, then try these curl examples. Each topic has working request and response samples.
View full API reference → API endpoint
01
Recommendations
POST /api/recommendations with min_vcpu, min_ram_gb, arch, region_constraint. Ranked results with score and explain block.
Read →
02
TCO example
Egress, storage, public IP. Full cost breakdown when data source and traffic are provided.
Read →
03
Other endpoints
Health, providers, regions, instance types. GET examples with query params.
Read →
04
Interactive docs
Swagger UI at /docs. Try any endpoint in the browser.
Read →