Skip to main content

Announcements Board Meetings

Retrieve board meeting events scheduled across the market within a specified date range.

GET/3.0/announcement/bm

Description

This endpoint returns a calendar of board meetings scheduled by companies listed on PSX. Includes meeting details such as company symbol, period, agenda, meeting time, date, and location.

Request

Authentication

  • Type: Bearer Token
  • Required: Yes

Parameters

NameTypeRequiredDescriptionExample
fromstringYesStart date for calendar (YYYY-MM-DD format)2024-08-01
tostringYesEnd date for calendar (YYYY-MM-DD format)2024-08-30

Response

Success Response (200)

{
"status": "ok",
"message": "",
"data": [
{
"symbol": "UBL",
"period": "Q2 2024",
"agenda": "Review financial results and approve dividend distribution",
"date": "2024-08-15",
"time": "11:00 AM",
"place": "UBL Head Office, I.I. Chundrigar Road, Karachi"
},
{
"symbol": "MCB",
"period": "Q2 2024",
"agenda": "Quarterly financial review and business updates",
"date": "2024-08-18",
"time": "02:00 PM",
"place": "MCB Tower, M.A. Jinnah Road, Karachi"
},
{
"symbol": "GLANCE",
"period": "Q2 2024",
"agenda": "Review operational performance and strategic initiatives",
"date": "2024-08-22",
"time": "03:30 PM",
"place": "Glamour Heights, Karachi"
},
{
"symbol": "HUBCO",
"period": "Q2 2024",
"agenda": "Financial results and dividend announcement",
"date": "2024-08-25",
"time": "10:00 AM",
"place": "HUBCO Office, Lahore"
},
{
"symbol": "LUCK",
"period": "Q2 2024",
"agenda": "Review Q2 performance and approve interim dividend",
"date": "2024-08-28",
"time": "01:00 PM",
"place": "Lucky Center, Karachi"
}
]
}

Response Fields

FieldTypeDescription
symbolstringStock symbol
periodstringFinancial period or quarter
agendastringMeeting agenda and topics to be discussed
datestringMeeting date (YYYY-MM-DD)
timestringMeeting time
placestringPhysical meeting location

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Date Parameters (200)

{
"status": "error",
"message": "`from` and `to` parameters required"
}

Examples

Get Board Meetings Calendar

curl -X GET "https://csapis.com/3.0/announcement/bm?from=2024-08-01&to=2024-08-30" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

  • Event Calendar: Build corporate board meeting calendar
  • Event Tracking: Monitor upcoming board meetings
  • Dividend Announcements: Track meetings that may result in dividend announcements
  • Investment Planning: Plan trading around corporate events
  • News Monitoring: Track when important corporate decisions are made
  • Corporate Action Calendar: Maintain comprehensive corporate event calendar