Introduction

The SimpleDocs API gives you programmatic access to your company’s legal workflows. Use it to upload documents, create requests, track their progress, and receive real-time webhook notifications — all from your own systems.

Base URL

All API requests are made to:

https://app.simpledocs.com/api/v1

Authentication

The API uses OAuth 2.0 client credentials for authentication. You’ll exchange your client_id and client_secret for a Bearer token, then include it in every request. See the Authentication guide for the full walkthrough.

Versioning

The API is versioned via the URL path (/v1). Breaking changes will be introduced under a new version number. Non-breaking additions (new fields, new endpoints) may be added to the current version without notice.

Response format

All resource responses use the JSON:API serialization format:

{
  "data": {
    "id": "0dbhXg",
    "type": "repository_document",
    "attributes": {
      "name": "Employment Agreement.pdf",
      "created_at": "2026-03-05T14:30:00Z"
    }
  }
}

List endpoints include a pagination object alongside data:

{
  "data": [ ... ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_pages": 3,
    "total_count": 72
  }
}

Errors

Errors follow the RFC 9457 Problem Details format:

{
  "type": "parameter_missing",
  "status": 400,
  "title": "Bad Request",
  "detail": "File or URL is required",
  "instance": "/api/v1/repository_documents",
  "request_id": "abc-123"
}

The request_id field is useful when contacting support.

Rate limits

Endpoint	Limit
`POST /api/oauth/token`	10 requests / minute per IP
All other `/api/v1/*`	600 requests / minute per IP

Exceeding either limit returns a 429 Too Many Requests response.

Scopes

Access tokens can have the following scopes:

Scope	Description
`read`	List and retrieve resources.
`write`	Create resources (documents, requests, webhooks).
`read write`	Both read and write access.

You can omit scope if you only need read access and your OAuth application is scoped to read or write — it defaults to read. If your application has the read write scope, you must specify scope explicitly. See Authentication for details.

Resources

Resource	Description
Repository Documents	Upload and manage documents in your repository.
Workflows	List your company’s workflows and inspect their schemas.
Requests	Create legal requests and monitor their lifecycle.
Webhooks	Subscribe to events like `execution_complete`.

Getting Started

Guides

Base URL

Authentication

Versioning

Response format

Errors

Rate limits

Scopes

Resources

​Base URL

​Authentication

​Versioning

​Response format

​Errors

​Rate limits

​Scopes

​Resources

Base URL

Authentication

Versioning

Response format

Errors

Rate limits

Scopes

Resources