Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Query Parameters

q
string

Only documents whose title contains this text (case-insensitive, 1 to 200 characters). Matched as plain text, so % and _ are not wildcards. Must not contain a NUL character (%00); one is rejected with VALIDATION_ERROR.

Required string length: 1 - 200
status
enum<string>

Only documents with this status. A document is expired only after its fixed expiry date has passed; at the exact expiry instant it is still live.

Available options:
live,
draft,
inactive,
expired
kind
enum<string>

Only documents of this kind.

Available options:
notion,
pdf,
upload,
post,
form
createdAfter
string<date-time>

Only documents created at or after this instant (inclusive).

createdBefore
string<date-time>

Only documents created before this instant (exclusive).

limit
integer
default:20

Documents per page. Values above 100 are treated as 100.

Required range: 1 <= x <= 100
cursor
string

The nextCursor from the previous page.

Maximum string length: 512

Response

A page of documents.

data
object[]
required

The documents on this page, newest first.

nextCursor
string | null
required

Pass as cursor to get the next page. null on the last page.