Company Profile - Basic

Retrieve basic company profile information from the market data endpoint.

GET/3.0/company/profile/overview

Description

This endpoint returns basic company information including company name, sector, and fundamental details retrieved from market data. Provides a quick overview of company classification and market information.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol/ticker code for the company	UBL

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": {
        "symbol": "PSO",
        "description": "Pakistan State Oil Company Limited is a public company incorporated in Pakistan in 1976. The principal activities of the Company are procurement, storage and marketing of petroleum and related products. It also blends and markets various kinds of lubricating oils.",
        "auditor": "KPMG Taseer Hadi & Co. Chartered Accountants",
        "registrar": "CDC Share Registrar Services Limited, CDC House, 99 - B, Block 'B' , S.M.C.H.S., Main Shahra-e-Faisal, Karachi",
        "address": "Pakistan State Oil Company Limited, PSO House, Khayaban-e-Iqbal, Clifton,Karachi - 75600, Pakistan",
        "website": "www.psopk.com",
        "people": [
            {
                "name": "Syed Muhammad Taha",
                "position": "CEO"
            },
            {
                "name": "Asif Baigmohamed",
                "position": "Chairperson"
            },
            {
                "name": "Ambreen Ali",
                "position": "Company Secretary"
            }
        ],
        "details": null,
        "other": null
    }
}

Response Fields

Field	Type	Description
symbol	string	Company stock symbol/ticker code
description	string	Detailed company description and business overview
auditor	string	Name of the company's auditor
registrar	string	Share registrar information
address	string	Company's registered address
website	string	Company's official website URL
people	array	Array of company personnel View
details	array	Additional company details as a 2D array of strings (if available)
other	object	Other miscellaneous information as a string-to-string map (if available)

People Array Fields

Field	Type	Description
name	string	Full name of the person
position	string	Position or designation in the company

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

{
  "status": "error",
  "message": "no `symbol` provided"
}

Examples

Get Basic Company Profile

curl -X GET "https://csapis.com/3.0/company/profile/overview?symbol=UBL" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Company Overview: Get quick company identification and sector information
• Market Data: Retrieve company market metrics
• Symbol Lookup: Verify company symbol and name
• Sector Analysis: Identify company sector classification
• Listing Verification: Confirm company listing status