Granola API

https://docs.granola.ai/
Admin
Granola API provides programmatic access to meeting notes, transcripts, and AI summaries through a...
Tokens:139,759
Snippets:1,325
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### Folder Object Example

Source: https://docs.granola.ai/api-reference/get-note

Example of folder identification and hierarchy fields.

```yaml
id: fol_4y6LduVdwSKC27
name: Top secret recipes
parent_folder_id: fol_a74g2hvl98iUHG
```

--------------------------------

### User Object Example

Source: https://docs.granola.ai/api-reference/get-note

Example values for user name and email fields.

```yaml
name: Oat Benson
email: oat@granola.ai
```

--------------------------------

### Transcript Object Example

Source: https://docs.granola.ai/api-reference/get-note

Example of a transcript array showing speaker attribution, text content, and timestamps.

```yaml
- speaker:
    source: microphone
    attribution: me
  text: I'm done pretending. Greek is the only yoghurt that deserves us.
  start_time: '2026-01-27T15:30:00Z'
  end_time: '2026-01-27T16:30:00Z'
- speaker:
    source: speaker
    attribution: them
  text: Finally. Regular yoghurt is just milk that gave up halfway.
  start_time: '2026-01-27T15:30:00Z'
  end_time: '2026-01-27T16:30:00Z'
```

--------------------------------

### Download latest Granola installers via curl

Source: https://docs.granola.ai/help-center/getting-started/managed-installations

Use curl with the -L flag to follow redirects and download the latest installer for macOS or Windows.

```bash
# macOS
curl -L -o Granola.dmg https://api.granola.ai/v1/download-latest

# Windows
curl -L -o Granola.exe https://api.granola.ai/v1/download-latest-windows
```

--------------------------------

### Calendar Event Object Example

Source: https://docs.granola.ai/api-reference/get-note

Example of calendar event metadata including title, organizer, ID, and timing.

```yaml
event_title: Quarterly yoghurt budget review
organiser: oat@granola.ai
calendar_event_id: 2su99n6iiik37iiknmb5t4fkfh_20260127T153000Z
scheduled_start_time: '2026-01-27T15:30:00Z'
scheduled_end_time: '2026-01-27T16:30:00Z'
```

--------------------------------

### Private Notes Markdown Example

Source: https://docs.granola.ai/api-reference/get-note

Example of the private_notes_markdown field containing user-authored markdown content.

```yaml
- Push back on the dairy forecast
- Ask about the **almond milk** pivot
```

--------------------------------

### List and Retrieve Notes via cURL

Source: https://docs.granola.ai/introduction

Examples for listing notes created in the last week, handling pagination with cursors, and fetching specific note details with transcripts.

```bash
# List notes created this week
$ curl "https://public-api.granola.ai/v1/notes?created_after=$(date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
{
  "notes": [ ... ],
  "hasMore": true,
  "cursor": "eyJjcmVkZW50aWFsfQ=="
}

# Get the next page using the cursor
$ curl "https://public-api.granola.ai/v1/notes?created_after=$(date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)&cursor=eyJjcmVkZW50aWFsfQ==" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
{
  "notes": [
    { "id": "not_1d3tmYTlCICgjy", "title": "Quarterly yoghurt budget review", ... },
    ...
  ],
  "hasMore": false
}

# Get that note with its transcript
# (use the not_ ID from the list response, not a UUID)
$ curl "https://public-api.granola.ai/v1/notes/not_1d3tmYTlCICgjy?include=transcript" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
{
  "id": "not_1d3tmYTlCICgjy",
  "title": "Quarterly yoghurt budget review",
  "owner": { "name": "Oat Benson", "email": "oat@granola.ai" },
  "summary": "The quarterly yoghurt budget review was a success. ...",
  "transcript": [
    { "speaker": { "source": "microphone" }, "text": "I'm done pretending. Greek is the only yoghurt that deserves us." },
    { "speaker": { "source": "speaker" }, "text": "Finally. Regular yoghurt is just milk that gave up halfway." }
  ],
  ...
}
```
Tokens:
Raw