Announcements by Symbol

Retrieve all announcements for a specific company symbol.

GET/3.0/announcements/symbol

Description

This endpoint retrieves all corporate announcements and notices for a specific stock symbol. Useful for getting complete announcement history for a particular company.

Request

Authentication

Type: Bearer Token
Required: Yes

Parameters

Name	Type	Required	Description	Example
`symbol`	string	Yes	Stock symbol/ticker code	`UBL`

Response

Success Response (200)

{
  "status": "ok",
  "next": "NTA7NTA7OTczMw==",
  "offset": 0,
  "count": 50,
  "total": 9733,
  "data": [
      {
          "id": "256580",
          "status": 1,
          "category": "E",
          "type": "U",
          "sector_code": "",
          "form_type": "PSX_NOTICE",
          "symbol": "EXCHANGE",
          "title": "FOR ALL MARKET PARTICIPANTS - PRIMARY MARKET AUCTION OF GOP IJARAH SUKUK (GIS)",
          "quarter": "",
          "date": "2025-07-17T12:22:31Z",
          "last_action": "2025-07-17T12:22:54Z",
          "is_revised": false,
          "pdf": "",
          "docs": [
              "256580-1.pdf"
          ],
          "images": null,
          "period_ended": null,
          "meeting": null,
          "results": null,
          "payouts": {
              "book_closure_from": "",
              "book_closure_to": "",
              "entitlement_date": "",
              "ex_date": "",
              "dividend": 0,
              "bonus": 0,
              "right_price": 0,
              "right_issue": 0,
              "split_num": 0,
              "split_den": 0,
              "rsplit_num": 0,
              "rsplit_den": 0,
              "sdiv_num": 0,
              "sdiv_den": 0
          }
      }
  ]
}

Response Fields

Data Array Fields

Field	Type	Description
`id`	string	Unique notice identifier
`status`	integer	Notice status
`category`	string	Notice category. See Notice Categories for possible values.
`type`	string	Notice type code. See Notice Types for possible values.
`sector_code`	string	Company sector classification code
`form_type`	string	Form type
`symbol`	string	Stock symbol/ticker code
`title`	string	Notice title or announcement headline
`quarter`	string	Quarter designation if applicable
`date`	string	Notice publication date (ISO 8601 format)
`last_action`	string	Timestamp of last update/action (ISO 8601 format)
`is_revised`	boolean	Whether the notice has been revised
`pdf`	string	Primary PDF document filename
`docs`	array	Array of document filenames
`images`	array	Array of image filenames (if any)
`period_ended`	string	Period end date if applicable
`meeting`	object	Meeting details if applicable View
`results`	object	Financial results details if applicable View
`payouts`	object	Payout details including dividends and bonus View

Meeting Object Fields

Field	Type	Description
`date`	string	Meeting date (YYYY-MM-DD format)
`time`	string	Meeting time
`location`	string	Meeting location/venue
`agenda`	string	Meeting agenda details
`accounts_ended`	string	Accounts period end (Annual or Quarterly)
`revised_date`	string \| null	Revised meeting date (if any)
`revised_time`	string \| null	Revised meeting time (if any)

Results Object Fields

Field	Type	Description
`eps`	number	Earnings per share for the period
`eps_sply`	number	EPS for same period last year
`sales`	number	Sales/revenue amount
`pat`	number	Profit after tax amount

Payouts Object Fields

Field	Type	Description
`book_closure_from`	string	Book closure start date
`book_closure_to`	string	Book closure end date
`entitlement_date`	string	Entitlement date for dividend/bonus
`ex_date`	string	Ex-dividend/ex-bonus date
`dividend`	number	Dividend amount per share
`bonus`	number	Bonus ratio (bonus shares)
`right_price`	number	Rights issue price
`right_issue`	number	Rights issue ratio
`split_num`	number	Stock split numerator
`split_den`	number	Stock split denominator
`rsplit_num`	number	Reverse split numerator
`rsplit_den`	number	Reverse split denominator
`sdiv_num`	number	Specie dividend numerator
`sdiv_den`	number	Specie dividend denominator

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

{
  "status": "error",
  "message": "`symbol` parameter not provided"
}

Examples

Get All Announcements for UBL

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

Use Cases

Company History: Get complete announcement history for a stock
Corporate Action Tracking: Monitor all corporate actions for a company
Investment Research: Research company announcements for due diligence
Corporate Calendar: Build corporate action calendar for specific stock
Historical Analysis: Analyze company announcements over time
News Feed: Get all news and announcements for a stock

Description​

Request​

Authentication​

Parameters​

Response​

Success Response (200)​

Response Fields​

Data Array Fields​

Meeting Object Fields​

Results Object Fields​

Payouts Object Fields​

Error Responses​

Missing Symbol (200)​

Examples​

Get All Announcements for UBL​

Use Cases​