Endpoints
The full menu. Every route Churro serves, with request and response shapes.
GET
/v1/healthA quick taste test. Returns the API status and current timestamp — useful for uptime monitoring.
Response
{
"status": "fresh",
"timestamp": "2026-02-14T23:00:00Z",
"version": "1.0.0"
}
POST
/v1/quoteThe main course. Submit a product and base price, get back an AI-optimized price with a confidence score. This is where the magic (and the margins) happen.
Request
curl -X POST https://api.churro.ai/v1/quote \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"product_id": "prod_123",
"base_price": 10000,
"currency": "usd",
"segment": "enterprise"
}'
Response
{
"quote_id": "qt_987abc",
"optimized_price": 12400,
"currency": "usd",
"confidence": 0.97,
"factors": [
"high_demand",
"competitor_gap",
"historical_win_rate"
]
}
Parameters
product_idstringrequiredYour internal product identifier.base_priceintegerrequiredBase price in the smallest currency unit (cents).currencystringrequiredThree-letter ISO currency code.segmentstringCustomer segment for contextual pricing.GET
/v1/productsList all products in your account. Paginated, sorted by creation date. Think of it as your product catalog — fresh from the oven.
Response
{
"data": [
{
"id": "prod_123",
"name": "Premium Consultation",
"base_price": 15000,
"currency": "usd",
"status": "active"
}
],
"has_more": true
}