Notes

Search notes

Searches the authenticated user's indexed note titles and bodies, including recording summaries and saved text, using keyword and semantic matching.

Returns up to limit results ordered from most to least relevant. Search does not support pagination. is_truncated indicates that additional results were found.

New or updated notes may be missing until indexing completes. Changing limit can change the ranking. Use the list endpoint to retrieve all notes and the get endpoint to read note content.

Requires the blinq:notes:read scope.

get/v1/notes/search

Request

  • Base URL
    https://api.blinq.me
  • Auth
    HTTP bearer

Query parameters

querystring required

Search terms to match against indexed titles and bodies, including recording summaries and saved text.

limitinteger

The maximum number of search results to return. Search does not support pagination.

Response

Search results ordered by relevance.

is_truncatedboolean required

Whether this search found more results than limit. A value of false does not guarantee that every note was searched. Use the list endpoint to retrieve all notes.

Example response

{
  "notes": [
    {
      "id": "note-id",
      "title": "Meeting notes",
      "created_at": "2026-10-01T00:00:00.000Z",
      "updated_at": "2026-10-01T00:00:00.000Z",
      "deleted_at": null,
      "status": "ready",
      "type": "voice_note",
      "share_url": "https://note.blinq.me/share-id",
      "linked_contacts": [
        {
          "id": "contact-id",
          "full_name": "Jane Doe",
          "workspace_id": "workspace-id"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.