API Documentation

Programmatic access to Clause Labs AI. Upload contracts, create reviews, and export results via REST API.

Endpoints

9 REST endpoints

Rate Limit

100 req/hour

Tier Required

Team

Getting Started

Authentication

All API requests require an API key in the X-API-Key header. Manage API keys in your dashboard settings.

bash

curl -X GET https://api.Clause Labs.ai/api/v1/contracts \
  -H "X-API-Key: cp_live_your_key_here" \
  -H "Content-Type: application/json"

Key format

cp_live_...

Security

Never expose in client-side code or public repos.

Reference

POST/api/v1/contractsUpload a new contract (PDF, DOCX, or text)

GET/api/v1/contractsList contracts in your organization

GET/api/v1/contracts/{id}Get contract details by ID

POST/api/v1/reviewsCreate a new AI review for a contract

GET/api/v1/reviewsList reviews in your organization

GET/api/v1/reviews/{id}Get review details with clause findings

POST/api/v1/reviews/{id}/exportExport review as DOCX (tracked changes, clean, or original)

GET/api/v1/playbooksList available playbooks

GET/api/v1/billing/usageGet current billing usage statistics

Limits

API requests are limited to 100 requests per hour per API key. Rate limit information is included in response headers:

Header	Description
`X-RateLimit-Limit`	Maximum requests per hour
`X-RateLimit-Remaining`	Remaining requests this hour
`X-RateLimit-Reset`	Unix timestamp when limit resets

Errors

All error responses follow a consistent JSON format:

JSON response

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough review credits.",
    "status": 402
  }
}

Status	Meaning
`400`	Bad Request — invalid parameters
`401`	Unauthorized — invalid or missing API key
`402`	Payment Required — insufficient credits
`403`	Forbidden — insufficient permissions
`404`	Not Found — resource does not exist
`422`	Unprocessable Entity — validation error
`429`	Rate Limited — too many requests
`500`	Server Error — contact support

API access is available on the Team plan. Create API keys in your dashboard settings.