name: fathom-hello-world description: 'Retrieve meeting transcripts and summaries from the Fathom API.
Use when fetching meeting data, testing API access,
or learning Fathom API response structure.
Trigger with phrases like "fathom hello world", "fathom first api call",
"get fathom transcript", "fathom meeting data".
' allowed-tools: Read, Write, Edit, Bash(curl:*) version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:
- saas
- meeting-intelligence
- ai-notes
- fathom compatibility: Designed for Claude Code
Fathom Hello World
Overview
First API calls against Fathom: list meetings, get a transcript, retrieve AI-generated summaries and action items.
Prerequisites
- Completed
fathom-install-authsetup - At least one recorded meeting in Fathom
Instructions
Step 1: List Meetings
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}" \
"https://api.fathom.ai/external/v1/meetings?limit=5" \
| jq '.meetings[] | {id, title, created_at, duration_seconds}'
Step 2: Get Meeting Transcript
RECORDING_ID="your-recording-id"
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}" \
"https://api.fathom.ai/external/v1/recordings/${RECORDING_ID}/transcript" \
| jq '.segments[] | {speaker, text, start_time}'
Step 3: Get AI Summary and Action Items
# Get meeting with summary included
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}" \
"https://api.fathom.ai/external/v1/meetings?include_summary=true&limit=1" \
| jq '.meetings[0] | {title, summary, action_items}'
Step 4: Filter Meetings by Date
# Meetings from the last 7 days
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}" \
"https://api.fathom.ai/external/v1/meetings?created_after=2026-03-15T00:00:00Z&limit=20" \
| jq '.meetings | length'
Output
- List of meetings with IDs and metadata
- Full transcript with speaker labels and timestamps
- AI-generated summary and action items
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Empty meetings array | No recordings in account | Record a meeting in Fathom |
404 on recording ID | Wrong ID or deleted | List meetings to get valid IDs |
| No summary available | Meeting still processing | Wait a few minutes after recording |
| Transcript empty | Recording too short | Minimum meeting length required |
Resources
Next Steps
Proceed to fathom-local-dev-loop for development workflow setup.