Analyst Details

Retrieve a list of research analysts with their detailed information, qualifications, and career history.

GET/3.0/research/analysts

Description

This endpoint returns a comprehensive list of research analysts available on the platform, including their detailed profiles, specializations, qualifications, and career history. Useful for identifying analysts by expertise and background.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any parameters.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Ahmed Hassan Khan",
      "designation": "Senior Research Analyst",
      "specialization": "Banking & Financial Services",
      "qualification": "MBA Finance, CFA Level 3",
      "career": [
        {
          "title": "Senior Research Analyst",
          "company": "Capital Stake",
          "start_date": "2019-01-15",
          "end_date": null,
          "is_current": true
        },
        {
          "title": "Research Analyst",
          "company": "Pakistan Investment Bank",
          "start_date": "2015-06-01",
          "end_date": "2018-12-31",
          "is_current": false
        },
        {
          "title": "Junior Analyst",
          "company": "Lakson Securities",
          "start_date": "2013-08-01",
          "end_date": "2015-05-31",
          "is_current": false
        }
      ],
      "description": "Ahmed is a seasoned research analyst with 11+ years of experience in equity research. He specializes in banking, insurance, and financial services sectors with a strong track record of accurate earnings forecasts.",
      "photo": "https://assets.csapis.com/analysts/ahmed-hassan-khan.jpg",
      "email": "ahmed.hassan@capitalstake.com",
      "created": "2019-01-15T10:30:00+05:00",
      "modified": "2024-12-09T14:22:00+05:00"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Unique analyst ID
name	string	Analyst full name
designation	string	Job designation/title
specialization	string	Area of specialization
qualification	string	Educational qualifications
career	array	Career history array
description	string	Analyst biography and expertise description
photo	string	URL to analyst photo/profile image
email	string	Analyst email address
created	string (ISO 8601)	Record creation timestamp
modified	string (ISO 8601)	Record last modified timestamp

Career History Fields

Field	Type	Description
title	string	Job title in career position
company	string	Company name in career position
start_date	string	Career start date (YYYY-MM-DD format)
end_date	string	Career end date (nullable for current position)
is_current	boolean	Is current position indicator

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get All Analysts

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

Use Cases

• Analyst Selection: Find and identify analysts with specific expertise for research consumption
• Team Management: Manage analyst assignments and track analyst coverage
• Credibility Assessment: Review analyst qualifications, education, and career history
• Research Attribution: Track which analyst is responsible for specific research reports
• Coverage Map: Understand sector specialization distribution across analyst team