Skip to main content

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.

FieldDescription
AnnouncementActionPUBLISH for a new announcement, REVOKE when a published announcement is withdrawn
AnnouncementTypeType code, see Announcement Types
AnnouncementIdUnique ID with a WAS- or FAS- prefix, e.g. WAS-285844
SymbolCodeTicker of the security, e.g. BOP. Exchange-wide notices use EXCHANGE and mutual fund notices use OPENFUND
AnnouncementTitleTitle as filed by the company
PostingDateDate posted, YYYY-MM-DD
PostingTimeTime posted, HH:MM:SS
ActionTimestampTime of the last action on the announcement, YYYY-MM-DD HH:MM:SS
EnclosureFile name of the main document filed by the company, e.g. 285844.pdf. - when there is none. The file itself is not delivered
AttachmentFile 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
RevisedY if this announcement revises an earlier one, otherwise N
OriginalAnnouncementIdID of the revoked announcement this one replaces. - when it is not a revision
companyNameFull company name. null for exchange and mutual fund notices
note

The pucars channel delivers the announcement JSON only. Attachment and enclosure files are not served through webhooks.

note

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.

TypeTitleType-specific fields
BMV1001Board MeetingHeld-Date, Held-Time, Held-Place, Period-Ended, ClosedForm, ClosedTo, Accounts-Ended
BMRV1001Board Meeting RescheduleHeld-Date, Held-Time, Held-Place, ClosedForm, ClosedTo, Meeting-Agenda, Revised-Held-Date, Revised-Held-Time
BMOTFRV1001Meeting Other than Financial ResultsHeld-Date, Held-Time, Held-Place, ClosedForm, ClosedTo, Meeting-Agenda
BMIPV1001Board Meeting In ProgressHeld-Date, Held-Time, Held-Place, Meeting-Agenda
BMPACV1001Meeting Other than Financial Results (Rescheduled)—
AGMV1002Approval of AGM Date and TimeHeld-Date, Held-Time, Held-Place, Period-Ended, Type-Of-Meeting
FRYEV1003Financial Report for the Year EndedHeld-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
NAGMV1004Notice for Annual General MeetingHeld-Date, Held-Time, Held-Place, Period-Ended, From, To, Business-Close
DARYEV1005Dispatch of Annual ReportPeriod-Ended
MAGMV1006Minutes of AGMHeld-Date, Held-Time, Held-Place
MAGMV10061Minutes of Extraordinary AGM—
FRV1007Financial Results for the Quarter EndedHeld-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
DQAV1008Dispatch of Quarterly AccountsPeriod-Ended
DIDWV1009Dispatch of Interim Dividend WarrantsPeriod-Ended, Dividend-Warrants, Dividend-Warrants-PCT, Post-Date
DFDWV1010Dispatch of Final Dividend WarrantsPeriod-Ended, Dividend-Warrants, Dividend-Warrants-PCT, Post-Date
DBSCV1011Dispatch of Bonus Shares CertificatePeriod-Ended, Announce-Date, Dispatch-Date, Percentage
CBSCV10111Credit of Bonus Shares CertificateAnnounce-Date, Credited-Date
ETAGMV1012Applied for Extension for Holding AGMPeriod-Ended, Up-To, Number-Of-Days
AETAGMV1012Approval of Extension in Time for AGMPeriod-Ended, Up-To, Number-Of-Days, Letter-No, Letter-Date
DICBOCV1013Declaration of Interim Cash Dividend / Bonus / OtherSubject, 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
DRSV1014Declaration of Right SharesHeld-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
DLRV1015Dispatch of Letters of RightsPeriod-Ended, Percentage, CDC-Date
SRIV1016Credit/Delivery of Shares - Right IssueAddress
NEGMV1017Notice of Extraordinary General MeetingHeld-Date
CCIV1018Change of Registered Office / Registrar / etc.Subject, Effective-Date, Address, Registrar, Telephone, Fax, Email, WebSite
NAPV1019Appointment of ManagementSubject, Effective-Date, Name, Designation, In-Place-Of
COPV1020Change of Management PositionSubject, Effective-Date, Name, Existing-Designation, Company-Designation, New-Name, New-Designation
COMV1021Change of Management (Board)Effective-Date, Resigned-Effective-Date, Outgoing, In-Coming, New-Board
MIV1025Material InformationMaterialInfo
SHOLDV001Buy-Back of SharesShareholders-As-On
FFSV001Free Float of Shares—
INTDISC001Interest Disclosure in SharesRECORDS, see Interest Disclosures
MISV001Miscellaneous InformationSubject, MiscellaneousInfo
CBSA327Notice 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
CBSA3271Presentation of CBS—
CBSA3272Video Recording of CBSHeld-Date, Post-ID, Post-Date, Video-Link
CAEA217Notice of Closure of Share Transfer Books—
CAEA218Notice for Final Book Closure for Merger—
SNAP_ONLYMutual fund announcementNone
PSX_NOTICENotice issued by the exchangeNone

Types marked — can carry type-specific fields that are not listed here yet. Treat any field you don't recognise as optional.

caution

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"
}
FieldDescription
RecordIDUnique ID of the transaction record
Person-NameName of the person who traded
Person-DescriptionRole, e.g. Director, Executive
UIN_IDUnique identification number of the person
Transaction-DateDate of the transaction, YYYY-MM-DD
Transaction-NatureNumeric code for the type of transaction, e.g. 110
No-Of-SharesNumber of shares in the transaction
RatePrice per share
Form-Of-SharesHow the shares are held, e.g. CDC
MarketMarket the trade took place in, e.g. Ready
Cummulative-PercentageCumulative holding percentage reported with the transaction
Cummulative-No-Of-ShareCumulative number of shares reported with the transaction