Fetch vesting schedule for a specific option grant. Use when asked about vesting details, cliff dates, vesting progress, or unvested shares for a particular grant.
Fetch the full vesting schedule for an option grant and present it with useful context, not just the raw table.
You need:
corporation_id — get from list_accounts if you don't have itgrant_id — identify via the grants list using the holder's name or grant numberfetch("cap_table:list:grants", {"corporation_id": corporation_id, "search": "<holder name>"})
Then:
fetch("cap_table:get:grant_vesting", {"corporation_id": corporation_id, "grant_id": grant_id})
Fields are returned in the formatted summary and vesting events table from the tool. Key context includes:
Call fetch("cap_table:list:grants", {"corporation_id": corporation_id, "search": "<holder name>"}). If multiple grants are returned, ask the user which one, or pick the most relevant based on context.
Call fetch("cap_table:get:grant_vesting", {"corporation_id": corporation_id, "grant_id": grant_id}).
Lead with a one-sentence plain-English summary before showing the table (see Presentation section).
Required inputs: corporation_id, grant_id.
If missing, call AskUserQuestion before proceeding (see carta-interaction-reference §4.1).
If grant_id is unknown, use Step 1 of the Workflow to search by holder name.
AI computation: No — this skill presents Carta data directly.
Format: Summary sentence + vesting events table
BLUF lead: Lead with a one-sentence plain-English summary of the vesting state before showing the table.
Sort order: By vesting date ascending (chronological).
Date format: MMM d, yyyy (e.g. "Jan 15, 2026").
Tailor the summary based on vesting state:
Format as the vesting events table returned by the tool, sorted by vesting date ascending (chronological).
Flag anything time-sensitive:
Then show the formatted table from the tool.
grant_id is required and must be resolved first — if the user provides a name, search grants to find the matching ID before fetching vesting data.