GET/api/v1/me/documents

List your documents

The documents and files you own, a page at a time, with counts of each kind.

API token requiredMCP: list_documents

Code samples and Try it

Query parameters

pageinteger
Page number, from 1. At least 1. Default 1.
limitinteger
How many to return. From 1 to 100. Default 20.
per_pageinteger
Same as limit, up to 50; wins when both are sent. From 1 to 50.
qstring
Only titles or addresses containing this text.
kindstring
document (or markdown) for documents, artifact for files. One of markdown, document, artifact. One of markdown, document, artifact.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).

200 response: 8 fields (MyDocListResponse)

documentsarray of object
30 fields inside
- idstring | null
- slugstring
- urlstring
- titlestring | null
  Shown on the page and in link previews.
- content_previewstring
- created_atstring (date-time)
  ISO 8601, for example 2026-11-30T12:00:00Z.
- updated_atstring (date-time)
  ISO 8601, for example 2026-11-30T12:00:00Z.
- expires_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- viewsinteger
  Default 0.
- export_pdf_countinteger
  Default 0.
- copy_url_countinteger
  Default 0.
- is_password_protectedboolean
  Default false.
- google_doc_urlstring | null
- google_doc_staleboolean
  Default false.
- vscode_syncedboolean
  Default false.
- encryptedboolean
  Set by clients that encrypt in the browser: content and title are already ciphertext. The server never sees the key. Default false.
- kindstring
  Default "markdown".
- mimestring | null
- rendererstring | null
- type_labelstring | null
- size_bytesinteger | null
- original_filenamestring | null
- workspace_idstring | null
- folder_idstring | null
- folder_patharray of string
- access_levelstring
  Who can open it: link (anyone with the link), private (only you and the people you share it with) or workspace (members of its workspace). Default "link".
- shared_with_countinteger
  Default 0.
- shared_by_namestring | null
- shared_by_emailstring | null
- is_mineboolean
  Default true.
totalinteger
pageinteger
pagesinteger
per_pageinteger
Default 20.
count_allinteger
Default 0.
count_markdowninteger
Default 0.
count_artifactinteger
Default 0.

import os import requests r = requests.get( "https://api.markdrop.in/api/v1/me/documents", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, ) r.raise_for_status() print(r.json())