curl "https://api.mem.ai/v2/notes/search?limit=20&offset=0" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $MEM_API_KEY" \
--data '{
"query": "sales"
}'{
"has_next_page": true,
"limit": 1,
"offset": 0,
"request_id": "api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
"results": [
{
"audio_recording_ids": [
"78ff64bc-09e3-4fd7-a4b9-53c258f35619"
],
"collection_ids": [
"59508b41-8770-4855-aa37-302b1e09aee7"
],
"content": "# Recipe Notes\n\n- Lemon pasta\n- Chili oil dumplings\n",
"created_at": "2025-03-18T11:00:00Z",
"id": "018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
"snippet": "Dinner ideas",
"title": "Recipe Notes",
"updated_at": "2025-04-22T16:12:34Z"
}
],
"snapshot_id": "fd233b1f-25ac-4c0d-94db-4fa0843084ff",
"total": 12
}Search Notes
Search notes using a required free-text query and structured filters.
When multiple filter_by_contains_* fields are true, a note may match any of them.
Returns note results from a bounded search snapshot with deterministic offset pagination.
Query-based searches are relevance-ranked within the bounded search snapshot window.
Reuse the returned snapshot_id when requesting later pages.
The returned total reflects the bounded search snapshot, capped by the 100-result search window.
For deterministic chronological pagination across all accessible notes, use GET /v2/notes.
curl "https://api.mem.ai/v2/notes/search?limit=20&offset=0" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $MEM_API_KEY" \
--data '{
"query": "sales"
}'{
"has_next_page": true,
"limit": 1,
"offset": 0,
"request_id": "api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
"results": [
{
"audio_recording_ids": [
"78ff64bc-09e3-4fd7-a4b9-53c258f35619"
],
"collection_ids": [
"59508b41-8770-4855-aa37-302b1e09aee7"
],
"content": "# Recipe Notes\n\n- Lemon pasta\n- Chili oil dumplings\n",
"created_at": "2025-03-18T11:00:00Z",
"id": "018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
"snippet": "Dinner ideas",
"title": "Recipe Notes",
"updated_at": "2025-04-22T16:12:34Z"
}
],
"snapshot_id": "fd233b1f-25ac-4c0d-94db-4fa0843084ff",
"total": 12
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Maximum number of notes in this search page. Use smaller values for lower latency. Default is 20; valid range is 1 to 50.
1 <= x <= 50Number of matching notes to skip before returning results. This value is zero-based.
x >= 0Opaque search snapshot identifier returned by a previous search page.
Required when requesting later pages with offset > 0.
Body
Required text query for relevance matching.
The query must contain at least one non-whitespace character.
This endpoint does not provide exhaustive chronological pagination; for that, use
GET /v2/notes.
1Configuration flags controlling search response payload shape.
Show child attributes
Show child attributes
Optional collection UUID filters. When provided, results are limited to notes in any listed collection.
When true, include notes that contain file-like attachments (including file and PDF kinds).
When true, include notes that contain image media (including image and GIF kinds).
When true, include notes that contain at least one open task item.
When true, include notes that contain at least one task item (open or closed).
Optional inclusive lower bound for note creation time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
"2025-04-01T14:30:45Z"
Optional inclusive upper bound for note creation time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
"2025-04-30T23:59:59Z"
Optional inclusive lower bound for note update time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
"2025-04-01T14:30:45Z"
Optional inclusive upper bound for note update time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
"2025-04-30T23:59:59Z"
Response
OK
Whether another request within the 100-result search window can return more matching notes.
Limit applied to this search page.
Zero-based offset applied before returning results.
Identifier for this API request. Useful for tracing and support.
Relevance-ranked note results matching the search request.
Show child attributes
Show child attributes
Opaque snapshot identifier to reuse for deterministic later pages.
Number of matching notes captured in the bounded search snapshot, capped by the 100-result search window.