Get Secondary Transaction
GET/v1alpha1/issuers/:issuerId/secondaryTransactions/:secondaryTransactionId
Scope(s): read_issuer_secondarytransactions OR readwrite_issuer_secondarytransactions
Retrieves the full secondary transaction, nested under secondaryTransaction in the response: its current state, and one entry per security carrying that security's settlement outcome and — for option grants, once the issuer has approved option cost — its tax reference.
Option grants carry no taxReference until the issuer approves option cost, because Carta's estimate can still change in review; see taxReference for the states in which it appears. Once present, it is the final withholding the issuer approved, which Carta settles with.
Read the issuer-approved tax withholding figures here before moving money. Finalize Secondary Transaction also returns them, but by then the money has already moved. Each tax line carries a withholdingAmount and an exerciseCost; aggregate the lines yourself, as there is no summary block. Net proceeds to the seller are the sale amount less the exercise cost and withholding, aggregated across securities.
These figures are informational reference only. Carta moves no money — you use them to calculate the net proceeds owed to the seller and to determine your withholding obligations before releasing payment.
A line on which no jurisdiction withholds returns a taxReference whose taxLineItems array is empty, not a line item with a zero amount. That is common for an ISO line, but not universal: a jurisdiction that withholds on an ISO exercise (e.g. Pennsylvania) returns line items for it. Handle the empty array rather than assuming at least one line item is present.
Request
Responses
- 200
- 400
- 401
- 403
- 500
- default
The full secondary transaction, nested under secondaryTransaction. The example is after the issuer approved option cost: each option grant carries its taxReference, and the ISO line, on which no jurisdiction withholds, carries an empty taxLineItems array.
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.