List documents

Redline API›Documents

GEThttps://api.redline.example/v1/matters/{matter_id}/documents

AuthRequires authentication via bearerAuth.

Description

Returns documents in a Matter, including drafts, returned redlines, and the Executed Copy.

Request

cURLJavaScriptPython

Copy

curl "https://api.redline.example/v1/matters/mat_01JAZ6Q7K2/documents?limit=20&cursor=string&kind=draft" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.redline.example/v1/matters/mat_01JAZ6Q7K2/documents?limit=20&cursor=string&kind=draft", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
  },
});

import requests

response = requests.get(
    "https://api.redline.example/v1/matters/mat_01JAZ6Q7K2/documents",
    params={
      "limit": "20",
      "cursor": "string",
      "kind": "draft"
    },
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response200JSONCopy

{
  "data": [
    {
      "id": "doc_01JAZ7C3V9",
      "matter_id": "mat_01JAZ6Q7K2",
      "name": "Aster Peak MSA v3.docx",
      "kind": "draft",
      "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "size_bytes": 284219,
      "version_number": 3,
      "created_at": "2026-07-11T19:40:02Z"
    }
  ],
  "next_cursor": null
}

Parameters

matter_idpathstringrequired

Matter identifier.

limitqueryintegerdefault: 20

Maximum number of records to return, from 1 to 100.

cursorquerystring

Opaque cursor from the previous page response.

kindquerystring

Return only documents of this kind.

Responses

200A page of documents.application/json

dataobject[]required

next_cursorstring | nullrequired

401The API key is missing, malformed, expired, or revoked.application/json

errorobjectrequired

404The resource was not found in the authenticated Workspace.application/json

errorobjectrequired