Carta API Schema Documentation
This directory contains documentation for the JSON schemas used in the Carta API. The documentation is auto-generated from the OpenAPI specification.
🎨 Interactive Schema Dependency Graph
Open Interactive Graph → - Explore the full schema dependency graph with: - 🔍 Search - Find any schema instantly - 🖱️ Drag & Drop - Reposition nodes - 🔎 Zoom & Pan - Navigate the graph - 📊 Live Stats - See reference counts - 💡 Hover Tooltips - View schema details - 🎯 Click to Navigate - Jump to documentation
The interactive graph uses a force-directed layout algorithm to automatically position schemas based on their relationships, making it easy to understand the API structure at a glance.
Schema Dependency Diagram
This diagram shows how API objects (blue rectangles) reference supporting types (purple rounded boxes):
graph TD
threshold_details("Threshold Details")
class threshold_details typeNode
click threshold_details "types/threshold_details/"
restricted_stock_award_vesting_event("Restricted Stock Award Vest...")
class restricted_stock_award_vesting_event typeNode
click restricted_stock_award_vesting_event "types/restricted_stock_award_vesting_event/"
draft_option_grant("Draft Option Grant")
class draft_option_grant typeNode
click draft_option_grant "types/draft_option_grant/"
note_block("Note Block")
class note_block typeNode
click note_block "types/note_block/"
iso8601_complete_calendar_date("Iso8601 Complete Calendar Date")
class iso8601_complete_calendar_date typeNode,highlyUsed
click iso8601_complete_calendar_date "types/iso8601_complete_calendar_date/"
point_of_contact["Point Of Contact"]
class point_of_contact objectNode
click point_of_contact "objects/point_of_contact/"
convertible_note["Convertible Note"]
class convertible_note objectNode
click convertible_note "objects/convertible_note/"
exercise_service_update_money_movement_body["Exercise Service Update Mon..."]
class exercise_service_update_money_movement_body objectNode
click exercise_service_update_money_movement_body "objects/exercise_service_update_money_movement_body/"
fair_market_value["Fair Market Value"]
class fair_market_value objectNode
click fair_market_value "objects/fair_market_value/"
money("Money")
class money typeNode,highlyUsed
click money "types/money/"
option_cancellation_transaction("Option Cancellation Transac...")
class option_cancellation_transaction typeNode
click option_cancellation_transaction "types/option_cancellation_transaction/"
share_class["Share Class"]
class share_class objectNode
click share_class "objects/share_class/"
securitiesoptionexercises_stock_option_type("Securitiesoptionexercises S...")
class securitiesoptionexercises_stock_option_type typeNode
click securitiesoptionexercises_stock_option_type "types/securitiesoptionexercises_stock_option_type/"
benchmarks["Benchmarks"]
class benchmarks objectNode
click benchmarks "objects/benchmarks/"
interest["Interest"]
class interest objectNode
click interest "objects/interest/"
restricted_stock_award["Restricted Stock Award"]
class restricted_stock_award objectNode
click restricted_stock_award "objects/restricted_stock_award/"
preferred_share_class_details("Preferred Share Class Details")
class preferred_share_class_details typeNode
click preferred_share_class_details "types/preferred_share_class_details/"
option_grant_vesting_event("Option Grant Vesting Event")
class option_grant_vesting_event typeNode
click option_grant_vesting_event "types/option_grant_vesting_event/"
point_of_contact_type("Point Of Contact Type")
class point_of_contact_type typeNode
click point_of_contact_type "types/point_of_contact_type/"
interest_compounding_period("Interest Compounding Period")
class interest_compounding_period typeNode
click interest_compounding_period "types/interest_compounding_period/"
option_grant["Option Grant"]
class option_grant objectNode
click option_grant "objects/option_grant/"
option_exercise_tax_withholding_line_item("Option Exercise Tax Withhol...")
class option_exercise_tax_withholding_line_item typeNode
click option_exercise_tax_withholding_line_item "types/option_exercise_tax_withholding_line_item/"
issuerssecurities_stock_option_type("Issuerssecurities Stock Opt...")
class issuerssecurities_stock_option_type typeNode
click issuerssecurities_stock_option_type "types/issuerssecurities_stock_option_type/"
benchmark_value("Benchmark Value")
class benchmark_value typeNode
click benchmark_value "types/benchmark_value/"
issuerssecurities_exercise_periods("Issuerssecurities Exercise ...")
class issuerssecurities_exercise_periods typeNode
click issuerssecurities_exercise_periods "types/issuerssecurities_exercise_periods/"
vesting_schedule_type("Vesting Schedule Type")
class vesting_schedule_type typeNode
click vesting_schedule_type "types/vesting_schedule_type/"
certificate["Certificate"]
class certificate objectNode
click certificate "objects/certificate/"
stakeholder_address("Stakeholder Address")
class stakeholder_address typeNode
click stakeholder_address "types/stakeholder_address/"
restricted_stock_unit_settlement("Restricted Stock Unit Settl...")
class restricted_stock_unit_settlement typeNode
click restricted_stock_unit_settlement "types/restricted_stock_unit_settlement/"
day_count_basis("Day Count Basis")
class day_count_basis typeNode
click day_count_basis "types/day_count_basis/"
decimal("Decimal")
class decimal typeNode,highlyUsed
click decimal "types/decimal/"
vesting_period("Vesting Period")
class vesting_period typeNode
click vesting_period "types/vesting_period/"
option_issuance_transaction("Option Issuance Transaction")
class option_issuance_transaction typeNode
click option_issuance_transaction "types/option_issuance_transaction/"
restricted_stock_unit_vesting_event("Restricted Stock Unit Vesti...")
class restricted_stock_unit_vesting_event typeNode
click restricted_stock_unit_vesting_event "types/restricted_stock_unit_vesting_event/"
option_exercise_transaction("Option Exercise Transaction")
class option_exercise_transaction typeNode
click option_exercise_transaction "types/option_exercise_transaction/"
option_exercise_state("Option Exercise State")
class option_exercise_state typeNode
click option_exercise_state "types/option_exercise_state/"
draft_securities_service_create_draft_option_grant_body["Draft Securities Service Cr..."]
class draft_securities_service_create_draft_option_grant_body objectNode
click draft_securities_service_create_draft_option_grant_body "objects/draft_securities_service_create_draft_option_grant_body/"
option_exercise["Option Exercise"]
class option_exercise objectNode
click option_exercise "objects/option_exercise/"
exercise_service_update_tax_withholding_body["Exercise Service Update Tax..."]
class exercise_service_update_tax_withholding_body objectNode
click exercise_service_update_tax_withholding_body "objects/exercise_service_update_tax_withholding_body/"
issuerssecurities_vesting_schedule("Issuerssecurities Vesting S...")
class issuerssecurities_vesting_schedule typeNode
click issuerssecurities_vesting_schedule "types/issuerssecurities_vesting_schedule/"
issuer["Issuer"]
class issuer objectNode
click issuer "objects/issuer/"
publicapiissuers_stakeholder_relationship("Publicapiissuers Stakeholde...")
class publicapiissuers_stakeholder_relationship typeNode
click publicapiissuers_stakeholder_relationship "types/publicapiissuers_stakeholder_relationship/"
option_exercise_money_movement("Option Exercise Money Movement")
class option_exercise_money_movement typeNode
click option_exercise_money_movement "types/option_exercise_money_movement/"
interest_accrual_period("Interest Accrual Period")
class interest_accrual_period typeNode
click interest_accrual_period "types/interest_accrual_period/"
share_class_type("Share Class Type")
class share_class_type typeNode
click share_class_type "types/share_class_type/"
share_class_valuation("Share Class Valuation")
class share_class_valuation typeNode
click share_class_valuation "types/share_class_valuation/"
option_transaction_item["Option Transaction Item"]
class option_transaction_item objectNode
click option_transaction_item "objects/option_transaction_item/"
vesting_schedule_template["Vesting Schedule Template"]
class vesting_schedule_template objectNode
click vesting_schedule_template "objects/vesting_schedule_template/"
benchmark_job["Benchmark Job"]
class benchmark_job objectNode
click benchmark_job "objects/benchmark_job/"
publicapiissuers_stakeholder["Publicapiissuers Stakeholder"]
class publicapiissuers_stakeholder objectNode
click publicapiissuers_stakeholder "objects/publicapiissuers_stakeholder/"
option_exercise_type("Option Exercise Type")
class option_exercise_type typeNode
click option_exercise_type "types/option_exercise_type/"
iso8601_complete_calendar_date_time("Iso8601 Complete Calendar D...")
class iso8601_complete_calendar_date_time typeNode,highlyUsed
click iso8601_complete_calendar_date_time "types/iso8601_complete_calendar_date_time/"
restricted_stock_unit["Restricted Stock Unit"]
class restricted_stock_unit objectNode
click restricted_stock_unit "objects/restricted_stock_unit/"
exercise("Exercise")
class exercise typeNode
click exercise "types/exercise/"
stakeholder_entity_type("Stakeholder Entity Type")
class stakeholder_entity_type typeNode
click stakeholder_entity_type "types/stakeholder_entity_type/"
corporation["Corporation"]
class corporation objectNode
click corporation "objects/corporation/"
issuersinterests_vesting_schedule("Issuersinterests Vesting Sc...")
class issuersinterests_vesting_schedule typeNode
click issuersinterests_vesting_schedule "types/issuersinterests_vesting_schedule/"
draft_securities_service_create_draft_option_grant_body --> draft_option_grant
exercise_service_update_money_movement_body --> option_exercise_money_movement
exercise_service_update_tax_withholding_body --> option_exercise_tax_withholding_line_item
publicapiissuers_stakeholder --> publicapiissuers_stakeholder_relationship
publicapiissuers_stakeholder --> stakeholder_entity_type
publicapiissuers_stakeholder --> stakeholder_address
benchmarks --> benchmark_value
certificate --> iso8601_complete_calendar_date
certificate --> decimal
certificate --> money
certificate --> iso8601_complete_calendar_date_time
convertible_note --> iso8601_complete_calendar_date_time
convertible_note --> money
convertible_note --> note_block
convertible_note --> interest_accrual_period
convertible_note --> decimal
convertible_note --> interest_compounding_period
convertible_note --> day_count_basis
fair_market_value --> iso8601_complete_calendar_date
fair_market_value --> share_class_valuation
interest --> iso8601_complete_calendar_date
interest --> iso8601_complete_calendar_date_time
interest --> threshold_details
interest --> money
interest --> decimal
interest --> issuersinterests_vesting_schedule
option_exercise --> decimal
option_exercise --> iso8601_complete_calendar_date_time
option_exercise --> option_exercise_state
option_exercise --> option_exercise_type
option_exercise --> securitiesoptionexercises_stock_option_type
option_exercise --> option_exercise_tax_withholding_line_item
option_exercise --> option_exercise_money_movement
option_grant --> iso8601_complete_calendar_date
option_grant --> issuerssecurities_stock_option_type
option_grant --> decimal
option_grant --> money
option_grant --> option_grant_vesting_event
option_grant --> exercise
option_grant --> issuerssecurities_vesting_schedule
option_grant --> iso8601_complete_calendar_date_time
option_grant --> issuerssecurities_exercise_periods
option_transaction_item --> option_issuance_transaction
option_transaction_item --> option_exercise_transaction
option_transaction_item --> option_cancellation_transaction
point_of_contact --> point_of_contact_type
restricted_stock_award --> iso8601_complete_calendar_date
restricted_stock_award --> decimal
restricted_stock_award --> money
restricted_stock_award --> restricted_stock_award_vesting_event
restricted_stock_award --> issuerssecurities_vesting_schedule
restricted_stock_award --> iso8601_complete_calendar_date_time
restricted_stock_unit --> iso8601_complete_calendar_date
restricted_stock_unit --> decimal
restricted_stock_unit --> money
restricted_stock_unit --> restricted_stock_unit_vesting_event
restricted_stock_unit --> restricted_stock_unit_settlement
restricted_stock_unit --> issuerssecurities_vesting_schedule
restricted_stock_unit --> iso8601_complete_calendar_date_time
share_class --> share_class_type
share_class --> decimal
share_class --> money
share_class --> preferred_share_class_details
vesting_schedule_template --> vesting_schedule_type
vesting_schedule_template --> vesting_period
classDef objectNode fill:#e1f5ff,stroke:#01579b,stroke-width:3px,font-size:16px,font-weight:bold
classDef typeNode fill:#f3e5f5,stroke:#4a148c,stroke-width:1px
classDef highlyUsed fill:#fff9c4,stroke:#f57f17,stroke-width:3px,stroke-dasharray:5 5
Legend: - 🔵 Blue rectangles (larger, bold) = Primary API objects (with endpoints) - 🟣 Purple rounded boxes = Supporting types - ⭐ Yellow highlighted with dashed border = Highly-used schemas (10+ references) - ➡️ Arrows = "uses" or "references" relationship
Most Referenced Schemas
These schemas are used by many other schemas:
- Decimal - referenced by 50 schemas
- Iso8601 Complete Calendar Date Time - referenced by 32 schemas
- Money - referenced by 29 schemas
- Iso8601 Complete Calendar Date - referenced by 17 schemas
- Issuerssecurities Vesting Schedule - referenced by 3 schemas
- Draft Option Grant - referenced by 3 schemas
- Option Exercise Money Movement - referenced by 3 schemas
- Option Exercise Tax Withholding Line Item - referenced by 3 schemas
- Issuerstransactions Stock Option Type - referenced by 2 schemas
- Publicapiissuers Stakeholder - referenced by 2 schemas
Most Complex Schemas
These schemas reference many other schemas:
- Draft Option Grant - references 13 other schemas
- Option Grant - references 9 other schemas
- List Transactions Response - references 8 other schemas
- Convertible Note - references 7 other schemas
- Option Exercise - references 7 other schemas
- Restricted Stock Unit - references 7 other schemas
- Capitalization Table - references 6 other schemas
- Convertible Issuance Transaction - references 6 other schemas
- Interest - references 6 other schemas
- Restricted Stock Award - references 6 other schemas
Schema Index
Objects
- Benchmark Job
- Benchmarks
- Certificate
- Convertible Note
- Corporation
- Draft Securities Service Create Draft Option Grant Body
- Exercise Service Update Money Movement Body
- Exercise Service Update Tax Withholding Body
- Fair Market Value
- Interest
- Issuer
- Option Exercise
- Option Grant
- Option Transaction Item
- Point Of Contact
- Publicapiissuers Stakeholder
- Restricted Stock Award
- Restricted Stock Unit
- Share Class
- Vesting Schedule Template
Types
- Acceleration
- Access
- Benchmark Value
- Benchmarks Metadata
- Board Approval
- Capitalization Table
- Capitalization Table Summary
- Certificate Cancellation Reason
- Certificate Cancellation Transaction
- Certificate Issuance Reason
- Certificate Issuance Transaction
- Certificate Transaction Item
- Compliance
- Convertible Cancellation Reason
- Convertible Cancellation Transaction
- Convertible Day Count Basis
- Convertible Interest Accrual Period
- Convertible Interest Compounding Period
- Convertible Issuance Transaction
- Convertible Transaction Item
- Create Draft Option Grant Response
- Date
- Day Count Basis
- Decimal
- Dividend Accrual Period
- Dividend Accrual Type
- Dividend Details
- Dividend Interest Type
- Dividend Type
- Document
- Draft Option Grant
- Draft Security State
- Exercise
- Exercise Status
- Exercise Type
- Federal Exemption
- Get Capitalization Table Response
- Get Certificate Response
- Get Compensation Benchmark Attributes Response
- Get Compensation Benchmarks Response
- Get Convertible Note Response
- Get Draft Option Grant Response
- Get Issuer Response
- Get Option Grant Response
- Get Restricted Stock Award Response
- Get Restricted Stock Unit Response
- Get Stakeholder Capitalization Table Response
- Get Stakeholder Response
- Grant Reason
- Interest Accrual Period
- Interest Compounding Period
- Iso3166 Set1 Alpha3 Code
- Iso3166 Set2 Code
- Iso4217 Currency Alpha Code
- Iso8601 Complete Calendar Date
- Iso8601 Complete Calendar Date Time
- Issuerscapitalization Stakeholder
- Issuersdraftsecurities Exercise Period
- Issuersdraftsecurities Exercise Periods
- Issuersdraftsecurities Stakeholder
- Issuersdraftsecurities Stakeholder Relationship
- Issuersdraftsecurities Stock Option Type
- Issuersinterests Vesting Schedule
- Issuerssecurities Exercise Period
- Issuerssecurities Exercise Periods
- Issuerssecurities Stock Option Type
- Issuerssecurities Vesting Schedule
- Issuerstransactions Stock Option Type
- Jurisdiction
- List Certificates Response
- List Convertible Notes Response
- List Corporations Response
- List Fair Market Values Response
- List Interests Response
- List Issuers Response
- List Option Exercises Response
- List Option Grants Response
- List Points Of Contact Response
- List Restricted Stock Awards Response
- List Restricted Stock Units Response
- List Share Classes Response
- List Stakeholders Response
- List Transactions Response
- List Vesting Schedule Templates Response
- Money
- Note Block
- Note Block Status
- Note Block Summary
- Note Type
- Option Cancellation Reason
- Option Cancellation Transaction
- Option Exercise Method
- Option Exercise Money Movement
- Option Exercise State
- Option Exercise Tax Withholding Line Item
- Option Exercise Transaction
- Option Exercise Type
- Option Grant Documents
- Option Grant Vesting Event
- Option Issuance Transaction
- Option Pool Summary
- Performance Condition
- Performance Condition Status
- Performance Condition Type
- Period Unit
- Piu Cancellation Reason
- Piu Cancellation Transaction
- Piu Issuance Reason
- Piu Issuance Transaction
- Piu Transaction Item
- Point Of Contact Type
- Preferred Share Class Details
- Protobuf Any
- Publicapiissuers Stakeholder Relationship
- Restricted Stock Award Vesting Event
- Restricted Stock Unit Settlement
- Restricted Stock Unit Vesting Event
- Rpc Status
- Rsa Cancellation Reason
- Rsa Cancellation Transaction
- Rsa Issuance Transaction
- Rsa Transaction Item
- Rsu Cancellation Reason
- Rsu Cancellation Transaction
- Rsu Issuance Transaction
- Rsu Settlement Transaction
- Rsu Transaction Item
- Sar Cancellation Reason
- Sar Cancellation Transaction
- Sar Exercise Transaction
- Sar Issuance Transaction
- Sar Transaction Item
- Securitiesoptionexercises Stock Option Type
- Share Class Dividend Details
- Share Class Rights And Preferences
- Share Class Summary
- Share Class Type
- Share Class Valuation
- Stakeholder Address
- Stakeholder Capitalization Table
- Stakeholder Capitalization Table Summary
- Stakeholder Entity Type
- Stakeholder Group
- Stakeholder Note Block Summary
- Stakeholder Option Pool Summary
- Stakeholder Share Class Summary
- Stakeholder Type
- Stakeholder Warrant Block Summary
- Threshold Details
- Threshold Details Threshold Type
- Update Money Movement Response
- Update Tax Withholding Response
- Vesting
- Vesting Method
- Vesting Occurs
- Vesting Period
- Vesting Schedule Type
- Warrant Block Summary
- Warrant Cancellation Reason
- Warrant Cancellation Transaction
- Warrant Exercise Transaction
- Warrant Issuance Transaction
- Warrant Transaction Item
- Warrant Transfer Transaction
This documentation is auto-generated.