List Transactions
GET/v1alpha1/issuers/:issuerId/transactions
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.
Request
Responses
- 200
- 400
- 401
- 403
- 500
- default
A successful response.
Returned if required fields are omitted or if provided fields fail validation.
Returned if a valid Authorization header has not been included with the request.
Returned when the user does not have permission to access the resource.
Returned if an unexpected internal server error is encountered.
An unexpected error response.