Company Reports

Retrieve company-specific research reports and analysis documents.

GET/3.0/research/company-reports

Description

This endpoint returns detailed research reports focused on specific companies and their analysis. Includes company valuations, financial analysis, sector comparisons, and investment recommendations.

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": 15,
  "data": [
    {
      "id": "64ad34123c85e1d1d902c9b8",
      "ref": 101,
      "cid": 18,
      "uid": 1001,
      "cat_ids": ["64ad34123c85e1d1d902c9a0"],
      "an_ids": ["507f1f77bcf86cd799439011"],
      "sy": ["UBL"],
      "sc": ["BANK"],
      "ic": ["KSE-100"],
      "tags": ["financial-analysis", "valuation", "buyback"],
      "ty": "Company Analysis",
      "tt": "United Bank Limited: Q4 FY2024 Earnings and Dividend Analysis",
      "dsc": "In-depth analysis of UBL's Q4 2024 financial performance with focus on earnings growth and capital allocation strategies. Report includes DCF valuation model and target price.",
      "str": "Fundamental Analysis",
      "np": 15,
      "thm": "64ad34123c85e1d1d902c9b8/thumbnail.jpg",
      "file": "64ad34123c85e1d1d902c9b8/report.pdf",
      "vid": null,
      "crt": "2024-12-05T10:30:00+05:00",
      "mod": "2024-12-05T10:30: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": "507f1f77bcf86cd799439011",
          "ref": 101,
          "cid": 18,
          "nm": "Ahmed Hassan Khan",
          "des": "Senior Research Analyst",
          "spc": "Banking & Financial Services"
        }
      ]
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Research report unique ID
`ref`	integer	Reference ID
`cid`	integer	Client/Organization ID
`uid`	integer	User/Author ID
`cat_ids`	array	Category IDs this report belongs to
`an_ids`	array	Analyst IDs who authored the report
`sy`	array	Stock symbols covered in the report
`sc`	array	Sector codes covered
`ic`	array	Index codes covered
`tags`	array	Report tags for classification
`ty`	string	Report type
`tt`	string	Report title
`dsc`	string	Report description
`str`	string	Strategy/methodology used
`np`	integer	Number of pages in report
`thm`	string	URL to report thumbnail image
`file`	string	URL to report file/PDF
`vid`	object \| null	Video information (if included)
`crt`	string (ISO 8601)	Report creation timestamp
`mod`	string (ISO 8601)	Report last modified timestamp
`cats`	array	Category details View
`ans`	array	Analyst details View

Categories Array Fields

Field	Type	Description
`id`	string	Category unique ID
`ref`	integer	Category reference ID
`cid`	integer	Client/Organization ID
`name`	string	Category name
`rows`	integer	Number of rows/items in category (if applicable)
`crt`	string (ISO 8601)	Category creation timestamp
`mod`	string (ISO 8601)	Category last modified timestamp

Analysts Array Fields

Field	Type	Description
`id`	string	Analyst unique ID
`ref`	integer	Analyst reference ID
`cid`	integer	Client/Organization ID
`nm`	string	Analyst name
`des`	string	Analyst designation/title
`spc`	string	Analyst specialization

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get All Company Reports

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

Use Cases

Company Analysis: Access detailed analysis of specific companies
Investment Research: Review professional equity research
Financial Planning: Use company insights for portfolio decisions
Valuation Analysis: Study company valuations and price targets

Description​

Request​

Authentication​

Parameters​

Response​

Success Response (200)​

Response Fields​

Categories Array Fields​

Analysts Array Fields​

Error Responses​

Examples​

Get All Company Reports​

Use Cases​