Stock Class Routes

The second thing to be created after the issuer (every issuer must have a stock class, with its corresponding id). To create an stock class, we have to know the issuerId (just like in the example below). Stock class will now have its own id.

stock-class/create

• Description: Creates a new stock class.
• Method: POST
• Parameters (body):
  • issuerId: The ID of the issuer (string).
  • data: The stock class data (object with the following fields):
    • name: The name of the stock class (string).
    • class_type: The type of stock class (string, e.g., "COMMON").
    • default_id_prefix: The default ID prefix (string).
    • initial_shares_authorized: The number of initial shares authorized (string).
    • votes_per_share: The number of votes per share (string).
    • price_per_share: The price per share (object with currency and amount).
    • seniority: The seniority of the stock class (string).
    • comments: Additional comments (array of strings).

{
    "issuerId": "92dddedd-251d-47cd-83ac-342f00e3d5a1",
    "data": {
        "name": "Series A Common",
        "class_type": "COMMON",
        "default_id_prefix": "CS-A",
        "initial_shares_authorized": "1000000",
        // "board_approval_date": "", // IF NO DATE, then omit
        "votes_per_share": "1",
        // "par_value": {}, // same as date
        "price_per_share": {
            "currency": "USD",
            "amount": "4.20"
        },
        "seniority": "1",
        // "conversion_rights": {}, // same as date
        // "liquidation_preference_multiple": "", // same as date
        // "participation_cap_multiple": "", // same as date
        "comments": []
    }
}

stock-class/id/:id

• Description: Retrieves details of a stock class by ID.
• Method: GET
• Parameters (URL):
  • id: The ID of the stock class (string).

stock-class/total-number

• Description: Retrieves the total number of stock classes.
• Method: GET