Documentation Index
Fetch the complete documentation index at: https://docs.simpledocs.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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"
}
}
}
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"
}
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 |
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. |
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. |
