Skip to main content
GET
List notes

Authorizations

Authorization
string
header
required

Send a Blinq API key as Authorization: Bearer <api-key>; enter only the key in the documentation playground.

Create and revoke keys in the Blinq web app under Settings > API keys.

The key needs the scopes required by the operation, and public API access requires a Pro or Business plan.

Query Parameters

created_after
string<date-time>

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

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
created_before
string<date-time>

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

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
updated_at_gte
string<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.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
order_by
enum<string>
default:created_at

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

Available options:
created_at,
updated_at
cursor
string

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

Minimum string length: 1
limit
integer
default:25

The maximum number of notes to return per page.

Required range: x <= 50

Response

One page of note metadata.

One page of note metadata.

notes
object[]
required

Note metadata for this page. Get an individual note to read its content.

has_more
boolean
required

Whether another page of notes is available.

next_cursor
string | null
required

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

total_count
integer | null
required

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

Required range: -9007199254740991 <= x <= 9007199254740991