List Clauses

Redline API›Clauses

GEThttps://api.redline.example/v1/clauses

AuthRequires authentication via bearerAuth.

Description

Searches active and retired Clause Library entries in the Workspace.

Request

cURLJavaScriptPython

Copy

curl "https://api.redline.example/v1/clauses?limit=20&cursor=string&query=limitation%20of%20liability&category=Risk%20allocation&status=draft" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.redline.example/v1/clauses?limit=20&cursor=string&query=limitation%20of%20liability&category=Risk%20allocation&status=draft", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
  },
});

import requests

response = requests.get(
    "https://api.redline.example/v1/clauses",
    params={
      "limit": "20",
      "cursor": "string",
      "query": "limitation of liability",
      "category": "Risk allocation",
      "status": "draft"
    },
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response200JSONCopy

{
  "data": [
    {
      "id": "cls_01J8V1B4H6",
      "title": "Mutual liability cap",
      "category": "Risk allocation",
      "text": "Except for excluded claims, each party's aggregate liability will not exceed fees paid or payable in the twelve months before the event giving rise to the claim.",
      "status": "approved",
      "version": 4,
      "tags": [
        "liability",
        "mutual",
        "fees"
      ],
      "owner_id": "usr_01J7Z9K3W8",
      "reviewed_at": "2026-04-17T15:00:00Z",
      "updated_at": "2026-04-17T15:00:00Z"
    }
  ],
  "next_cursor": null
}

Parameters

limitqueryintegerdefault: 20

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

cursorquerystring

Opaque cursor from the previous page response.

queryquerystring

Text matched against Clause titles, text, and tags.

categoryquerystring

Return only Clauses in this category.

statusquerystring

Return Clauses with this governance status.

Responses

200A page of Clauses.application/json

dataobject[]required

next_cursorstring | nullrequired

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

errorobjectrequired