Skip to main content

Get Secondary Transaction

GET 
/v1alpha1/issuers/:issuerId/secondaryTransactions/:secondaryTransactionId

Scope(s): read_issuer_secondarytransactions OR readwrite_issuer_secondarytransactions

Retrieves a secondary transaction: its current state, and one entry per settled security carrying that security's settlement outcome and — for option grants, once the issuer has approved option cost — its tax reference.

This is the only route by which the tax withholding figures reach you, and you cannot compute what to move without them. 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.

An ISO line returns a taxReference whose taxLineItems array is empty, not a line item with a zero amount: an ISO exercise carries no ordinary-income withholding, only AMT, which this integration does not compute. Handle the empty array rather than assuming at least one line item is present.

Request​

Responses​

A successful response.