List Transactions

URL Expired

The URL for this request expired after 30 days.

Parameters

• issuerId: string, required

  • The identifier of the issuer whose transactions to retrieve.

• pageSize: int32

  • The maximum number of securities (with their transactions) to return. The service may return fewer than this value.
  • If unspecified, at most 50 securities will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

• pageToken: string

  • A page token received as nextPageToken in a previous response. Provide this to retrieve the subsequent page.

• type: string, enum, required

  • The security type to filter transactions by. Required.
  • Supported values:
    • option — option grant transactions (issuance, exercises, cancellation)
    • rsu — restricted stock unit award transactions (issuance, settlements, cancellation)
    • rsa — restricted stock award transactions (issuance, cancellation)
    • certificate — certificate transactions (issuance, cancellation)
    • warrant — warrant transactions (issuance, exercises, transfers, cancellation)
    • convertible — convertible note transactions (issuance, cancellation)
    • piu — profits interest unit transactions (issuance, cancellation)
    • sar — stock appreciation right transactions (issuance, exercises, cancellation)
    • phantom — phantom equity transactions (issuance, cancellation)

Response Codes

• 200: A successful response.
• 400: Returned if required fields are omitted or if provided fields fail validation.
• 401: Returned if a valid Authorization header has not been included with the request.
• 403: Returned when the user does not have permission to access the resource.
• 500: Returned if an unexpected internal server error is encountered.
• default: An unexpected error response.

Example Request

curl --request GET \
     --url 'https://mock-api.carta.com/v1alpha1/issuers/issuerId/transactions?type=option' \
     --header 'accept: application/json'

Transactions Response

{
  "optionTransactions": [
    {
      "securityId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "stakeholderId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "securityLabel": "ES-12",
      "issuance": {
        "issueDatetime": {
          "value": "2024-01-15T00:00:00Z"
        },
        "quantity": {
          "value": "10000"
        },
        "stockOptionType": "STOCK_OPTION_TYPE_ISO",
        "exercisePrice": {
          "currencyCode": {
            "value": "USD"
          },
          "amount": {
            "value": "1.50"
          }
        },
        "equityPlanId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "expirationDatetime": {
          "value": "2034-01-15T00:00:00Z"
        }
      },
      "exercises": [
        {
          "id": "23HcT4iVfrgYUaJF9txHTaH",
          "sharesAcquiredDatetime": {
            "value": "2025-01-15T00:00:00Z"
          },
          "quantity": {
            "value": "200"
          },
          "exerciseMethod": "OPTION_EXERCISE_METHOD_CASH",
          "recordType": "STOCK_OPTION_TYPE_ISO",
          "resultingSecurityId": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "resultingSecurityType": "certificate",
          "resultingSecurityLabel": "CS-42"
        }
      ]
    }
  ],
  "rsuTransactions": [],
  "rsaTransactions": [],
  "certificateTransactions": [],
  "warrantTransactions": [],
  "convertibleTransactions": [],
  "piuTransactions": [],
  "sarTransactions": [],
  "phantomTransactions": [],
  "nextPageToken": "NTA6NTA6YTFiMmMzZDQtZTVmNi00..."
}