Special Event Reports

Retrieve research reports on special corporate events, market developments, and significant announcements.

GET/3.0/research/special-events

Description

This endpoint returns research reports focused on special events including IPOs, mergers and acquisitions, corporate restructuring, regulatory changes, and other significant market developments impacting specific companies or sectors.

Request

Authentication

Type: Bearer Token
Required: Yes

Parameters

Name	Type	Required	Description	Example
`symbol`	string	No	Stock symbol to filter company reports	`UBL`
`date_range`	string	No	Start date for filtering (format: `YYYY-MM-DD:YYYY-MM-DD`)	`2024-01-01:2024-12-31`
`offset`	integer	No	Number of records to skip for pagination	`0`
`count`	integer	No	Maximum number of records to return (default: 50)	`25`

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "count": 2,
  "offset": 0,
  "total": 5,
  "data": [
    {
      "id": "64ad34123c85e1d1d902c9ee",
      "ref": 401,
      "cid": 18,
      "uid": 1004,
      "cat_ids": ["64ad34123c85e1d1d902c9a4"],
      "an_ids": ["507f1f77bcf86cd799439014"],
      "sy": ["HUBCO"],
      "sc": ["POWER"],
      "ic": [],
      "tags": ["ipo", "capital-raise", "equity-dilution", "share-price-impact"],
      "ty": "Special Event Analysis",
      "tt": "HUBCO: IPO Impact Analysis and Valuation Assessment",
      "dsc": "Comprehensive analysis of HUBCO's IPO including pricing rationale, shareholder impact, capital allocation strategy, and long-term value creation potential.",
      "str": "Event Analysis",
      "np": 13,
      "thm": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9ee/thumbnail.jpg",
      "file": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9ee/report.pdf",
      "vid": null,
      "crt": "2024-11-10T07:30:00+05:00",
      "mod": "2024-11-10T07:30:00+05:00",
      "cats": [
        {
          "id": "64ad34123c85e1d1d902c9a4",
          "ref": 54,
          "cid": 18,
          "name": "Special Events",
          "rows": 6,
          "crt": "2024-01-01T00:00:00+05:00",
          "mod": "2024-01-01T00:00:00+05:00"
        }
      ]
    }
  ]
}

Response Fields

Same as Company Reports. See Company Reports documentation for field descriptions.

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get All Special Event Reports

curl -X GET "https://csapis.com/3.0/research/special-events" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

M&A Analysis: Evaluate merger and acquisition opportunities
IPO Assessment: Analyze new public offerings
Event-Driven Trading: Trade on significant corporate events
Risk Assessment: Understand risks from corporate restructuring
Strategic Planning: Inform corporate strategy based on peer events

Description​

Request​

Authentication​

Parameters​

Response​

Success Response (200)​

Response Fields​

Error Responses​

Examples​

Get All Special Event Reports​

Use Cases​