Scope(s): read_issuer_securities OR readwrite_issuer_securities

Retrieve transaction history for securities belonging to an issuer, filtered by security type.

Use the type query parameter to specify the security type. Supported values: option (option grants), rsu (restricted stock unit awards), rsa (restricted stock awards), certificate (certificates), warrant (warrants), convertible (convertible notes), piu (profits interest units), sar (stock appreciation rights), phantom (phantom equity / cash bonus units).

For option grants, each item in the response represents a single grant with its full lifecycle: issuance, exercises, and cancellations (if applicable).

For RSU awards, each item represents a single award with its full lifecycle: issuance, settlements, and cancellations (if applicable).

For RSAs, each item represents a single award with its full lifecycle: issuance and cancellations (if applicable).

For certificates, each item represents a single certificate with its full lifecycle: issuance and cancellations (if applicable).

For warrants, each item represents a single warrant with its full lifecycle: issuance, exercises, transfers, and cancellations (if applicable).

For convertible notes, each item represents a single note with its full lifecycle: issuance and cancellations (if applicable). A conversion appears as a cancellation with reason=CONVERTIBLE_CANCELLATION_REASON_CONVERTED. A transferred note includes a precededBySecurityId on its issuance.

For PIUs (Profits Interest Units), each item represents a single PIU with its full lifecycle: issuance and cancellations (if applicable).

For Phantom equity (also known as CBU — Cash Bonus Unit), each item represents a single phantom with its full lifecycle: issuance and cancellations (if applicable). Phantom equity is cash-settled — settlements are represented as cancellations, not exercises.