PUCARS Announcements
The pucars channel delivers every corporate announcement filed on the Pakistan Stock Exchange through PUCARS (Pakistan Unified Corporate Action Reporting System) as soon as it is published or revoked.
The payload is the PUCARS announcement exactly as the exchange sends it. Field names keep their original spelling and casing.
Example
A board meeting announcement:
{
"AnnouncementAction": "PUBLISH",
"AnnouncementType": "BMV1001",
"AnnouncementId": "WAS-285844",
"SymbolCode": "SLCL",
"AnnouncementTitle": "Board Meeting",
"PostingDate": "2026-10-16",
"PostingTime": "12:30:35",
"ActionTimestamp": "2026-10-16 12:30:35",
"Enclosure": "285844.pdf",
"Revised": "N",
"OriginalAnnouncementId": "-",
"Held-Date": "2026-10-26",
"Held-Time": "11:30",
"Held-Place": "Karachi",
"Period-Ended": "2026-09-30",
"ClosedForm": "2026-10-19",
"ClosedTo": "2026-10-26",
"Accounts-Ended": "Quarterly",
"Attachment": "285844-1.gif|285844.pdf",
"companyName": "Security Leasing Corporation Limited"
}
Common Fields
Every announcement carries these fields. All values are strings unless noted.
| Field | Description |
|---|---|
AnnouncementAction | PUBLISH for a new announcement, REVOKE when a published announcement is withdrawn |
AnnouncementType | Type code, see Announcement Types |
AnnouncementId | Unique ID with a WAS- or FAS- prefix, e.g. WAS-285844 |
SymbolCode | Ticker of the security, e.g. BOP. Exchange-wide notices use EXCHANGE and mutual fund notices use OPENFUND |
AnnouncementTitle | Title as filed by the company |
PostingDate | Date posted, YYYY-MM-DD |
PostingTime | Time posted, HH:MM:SS |
ActionTimestamp | Time of the last action on the announcement, YYYY-MM-DD HH:MM:SS |
Enclosure | File name of the main document filed by the company, e.g. 285844.pdf. - when there is none. The file itself is not delivered |
Attachment | File names of all files attached to the announcement (PDF, GIF or ZIP), separated by |, e.g. 285844-1.gif|285844.pdf. The files themselves are not delivered |
Revised | Y if this announcement revises an earlier one, otherwise N |
OriginalAnnouncementId | ID of the revoked announcement this one replaces. - when it is not a revision |
companyName | Full company name. null for exchange and mutual fund notices |
The pucars channel delivers the announcement JSON only. Attachment and enclosure files are not served through webhooks.
All dates and times are in Pakistan Standard Time (PKT, UTC+5). Numbers inside the payload are sent as strings, e.g. "Rate": "449.50".
Announcement Types
Each type adds its own fields on top of the common fields. A field is only sent when it applies; missing fields are left out, not sent empty.
| Type | Title | Type-specific fields |
|---|---|---|
BMV1001 | Board Meeting | Held-Date, Held-Time, Held-Place, Period-Ended, ClosedForm, ClosedTo, Accounts-Ended |
BMRV1001 | Board Meeting Reschedule | Held-Date, Held-Time, Held-Place, ClosedForm, ClosedTo, Meeting-Agenda, Revised-Held-Date, Revised-Held-Time |
BMOTFRV1001 | Meeting Other than Financial Results | Held-Date, Held-Time, Held-Place, ClosedForm, ClosedTo, Meeting-Agenda |
BMIPV1001 | Board Meeting In Progress | Held-Date, Held-Time, Held-Place, Meeting-Agenda |
BMPACV1001 | Meeting Other than Financial Results (Rescheduled) | — |
AGMV1002 | Approval of AGM Date and Time | Held-Date, Held-Time, Held-Place, Period-Ended, Type-Of-Meeting |
FRYEV1003 | Financial Report for the Year Ended | Held-Date, Held-Time, Held-Place, Period-Ended, Address, Dividend, Dividend-Percent, Bonus-Proportion, Bonus-Held-Shares, Bonus-Percent, Interim-Dividend, Interim-Dividend-Percent, Interim-Bonus-Shares-PCT, Right-Shares-Percent, Right-Discount-Per-Share, Right-Proportion-Shares-N, Right-Proportion-Shares-D, Entitlement-Paid-Date, Closed-From, Closed-To, Transfer-Received-Date, OtherEntitlementOrCorporateAction, Other-Price-Information, AGM-Held-Date, AGM-Held-Time, AGM-Held-Place |
NAGMV1004 | Notice for Annual General Meeting | Held-Date, Held-Time, Held-Place, Period-Ended, From, To, Business-Close |
DARYEV1005 | Dispatch of Annual Report | Period-Ended |
MAGMV1006 | Minutes of AGM | Held-Date, Held-Time, Held-Place |
MAGMV10061 | Minutes of Extraordinary AGM | — |
FRV1007 | Financial Results for the Quarter Ended | Held-Date, Held-Time, Held-Place, Period-Ended, Address, Interim-Dividend, Interim-Dividend-Percent, Interim-Dividend-Already, Interim-Dividend-Percent-Already, Interim-Bonus-Proportion, Interim-Bonus-Held-Shares, Interim-Bonus-Percent, Interim-Bonus-Issued-Already-PCT, Right-Shares-Percent, Right-Discount-Per-Share, Proportion-Shares-N, Proportion-Shares-D, Entitlement-Paid-Date, Closed-From, Closed-To, Transfer-Received-Date, OtherEntitlementOrCorporateAction, Other-Price-Information |
DQAV1008 | Dispatch of Quarterly Accounts | Period-Ended |
DIDWV1009 | Dispatch of Interim Dividend Warrants | Period-Ended, Dividend-Warrants, Dividend-Warrants-PCT, Post-Date |
DFDWV1010 | Dispatch of Final Dividend Warrants | Period-Ended, Dividend-Warrants, Dividend-Warrants-PCT, Post-Date |
DBSCV1011 | Dispatch of Bonus Shares Certificate | Period-Ended, Announce-Date, Dispatch-Date, Percentage |
CBSCV10111 | Credit of Bonus Shares Certificate | Announce-Date, Credited-Date |
ETAGMV1012 | Applied for Extension for Holding AGM | Period-Ended, Up-To, Number-Of-Days |
AETAGMV1012 | Approval of Extension in Time for AGM | Period-Ended, Up-To, Number-Of-Days, Letter-No, Letter-Date |
DICBOCV1013 | Declaration of Interim Cash Dividend / Bonus / Other | Subject, Held-Date, Held-Time, Held-Place, Period-Ended, Address, Interim-Dividend, Interim-Dividend-Percent, Interim-Dividend-Already, Interim-Dividend-Percent-Already, Interim-Bonus-Proportion, Interim-Bonus-Held-Shares, Interim-Bonus-Percent, Interim-Bonus-Issued-Already-PCT, Entitlement-Paid-Date, Closed-From, Closed-To, Transfer-Received-Date, OtherEntitlementOrCorporateAction, Other-Price-Information |
DRSV1014 | Declaration of Right Shares | Held-Date, Held-Time, Held-Place, Right-Shares-Percent, Right-Discount-Per-Share, Proportion-Shares-N, Proportion-Shares-D, Closed-From, Closed-To, Receiving-Address, Last-Receiving-Date |
DLRV1015 | Dispatch of Letters of Rights | Period-Ended, Percentage, CDC-Date |
SRIV1016 | Credit/Delivery of Shares - Right Issue | Address |
NEGMV1017 | Notice of Extraordinary General Meeting | Held-Date |
CCIV1018 | Change of Registered Office / Registrar / etc. | Subject, Effective-Date, Address, Registrar, Telephone, Fax, Email, WebSite |
NAPV1019 | Appointment of Management | Subject, Effective-Date, Name, Designation, In-Place-Of |
COPV1020 | Change of Management Position | Subject, Effective-Date, Name, Existing-Designation, Company-Designation, New-Name, New-Designation |
COMV1021 | Change of Management (Board) | Effective-Date, Resigned-Effective-Date, Outgoing, In-Coming, New-Board |
MIV1025 | Material Information | MaterialInfo |
SHOLDV001 | Buy-Back of Shares | Shareholders-As-On |
FFSV001 | Free Float of Shares | — |
INTDISC001 | Interest Disclosure in Shares | RECORDS, see Interest Disclosures |
MISV001 | Miscellaneous Information | Subject, MiscellaneousInfo |
CBSA327 | Notice of Corporate Briefing Session (CBS) | Held-Date, Held-Time, Place, Year-Ended-Date, Quarter-Year, Annual-Interim, Online-Connectivity-Link, Details-for-participation, Weblink-Email, Feedback-Medium, Contact-Person1, PhoneNo1, EmailAddress1, Contact-Person2, PhoneNo2, EmailAddress2, Hyperlink-CBS-Notice, Hyperlink-CBS-Presentation |
CBSA3271 | Presentation of CBS | — |
CBSA3272 | Video Recording of CBS | Held-Date, Post-ID, Post-Date, Video-Link |
CAEA217 | Notice of Closure of Share Transfer Books | — |
CAEA218 | Notice for Final Book Closure for Merger | — |
SNAP_ONLY | Mutual fund announcement | None |
PSX_NOTICE | Notice issued by the exchange | None |
Types marked — can carry type-specific fields that are not listed here yet. Treat any field you don't recognise as optional.
ClosedForm is spelled this way in the PUCARS feed (it means "closed from"). Use the field name exactly as shown.
Interest Disclosures
INTDISC001 announcements report share transactions by directors, executives and substantial shareholders. Instead of type-specific fields at the top level, they carry a RECORDS array with one object per transaction:
{
"AnnouncementAction": "PUBLISH",
"AnnouncementType": "INTDISC001",
"AnnouncementId": "WAS-285884",
"SymbolCode": "SHFA",
"AnnouncementTitle": "Disclosure of Interest by a Director CEO, or Executive of a listed company and their Spouses and the Substantial Shareholders u/c 5.6.1.(d) of PSX Regulations",
"PostingDate": "2026-10-16",
"PostingTime": "15:26:14",
"ActionTimestamp": "2026-10-16 15:26:14",
"Enclosure": "285884.pdf",
"Revised": "N",
"OriginalAnnouncementId": "-",
"RECORDS": [
{
"RecordID": "31572",
"Person-Name": "Jane Doe",
"Person-Description": "Executive",
"UIN_ID": "28706",
"Transaction-Date": "2026-10-12",
"Transaction-Nature": "110",
"No-Of-Shares": "2200",
"Rate": "449.50",
"Form-Of-Shares": "CDC",
"Market": "Ready",
"Cummulative-Percentage": "0.56",
"Cummulative-No-Of-Share": "352186"
}
],
"Attachment": "285884-1.gif|285884.pdf",
"companyName": "Shifa International Hospitals Limited"
}
| Field | Description |
|---|---|
RecordID | Unique ID of the transaction record |
Person-Name | Name of the person who traded |
Person-Description | Role, e.g. Director, Executive |
UIN_ID | Unique identification number of the person |
Transaction-Date | Date of the transaction, YYYY-MM-DD |
Transaction-Nature | Numeric code for the type of transaction, e.g. 110 |
No-Of-Shares | Number of shares in the transaction |
Rate | Price per share |
Form-Of-Shares | How the shares are held, e.g. CDC |
Market | Market the trade took place in, e.g. Ready |
Cummulative-Percentage | Cumulative holding percentage reported with the transaction |
Cummulative-No-Of-Share | Cumulative number of shares reported with the transaction |