Skip to main content
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

The API enforces a limit of 600 requests per minute per IP address. If you exceed this limit you will receive a 429 Too Many Requests response.

​
Scopes

Access tokens can have the following scopes:
ScopeDescription
readList and retrieve resources.
writeCreate resources (documents, requests, webhooks).
read writeBoth 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

ResourceDescription
Repository DocumentsUpload and manage documents in your repository.
WorkflowsList your company’s workflows and inspect their schemas.
RequestsCreate legal requests and monitor their lifecycle.
WebhooksSubscribe to events like execution_complete.