Investments API

This service manages virtual investments in teams during Kickstart — BizTech's startup-pitch competition. Attendees place virtual investments in teams they believe in, creating a funding leaderboard alongside the judging scores.

DynamoDB Table

Table: biztechInvestments (constant INVESTMENTS_TABLE). PK: id (investor email), SK: investmentID.

Handler: services/investments/handler.js

Endpoints

1. Make an Investment

Method: POST
Path: /invest

Request

{
  "investorId": "user123",
  "teamId": "team456",
  "amount": 1000,
  "comment": "Great pitch! Looking forward to your progress."
}

Description

Makes an investment in a team. Increments team's funding, decrements investor's balance, and creates a new investment record.

Response

{
  "message": "Investment successful"
}

Error Responses

400 Bad Request: If investor or team not found, or insufficient balance
500 Internal Server Error: If there's an issue updating the database

2. Get Team Funding Status

Method: GET
Path: investments/teamStatus/{teamId}

Request

Path Param	Description
teamId	Team’s ID

Description

Returns the funding status of a team, including the total funding received and a list of investments. Note that the investments here are NOT sorted.

Example Request

GET /investments/teamStatus/team456

Response

{
  "funding": 40600,
  "investments": [
    {
      "teamName": "test",
      "createdAt": 1754717442711,
      "isPartner": false,
      "eventID;year": "kickstart;2025",
      "amount": 10000,
      "teamId": "team456",
      "investorId": "benny@ubcbiztech.com",
      "investorName": "Benny",
      "comment": "Wonderful",
      "id": "5f41605b-2c3f-4c94-b730-18e6f126cfc3"
    },
    {
      "teamName": "test",
      "createdAt": 1754717442715,
      "isPartner": false,
      "eventID;year": "kickstart;2025",
      "amount": 10000,
      "teamId": "team456",
      "investorId": "benny@ubcbiztech.com",
      "investorName": "Benny",
      "comment": "Wonderful",
      "id": "6da2470c-cad5-4df6-a822-ff04c962363f"
    }
  ]
}

3. Get All Investments

Method: GET
Path: investments

Request

Query Param	Description
limit	Number of most recent investments to return

Description

Returns a list of all investments, sorted by most recent. Specifying an optional limit query parameter will limit the number of investments returned.

Example Request

GET /investments?limit=2
GET /investments

Response

[
  {
    "teamName": "test",
    "isPartner": false,
    "createdAt": "1729021722333",
    "eventID;year": "kickstart;2025",
    "amount": 20000,
    "teamId": "206abfa6-4b56-4316-af59-9cc3c1b0863c",
    "investorId": "benny@ubcbiztech.com",
    "investorName": "Benny",
    "comment": "SUPERB!!!",
    "id": "e0131a38-cedd-4ddd-a296-dcee3f31c7e6"
  },
  {
    "teamName": "test",
    "isPartner": false,
    "createdAt": "1729021722332",
    "eventID;year": "kickstart;2025",
    "amount": 500,
    "teamId": "206abfa6-4b56-4316-af59-9cc3c1b0863c",
    "investorId": "benny@ubcbiztech.com",
    "investorName": "Benny",
    "comment": "Fantastic",
    "id": "a7a4e318-0fd2-46fc-b48a-cdd970cccace"
  }
]