Announcements by Sector

Retrieve announcements filtered by company sector.

GET/3.0/announcements/sector

Description

This endpoint retrieves corporate announcements filtered by company sector. Useful for analyzing announcements and corporate activity across specific industry sectors.

Request

Authentication

Type: Bearer Token
Required: Yes

Parameters

Name	Type	Required	Description	Example
`sector_code`	string	Yes	Sector code filter	`BANK`

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 Sector (200)

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

Examples

Get All Banking Sector Announcements

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

Use Cases

Sector Analysis: Monitor announcements by industry sector
Comparative Analysis: Compare corporate activity across sectors
Sector Performance: Track sector-wide announcements and events
Industry Trends: Analyze announcement trends in specific sectors
Sector Screening: Find announcements across entire sector
Portfolio Monitoring: Monitor announcements for sector-based portfolio

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 Sector (200)​

Examples​

Get All Banking Sector Announcements​

Use Cases​