Carta Fa464 V1Alpha1 API

openapi: 3.2.0
info:
  title: Carta Fa464 V1Alpha1 API
  version: '2026-10-07'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-07: 10 operation(s) read from 24 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Carta Fa464 has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 10
    pages-with-code: 0
    pages-read: 24
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-07'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-files-upload-file
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-get-issuer
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-firms
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-funds
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-issuers
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-user-get-current-user
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-interests
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-partners
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-warrants
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-get-stakeholder
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-certificates
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-stakeholders
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-transactions
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-investments
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-share-classes
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-certificates
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-initiate-settlement
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-cash-balances
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-option-exercises
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-corporations-list-corporations
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-draft-issuers-get-draft-issuer
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-points-of-contact
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-partner-contacts
  - https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-fair-market-values
security:
- bearer: []
tags:
- name: V1Alpha1
paths:
  /v1alpha1/files{upload}:
    post:
      operationId: post_v1alpha1_files_upload
      tags:
      - V1Alpha1
      summary: Synchronously upload a generic file as a binary payload
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-files-upload-file
      parameters:
      - name: upload
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1Alpha1FilesUploadRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1Alpha1FilesUploadResponse'
      x-evidence:
        kind: documentation
  /v1alpha1/investors/firms:
    get:
      operationId: get_v1alpha1_investors_firms
      tags:
      - V1Alpha1
      summary: Retrieves investment firms
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-firms
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1alpha1/investors/firms/{firmid}/funds/{fundid}/investments/{investmentid}/{investmentidid}:
    get:
      operationId: get_v1alpha1_investors_firms_firmid_funds_fundid_investments_investmentid_invest
      tags:
      - V1Alpha1
      summary: Retrieve certificates issued by an investment company to a fund within a firm
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-certificates
      parameters:
      - name: firmid
        in: path
        required: true
        schema:
          type: string
      - name: fundid
        in: path
        required: true
        schema:
          type: string
      - name: investmentid
        in: path
        required: true
        schema:
          type: string
      - name: investmentidid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1Alpha1InvestorsFirmsFirmidFundsFundidInvestmentsInvestm'
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at investmentIdId
  /v1alpha1/investors/firms/{firmid}/funds/{fundid}/{fundidid}:
    get:
      operationId: get_v1alpha1_investors_firms_firmid_funds_fundid_fundidid
      tags:
      - V1Alpha1
      summary: Retrieve a list of cash balances for a given firm and fund
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-cash-balances
      parameters:
      - name: firmid
        in: path
        required: true
        schema:
          type: string
      - name: fundid
        in: path
        required: true
        schema:
          type: string
      - name: fundidid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at fundIdId
  /v1alpha1/investors/firms/{firmid}/{firmidid}:
    get:
      operationId: get_v1alpha1_investors_firms_firmid_firmidid
      tags:
      - V1Alpha1
      summary: Retrieves the investment funds of a given investment firm
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-investors-list-funds
      parameters:
      - name: firmid
        in: path
        required: true
        schema:
          type: string
      - name: firmidid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 3 example path(s) differing only at firmIdId
  /v1alpha1/issuers/{issuerid}/secondaryTransactions:
    post:
      operationId: post_v1alpha1_issuers_issuerid_secondaryTransactions
      tags:
      - V1Alpha1
      summary: Creates a secondary transaction, soft-locks each security being settled, and…
      description: 'The soft lock stops a holder placing a cash exercise against the same vested options inside Carta while your settlement is in flight. Carta takes it itself; there is no lock call for you to make and no lock resource on this API. It is released automatically when the transaction reaches a terminal state. The transfer versus repurchase distinction is carried by rightOfFirstRefusalOutcome rather than by separate endpoints: EXERCISED_BY_COMPANY drives the repurchase path, and the other two drive the transfer path. buyerInformation is required on the transfer path and unused for a repurchase, where the issuer is the counterparty. Branch on transactionState in the response, not on the status code.'
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-initiate-settlement
      parameters:
      - name: issuerid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1alpha1/issuers/{issuerid}/stakeholders/{id}:
    get:
      operationId: get_v1alpha1_issuers_issuerid_stakeholders_id
      tags:
      - V1Alpha1
      summary: Retrieve a stakeholder
      description: A stakeholder is a person or entity that has been issued a security by an issuer and is, therefore, on the issuer's capitalization table.
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-get-stakeholder
      parameters:
      - name: issuerid
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1alpha1/issuers/{issuerid}/{issueridid}:
    get:
      operationId: get_v1alpha1_issuers_issuerid_issueridid
      tags:
      - V1Alpha1
      summary: Retrieve certificates
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-issuers-list-certificates
      parameters:
      - name: issuerid
        in: path
        required: true
        schema:
          type: string
      - name: issueridid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 8 example path(s) differing only at issuerIdId
  /v1alpha1/{v1alpha1id}:
    get:
      operationId: get_v1alpha1_v1alpha1id
      tags:
      - V1Alpha1
      summary: Retrieve the list of corporations that a user can access Carta
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-corporations-list-corporations
      parameters:
      - name: v1alpha1id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 3 example path(s) differing only at v1alpha1Id
  /v1alpha1/{v1alpha1id}/{id}:
    get:
      operationId: get_v1alpha1_v1alpha1id_id
      tags:
      - V1Alpha1
      summary: Retrieve a draft version of an issuer
      x-source: https://docs.carta.com/api-platform/reference/v-1-alpha-1-draft-issuers-get-draft-issuer
      parameters:
      - name: v1alpha1id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at v1alpha1Id
components:
  schemas:
    PostV1Alpha1FilesUploadRequest:
      type: object
      properties:
        binary:
          type: string
          description: Binary payload of the file.
      required:
      - binary
    GetV1Alpha1InvestorsFirmsFirmidFundsFundidInvestmentsInvestm:
      type: object
      properties:
        '200':
          type: string
          description: A successful response.
        '400':
          type: string
          description: Returned if required fields are omitted or if provided fields fail validation.
        '401':
          type: string
          description: Returned if a valid Authorization header has not been included with the request.
        '403':
          type: string
          description: Returned when the user does not have permission to access the resource.
        '500':
          type: string
          description: Returned if an unexpected internal server error is encountered.
        default:
          type: string
          description: An unexpected error response.
    PostV1Alpha1FilesUploadResponse:
      type: object
      properties:
        '200':
          type: string
          description: A successful response.
        '400':
          type: string
          description: Returned if required fields are omitted or if provided fields fail validation.
        '401':
          type: string
          description: Returned if a valid Authorization header has not been included with the request.
        '403':
          type: string
          description: Returned when the user does not have permission to access the resource.
        '500':
          type: string
          description: Returned if an unexpected internal server error is encountered.
        default:
          type: string
          description: An unexpected error response.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer