Skip to content
UltimateTeam.ai Docs

Calculate ROI projection

POST
/api/v1/sales/roi/calculate
curl --request POST \
  --url https://api.ultimateteam.ai/api/v1/sales/roi/calculate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "current_tool_spend": 0, "employee_count": 1, "hours_finance": 5, "hours_marketing": 10, "hours_operations": 8, "industry": "general", "monthly_revenue": 1 }'

Calculate an illustrative ROI scenario from business metrics and fixed assumptions, not observed peer outcomes or causal ROI. This endpoint is public (no auth required) for marketing site and sales deck embedding.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
ROIInput

Business metrics input for ROI calculation.

Attributes: monthly_revenue: Current monthly revenue in USD. employee_count: Number of employees. hours_marketing: Weekly hours spent on marketing/sales. hours_finance: Weekly hours spent on finance/accounting. hours_operations: Weekly hours spent on operations/admin. current_tool_spend: Monthly spend on existing SaaS tools in USD. industry: Business industry vertical for benchmark selection.

object
current_tool_spend
Current Tool Spend

Monthly spend on existing SaaS tools in USD

number
0
employee_count
required
Employee Count

Number of employees

integer
> 0
hours_finance
Hours Finance

Weekly hours spent on finance/accounting

number
default: 5
hours_marketing
Hours Marketing

Weekly hours spent on marketing/sales activities

number
default: 10
hours_operations
Hours Operations

Weekly hours spent on operations/admin

number
default: 8
industry
Industry

Business industry vertical (e-commerce, professional_services, saas, restaurant, contractor, general)

string
default: general
monthly_revenue
required
Monthly Revenue

Current monthly revenue in USD

number
> 0

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
ROIResponse

Full ROI calculator response with input echo and projections.

Attributes: input_summary: Echo of the input parameters. projection: Calculated ROI projections. industry_benchmark: Industry vertical used for benchmarks. disclaimer: Legal disclaimer about projections.

object
disclaimer
required
Disclaimer
string
industry_benchmark
required
Industry Benchmark
string
input_summary
required
Input Summary
object
key
additional properties
any
projection
required
ROIProjection

Projected ROI results from UltimateTeam deployment.

Attributes: monthly_revenue_increase: Projected additional monthly revenue in USD. monthly_tool_savings: Cash reduction in existing tool spend in USD (the only component that nets against tool costs). monthly_time_value: Monetized value of hours saved in USD (labor value, never a cash reduction in tool spend). monthly_cost_savings: monthly_tool_savings + monthly_time_value. monthly_time_savings_hours: Projected monthly hours saved. annual_revenue_increase: Projected additional annual revenue in USD. annual_cost_savings: Projected annual cost savings in USD. annual_time_savings_hours: Projected annual hours saved. roi_multiple: Return on investment multiple (annual value / annual cost). payback_months: Months until ROI breaks even. recommended_plan: Suggested pricing plan based on business size. recommended_plan_price: Monthly price of recommended plan in USD.

object
annual_cost_savings
required
Annual Cost Savings
number
annual_revenue_increase
required
Annual Revenue Increase
number
annual_time_savings_hours
required
Annual Time Savings Hours
number
monthly_cost_savings
required
Monthly Cost Savings
number
monthly_revenue_increase
required
Monthly Revenue Increase
number
monthly_time_savings_hours
required
Monthly Time Savings Hours
number
monthly_time_value
Monthly Time Value
number
0
monthly_tool_savings
Monthly Tool Savings
number
0
payback_months
required
Payback Months
number
recommended_plan
required
Recommended Plan
string
recommended_plan_price
required
Recommended Plan Price
number
roi_multiple
required
Roi Multiple
number
Example
{
  "projection": {
    "monthly_time_value": 0,
    "monthly_tool_savings": 0
  }
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}