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
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
from | string | Yes | Start date for calendar (YYYY-MM-DD format) | 2024-08-01 |
to | string | Yes | End 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
| Field | Type | Description |
|---|---|---|
symbol | string | Stock symbol |
period | string | Financial period or quarter |
agenda | string | Meeting agenda and topics to be discussed |
date | string | Meeting date (YYYY-MM-DD) |
time | string | Meeting time |
place | string | Physical 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