Notes

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.

get/v1/notes

Request

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

Query parameters

created_afterstring date-time

Return notes created after this ISO 8601 timestamp with a timezone, such as 2026-10-01T00:00:00Z (exclusive).

created_beforestring date-time

Return notes created before this ISO 8601 timestamp with a timezone, such as 2026-11-01T00:00:00Z (exclusive).

updated_at_gtestring date-time

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.

order_by'created_at' | 'updated_at'

The timestamp used to sort notes in descending order. Keep this value unchanged between pages.

cursorstring

The next_cursor from the previous response. Omit on the first request. Keep filters and order_by unchanged between pages.

limitinteger

The maximum number of notes to return per page.

Response

One page of note metadata.

has_moreboolean required

Whether another page of notes is available.

next_cursorstring nullable required

The cursor for the next page. When has_more is true, pass this value as cursor. Otherwise, this value is null.

total_countinteger nullable required

The total number of notes matching the filters. Returned on the first page; null on subsequent pages.

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.