Skip to main content

Research Report Categories

Retrieve research report categories and classifications.

GET/3.0/research/reports/categories

Description​

This endpoint returns a list of research report categories used for organizing and classifying research reports. Categories help organize reports by type, sector, or other classifications.

Request​

Authentication​

  • Type: Bearer Token
  • Required: Yes

Parameters​

This endpoint does not accept any query parameters.

Response​

Success Response (200)​

{
    "status": "ok",
    "message": "",
    "data": [
        {
            "id": "68d3314db34e1089abe20f6a",
            "name": "Strategy Reports",
            "crt": "2025-09-23T23:46:21.278Z"
        },
        {
            "id": "68d33155b34e1089abe20f6b",
            "name": "Company Reports",
            "crt": "2025-09-23T23:46:29.089Z"
        }
    ]
}

Response Fields​

FieldTypeDescription
idstringCategory unique ID
namestringCategory name/title
crtstring (ISO 8601)Category creation timestamp

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

Get All Research Categories​

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

Use Cases​

  • Category Browse: Discover available research categories
  • Report Filtering: Filter reports by category
  • Research Organization: Understand research classification scheme
  • Category Statistics: Get count of reports in each category
  • Custom Filtering: Build custom research filters based on categories