Skip to main content

Research Organizations

Retrieve the list of research organizations and brokers that publish research reports.

GET/3.0/research/organizations

Description​

This endpoint returns the distinct set of research organizations (brokers/firms) that have published research reports. Use the returned id as the client_id filter on the research report endpoints.

Request​

Authentication​

  • Type: Bearer Token
  • Required: Yes

Parameters​

This endpoint does not accept any parameters.

Response​

Success Response (200)​

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": 18,
      "name": "BMA Capital"
    },
    {
      "id": 148,
      "name": "JS Global Capital"
    }
  ]
}

Response Fields​

FieldTypeDescription
idintegerOrganization/Client unique ID (use as client_id on research report endpoints)
namestringOrganization/Client name

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

Get All Research Organizations​

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

Use Cases​

  • Provider Discovery: Discover which research organizations are available
  • Report Filtering: Obtain the client_id used to filter reports by organization
  • Provider Comparison: Build lists to compare research across organizations
  • Research Curation: Present organizations for selection in UI applications