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

Name	Type	Required	Description	Example
cid	integer	No	Client ID to filter analysts assigned to a specific client	18

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "ref": 101,
      "cid": 18,
      "nm": "Ahmed Hassan Khan",
      "des": "Senior Research Analyst",
      "spc": "Banking & Financial Services",
      "qul": "MBA Finance, CFA Level 3",
      "cr": [
        {
          "ti": "Senior Research Analyst",
          "co": "Capital Stake",
          "sd": "2019-01-15",
          "ed": null,
          "ic": true
        },
        {
          "ti": "Research Analyst",
          "co": "Pakistan Investment Bank",
          "sd": "2015-06-01",
          "ed": "2018-12-31",
          "ic": false
        },
        {
          "ti": "Junior Analyst",
          "co": "Lakson Securities",
          "sd": "2013-08-01",
          "ed": "2015-05-31",
          "ic": false
        }
      ],
      "dsc": "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.",
      "ph": "https://assets.csapis.com/analysts/ahmed-hassan-khan.jpg",
      "em": "ahmed.hassan@capitalstake.com",
      "crt": "2019-01-15T10:30:00+05:00",
      "mod": "2024-12-09T14:22:00+05:00"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Unique analyst ID
ref	integer	Analyst reference number
cid	integer	Client ID the analyst is associated with
nm	string	Analyst full name
des	string	Job designation/title
spc	string	Area of specialization
qul	string	Educational qualifications
cr	array	Career history array
dsc	string	Analyst biography and expertise description
ph	string	URL to analyst photo/profile image
em	string	Analyst email address
crt	string (ISO 8601)	Record creation timestamp
mod	string (ISO 8601)	Record last modified timestamp

Career History Fields

Field	Type	Description
ti	string	Job title in career position
co	string	Company name in career position
sd	string	Career start date (YYYY-MM-DD format)
ed	string	Career end date (nullable for current position)
ic	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