Read Voice Notes

List, search, filter, and retrieve notes with the Public API.

All Notes endpoints use the base URL:

https://api.monologue.to/v1/public-api

List notes

GET /notes

The list response contains note metadata, summaries, and tags. Use the detail endpoint when you need the transcript.

Query parameter	Meaning
`limit`	Items per page. Defaults to 20; maximum 100.
`cursor`	Opaque `next_cursor` from the previous response.
`created_after`	Notes created after this ISO 8601 timestamp.
`created_before`	Notes created before this ISO 8601 timestamp.
`updated_after`	Notes updated after this ISO 8601 timestamp.
`q`	Searches title, summary, and transcript.
`tag_id`	Matches any supplied tag. Repeat the parameter for more than one tag.

curl --get "https://api.monologue.to/v1/public-api/notes" \
  --header "Authorization: Bearer $MONOLOGUE_API_TOKEN" \
  --data-urlencode "q=launch review" \
  --data-urlencode "created_after=2026-07-01T00:00:00Z" \
  --data-urlencode "limit=20"

Retrieve a note

GET /notes/{note_id}

The detail response includes transcript and transcript_segments in addition to the fields returned by the list endpoint.

curl "https://api.monologue.to/v1/public-api/notes/$NOTE_ID" \
  --header "Authorization: Bearer $MONOLOGUE_API_TOKEN"

Only notes owned by the authenticated user are available. An unknown or inaccessible note returns 404.