curl --request GET \
--url https://api.caret.so/v1/notes/note_123456789 \
--header 'Authorization: Bearer <your_api_key>'
{
"note": {
"id": "note_123456789",
"title": "Weekly Team Sync",
"kind": "online",
"status": "completed",
"createdAt": "2024-01-28T10:00:00Z",
"updatedAt": "2024-01-28T11:30:00Z",
"visibility": "workspace",
"tags": [
{
"id": "fld_123",
"name": "Sales",
"color": "#4A90E2"
}
],
"participants": [],
"totalDurationSec": 3600,
"userWrittenNote": "",
"enhancedNote": "Meeting summary content...",
"summary": "Meeting summary content...",
"transcripts": [
{
"speaker": "John Doe",
"text": "Let's start with the weekly update.",
"startTimestamp": "00:00:05",
"endTimestamp": "00:00:12"
}
],
"calendarEvent": null,
"inputLanguage": "en",
"translationLanguage": null,
"meetingApp": null
}
}
{
"error": {
"code": "not_found",
"message": "Note not found"
}
}
Notes
Get Note
Get detailed information about a specific note
GET
/
v1
/
notes
/
{id}
curl --request GET \
--url https://api.caret.so/v1/notes/note_123456789 \
--header 'Authorization: Bearer <your_api_key>'
{
"note": {
"id": "note_123456789",
"title": "Weekly Team Sync",
"kind": "online",
"status": "completed",
"createdAt": "2024-01-28T10:00:00Z",
"updatedAt": "2024-01-28T11:30:00Z",
"visibility": "workspace",
"tags": [
{
"id": "fld_123",
"name": "Sales",
"color": "#4A90E2"
}
],
"participants": [],
"totalDurationSec": 3600,
"userWrittenNote": "",
"enhancedNote": "Meeting summary content...",
"summary": "Meeting summary content...",
"transcripts": [
{
"speaker": "John Doe",
"text": "Let's start with the weekly update.",
"startTimestamp": "00:00:05",
"endTimestamp": "00:00:12"
}
],
"calendarEvent": null,
"inputLanguage": "en",
"translationLanguage": null,
"meetingApp": null
}
}
{
"error": {
"code": "not_found",
"message": "Note not found"
}
}
Path Parameters
string
required
The unique identifier of the note
Response
Note
Show Note
Show Note
string
Unique identifier for the note
string
Title of the note
string
Type of the note. One of
online, in-person, podcaststring
Current status of the note. One of
idle, recording,
transcript-processing, recorded-not-summarized, summarizing,
completedstring
ISO8601 timestamp when the note was created
string
ISO8601 timestamp when the note was last updated
string
Visibility setting. One of
only-me, workspace, publicobject[]
object[]
number
Total duration of the recording in seconds
string
User-written note content
string
AI-enhanced note content
string
Meeting summary content
object[]
object | null
Associated calendar event data
Show CalendarEvent
Show CalendarEvent
string
Event ID
string
Event URL
string
Event title
string
Start time (ISO8601)
string
End time (ISO8601)
string
Created time (ISO8601)
string
Updated time (ISO8601)
string
Calendar ID
string | null
Language of the audio input
string | null
Translation target language (if applicable)
string | null
App used to auto-start the meeting
curl --request GET \
--url https://api.caret.so/v1/notes/note_123456789 \
--header 'Authorization: Bearer <your_api_key>'
{
"note": {
"id": "note_123456789",
"title": "Weekly Team Sync",
"kind": "online",
"status": "completed",
"createdAt": "2024-01-28T10:00:00Z",
"updatedAt": "2024-01-28T11:30:00Z",
"visibility": "workspace",
"tags": [
{
"id": "fld_123",
"name": "Sales",
"color": "#4A90E2"
}
],
"participants": [],
"totalDurationSec": 3600,
"userWrittenNote": "",
"enhancedNote": "Meeting summary content...",
"summary": "Meeting summary content...",
"transcripts": [
{
"speaker": "John Doe",
"text": "Let's start with the weekly update.",
"startTimestamp": "00:00:05",
"endTimestamp": "00:00:12"
}
],
"calendarEvent": null,
"inputLanguage": "en",
"translationLanguage": null,
"meetingApp": null
}
}
{
"error": {
"code": "not_found",
"message": "Note not found"
}
}
⌘I