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
date_range	string	No	Date range 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": "685ea7ca720f2c38da2c2bb3",
            "category_ids": [
                "6523c4b376022da50d4fe538"
            ],
            "analyst_ids": [
                "6523c4b376022da50d4fe535"
            ],
            "symbol": null,
            "sector": null,
            "tags": null,
            "title": "JS Daily Highlights - SBP Forex reserves and Oil & Gas  discovery update",
            "description": "",
            "thumbnail": "148/685ea7ca720f2c38da2c2bb3.webp",
            "created": "2025-06-27T14:16:42.04Z",
            "modified": "2025-06-27T14:16:44.158Z"
        },
        {
            "id": "685e44512c4bf9b6397f2188",
            "category_ids": [
                "6523c4b376022da50d4fe537"
            ],
            "analyst_ids": [
                "6511241f528f5a5108e07563"
            ],
            "symbol": [
                "AGTL"
            ],
            "sector": [
                "0801"
            ],
            "tags": null,
            "title": "AGTL: Agriculture slowdown weighs on volumes",
            "description": "",
            "thumbnail": "148/685e44512c4bf9b6397f2188.webp",
            "created": "2025-06-27T07:12:17.818Z",
            "modified": "2025-06-27T07:12:19.37Z"
        }
    ]
}

Response Fields

Field	Type	Description
id	string	Research report unique ID
category_ids	array	Category IDs this report belongs to
analyst_ids	array	Analyst IDs who authored the report
symbol	array|null	Stock symbols covered in the report (nullable)
sector	array|null	Sector codes covered (nullable)
tags	array|null	Report tags for classification (nullable)
title	string	Report title
description	string	Report description
thumbnail	string	Relative storage path to the report thumbnail (pass to the View Research Thumbnails endpoint)
created	string (ISO 8601)	Report creation timestamp
modified	string (ISO 8601)	Report last modified timestamp

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