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	Stock symbols covered in the report
sector	array	Sector codes covered
tags	array	Report tags for classification
title	string	Report title
description	string	Report description
thumbnail	string	URL to report thumbnail image
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