Skip to content
UltimateTeam.ai Docs

Get latest weekly win report

GET
/api/v1/reports/weekly-win
curl --request GET \
  --url https://api.ultimateteam.ai/api/v1/reports/weekly-win \
  --header 'X-API-Key: <X-API-Key>'

Returns the weekly win report with business metrics, team activity, focus areas, and cumulative value tracking.

Authorizations

Section titled “Authorizations”

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
WeeklyWinResponse

Envelope response for the weekly win endpoint.

Attributes: data: The weekly win payload. meta: Standard response metadata.

object
data
required
WeeklyWinData

Inner data payload for the weekly win response.

Attributes: week_number: ISO week number of the report. this_week: Weekly business metrics. team_activity: Summary of agent actions. next_week: Focus areas for the coming week. cumulative: All-time cumulative metrics. platform_cost: Total platform spend to date. value_delivered: Total value delivered to date. value_multiple: ROI multiple (value / cost).

object
cumulative
required
CumulativeMetricsSchema

All-time metrics since the tenant first joined the platform.

Attributes: weeks_active: Number of weeks the tenant has been active. total_revenue_attributed: Lifetime revenue attributed to the team. total_costs_saved: Lifetime costs the team identified as savings. total_hours_saved: Lifetime human-equivalent hours saved. total_value_delivered: Sum of revenue + savings + time value. roi_multiple: Total value divided by total platform cost.

object
roi_multiple
Roi Multiple
number
0
total_costs_saved
Total Costs Saved
number
0
total_hours_saved
Total Hours Saved
number
0
total_revenue_attributed
Total Revenue Attributed
number
0
total_value_delivered
Total Value Delivered
number
0
weeks_active
Weeks Active
integer
0
next_week
Next Week
object
key
additional properties
string
platform_cost
Platform Cost
number
0
team_activity
required
TeamActivitySchema

Summary of all agent actions during the reporting period.

Attributes: total_actions: Total discrete actions taken by all agents. outreach_sent: Number of outreach messages dispatched. social_posts: Number of social media posts created. emails_handled: Number of emails processed or sent. support_tickets: Number of support interactions handled. reports_generated: Number of internal reports produced. competitive_alerts: Number of competitive intelligence alerts. estimated_hours_saved: Estimated human-equivalent hours saved.

object
competitive_alerts
Competitive Alerts
integer
0
emails_handled
Emails Handled
integer
0
estimated_hours_saved
Estimated Hours Saved
number
0
outreach_sent
Outreach Sent
integer
0
reports_generated
Reports Generated
integer
0
social_posts
Social Posts
integer
0
support_tickets
Support Tickets
integer
0
total_actions
Total Actions
integer
0
this_week
required
WeeklyMetricsSchema

Key business metrics for a single week.

Attributes: revenue_total: Total revenue attributed to the AI team this week. revenue_change_pct: Percentage change from the previous week. new_customers: Count of new customers acquired. reactivated_customers: Count of dormant customers won back. costs_saved: Estimated costs saved by the AI team. highlight: The most emotionally impactful moment of the week.

object
costs_saved
Costs Saved
number
0
highlight
Highlight
string
""
new_customers
New Customers
integer
0
reactivated_customers
Reactivated Customers
integer
0
revenue_change_pct
Revenue Change Pct
number
0
revenue_total
Revenue Total
number
0
value_delivered
Value Delivered
number
0
value_multiple
Value Multiple
number
0
week_number
required
Week Number
integer
meta
ResponseMeta

Standard metadata included in every API response.

Attributes: request_id: Unique identifier for this request. timestamp: When the response was generated.

object
request_id
Request Id

Unique identifier for this request

string
timestamp
Timestamp

When the response was generated

string format: date-time
Example
{
  "data": {
    "cumulative": {
      "roi_multiple": 0,
      "total_costs_saved": 0,
      "total_hours_saved": 0,
      "total_revenue_attributed": 0,
      "total_value_delivered": 0,
      "weeks_active": 0
    },
    "platform_cost": 0,
    "team_activity": {
      "competitive_alerts": 0,
      "emails_handled": 0,
      "estimated_hours_saved": 0,
      "outreach_sent": 0,
      "reports_generated": 0,
      "social_posts": 0,
      "support_tickets": 0,
      "total_actions": 0
    },
    "this_week": {
      "costs_saved": 0,
      "highlight": "",
      "new_customers": 0,
      "reactivated_customers": 0,
      "revenue_change_pct": 0,
      "revenue_total": 0
    },
    "value_delivered": 0,
    "value_multiple": 0
  }
}