---
title: "List notes, newest first"
method: GET
path: "/v1/notes"
tags: ["notes"]
---

# List notes, newest first

`GET /v1/notes`

## Request

- Base URL: `https://api.audiomap.ai`
- URL: `https://api.audiomap.ai/v1/notes`
- Auth: HTTP bearer

Cursor pagination: pass the `nextCursor` of a response as `cursor` to get the next page. `hasMore` says whether there is one.

## Query parameters

- `limit` integer
- `cursor` string, uuid
- `q` string
- `folderId` string
- `status` 'processing' | 'ready' | 'failed'
- `since` string, date-time
- `tags` string
- `origin` string

## Response `200`

A page of notes

- NoteList
  - `notes` Note[]
    - `id` string, uuid
    - `title` string
    - `description` string, nullable
    - `status` 'processing' | 'ready' | 'failed'
    - `errorCode` string, nullable: Why it failed; null otherwise
    - `sourceType` 'upload' | 'recording' | 'url'
    - `origin` 'youtube' | 'podcast' | 'link' | 'video' | 'audio' | 'recording'
    - `sourceUrl` string, nullable
    - `folderId` string, uuid, nullable
    - `tags` string[]
    - `durationSeconds` integer, nullable
    - `language` string, nullable
    - `recordedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `nextCursor` string, uuid, nullable
  - `hasMore` boolean

## Other responses

- `400`: Invalid query parameters
- `401`: Missing or invalid API key
- `403`: Your plan does not include the REST API
- `404`: No note with that id belongs to you
- `429`: Too many requests for this API key

---

[API](https://skmtc.dev/audiomap/apis/audiomap-api.md) · [All operations](https://skmtc.dev/audiomap/apis/audiomap-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audiomap/apis/audiomap-api/revisions/0bc0c0fc6cbb?raw)