Research Reports by Organization

Retrieve research reports filtered by research organization or broker.

GET/3.0/research/reports

Description

This endpoint returns research reports filtered by research organization or broker organization. Useful for comparing research from different providers or accessing reports from specific research firms.

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": 3,
  "offset": 0,
  "total": 18,
  "data": [
    {
      "id": "64ad34123c85e1d1d902c9b9",
      "ref": 102,
      "cid": 18,
      "uid": 1002,
      "cat_ids": ["64ad34123c85e1d1d902c9a0"],
      "an_ids": ["507f1f77bcf86cd799439012"],
      "sy": ["MCB"],
      "sc": ["BANK"],
      "ic": ["KSE-100"],
      "tags": ["dividend-history", "capital-allocation"],
      "ty": "Company Analysis",
      "tt": "MCB Bank Limited: Dividend Sustainability and Growth Prospects",
      "dsc": "Comprehensive review of MCB's dividend policy, capital structure, and growth initiatives.",
      "str": "Fundamental Analysis",
      "np": 12,
      "thm": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9b9/thumbnail.jpg",
      "file": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9b9/report.pdf",
      "vid": null,
      "crt": "2024-12-03T14:15:00+05:00",
      "mod": "2024-12-03T14:15:00+05:00",
      "cats": [
        {
          "id": "64ad34123c85e1d1d902c9a0",
          "ref": 50,
          "cid": 18,
          "name": "Company Analysis",
          "rows": 25,
          "crt": "2024-01-01T00:00:00+05:00",
          "mod": "2024-01-01T00:00:00+05:00"
        }
      ],
      "ans": [
        {
          "id": "507f1f77bcf86cd799439012",
          "ref": 102,
          "cid": 18,
          "nm": "Fatima Malik",
          "des": "Senior Research Analyst",
          "spc": "Banking & Financial Services"
        }
      ]
    }
  ]
}

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 Research Reports

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

Use Cases

• Provider Comparison: Compare research from different organizations
• Analyst Tracking: Follow research from specific analysts
• Research Discovery: Find research by specific providers
• Research Curation: Build custom research lists by organization