Announcements by Type

Retrieve announcements filtered by specific announcement type.

GET/3.0/announcements/type

Description

This endpoint retrieves corporate announcements filtered by type (e.g., financial results, board meetings, shareholder meetings, payouts). Useful for finding specific categories of announcements across all companies.

Request

Authentication

Type: Bearer Token
Required: Yes

Parameters

Name	Type	Required	Description	Example
`type`	string	Yes	Notice type filter	`U`

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 if applicable View
`payouts`	object	Payout details including dividends and corporate actions View

Meeting Object Fields

Field	Type	Description
`date`	string	Meeting date (YYYY-MM-DD)
`time`	string	Meeting time
`location`	string	Meeting location
`agenda`	string	Meeting agenda/title
`accounts_ended`	string	Accounts period ended/notes (if applicable)
`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 (EPS)
`eps_sply`	number	EPS for same period last year (SPLY)
`sales`	number	Sales / revenue
`pat`	number	Profit after tax (PAT)

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

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

Examples

Get All Financial Results Announcements

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

Use Cases

Type-Specific Monitoring: Monitor specific types of announcements
Financial Results Tracking: Get all financial results announcements
Meeting Schedule: Track all board and shareholder meetings
Payout Monitoring: Monitor all dividend and payout announcements
Market Analysis: Analyze specific announcement categories
Event Calendar: Build calendars of specific event types

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

Examples​

Get All Financial Results Announcements​

Use Cases​