Granola API

https://docs.granola.ai/help-center/getting-started/setting-up-granola-for-the-first-time
Admin
Granola API is a RESTful API that provides programmatic access to meeting notes and workspace data,...
Tokens:1,210
Snippets:6
Trust Score:10
Update:6 months ago
Show doc for...
Tokens:
Raw
### Get Note by ID

Source: https://docs.granola.ai

Retrieves a specific meeting note by its ID, with an option to include its transcript.

```APIDOC
## GET /v1/notes/{note_id}

### Description
Retrieves a specific meeting note by its ID. You can optionally include the transcript in the response.

### Method
GET

### Endpoint
/v1/notes/{note_id}

### Path Parameters
- **note_id** (string) - Required - The unique identifier of the note (e.g., `not_1d3tmYTlCICgjy`).

### Query Parameters
- **include** (string) - Optional - Specifies additional data to include. Use `transcript` to get the note's transcript.

### Request Example
```bash
curl "https://public-api.granola.ai/v1/notes/not_1d3tmYTlCICgjy?include=transcript" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier of the note.
- **title** (string) - The title of the note.
- **owner** (object) - Information about the note owner.
- **summary** (string) - A summary of the note.
- **transcript** (array) - An array of transcript objects, if requested.

#### Response Example
```json
{
  "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." }
  ],
  ...
}
```
```

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

### Retrieve Meeting Notes and Transcripts via REST API

Source: https://docs.granola.ai

Demonstrates how to list meeting notes using pagination and retrieve specific note details including transcripts. These requests require an Authorization header with a valid Bearer token.

```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"

# 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"

# Get a specific note with its transcript
curl "https://public-api.granola.ai/v1/notes/not_1d3tmYTlCICgjy?include=transcript" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
```

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

### List Notes

Source: https://docs.granola.ai

Lists all accessible meeting notes. Supports filtering by creation date and pagination using a cursor.

```APIDOC
## GET /v1/notes

### Description
Lists all accessible meeting notes with pagination. Filter by date, fetch notes from shared workspace folders.

### Method
GET

### Endpoint
/v1/notes

### Query Parameters
- **created_after** (string) - Optional - Filter notes created after this date (ISO 8601 format).
- **cursor** (string) - Optional - Cursor for fetching the next page of results.

### Request Example
```bash
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"
```

### Response
#### Success Response (200)
- **notes** (array) - An array of note objects.
- **hasMore** (boolean) - Indicates if there are more results.
- **cursor** (string) - Cursor for the next page of results.

#### Response Example
```json
{
  "notes": [ ... ],
  "hasMore": true,
  "cursor": "eyJjcmVkZW50aWFsfQ=="
}
```
```
Tokens:
Raw