List notes
Returns a paginated list of the authenticated user's note metadata.
Notes are sorted by creation time, newest first, unless order_by specifies update time. Ties are broken by note ID, so pages are deterministic.
For an initial sync, page with order_by=updated_at until has_more is false. For incremental syncs, record a checkpoint before each run, pass it as updated_at_gte (inclusive) with a small overlap, upsert by id, and advance the checkpoint only after every page succeeds.
Deleted notes are omitted. There is no deletion feed; periodically reconcile a complete list of IDs to detect removals. Timestamp filtering alone does not provide lossless synchronization.
Get an individual note to read its content.
Requires the blinq:notes:read scope.
Request
- Base URLhttps://api.blinq.me
- AuthHTTP bearer
Query parameters
Return notes created after this ISO 8601 timestamp with a timezone, such as 2026-10-01T00:00:00Z (exclusive).
Return notes created before this ISO 8601 timestamp with a timezone, such as 2026-11-01T00:00:00Z (exclusive).
Return notes last updated at or after this ISO 8601 timestamp with a timezone, such as 2026-10-01T00:00:00Z (inclusive). Deleted notes are excluded.
The timestamp used to sort notes in descending order. Keep this value unchanged between pages.
The next_cursor from the previous response. Omit on the first request. Keep filters and order_by unchanged between pages.
The maximum number of notes to return per page.
Response
One page of note metadata.
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.