DocRouter REST API

Everything in the DocRouter UI is available through REST APIs. Build custom integrations, automate workflows, and access all features programmatically.

Interactive API Docs OpenAPI Schema

Authentication

The DocRouter REST API uses token-based authentication. Choose the appropriate token type based on your integration needs:

Account-Level Tokens

User-scoped access

Scope: APIs under /v0/account

To Create: Click Settings → Account Tokens

Organization-Level Tokens

Team-scoped access

Scope: APIs under /v0/orgs/{organization_id}

To Create: Click Settings → Organization Tokens

Token Management Interface

Screenshots showing the token management interface in the DocRouter application

API Examples

List All Organizations

Retrieve all organizations that the authenticated user can access.

Request

curl -X GET "https://app.docrouter.ai/fastapi/v0/account/organizations" \
     -H "Authorization: Bearer YOUR_ACCOUNT_TOKEN" \
     -H "Content-Type: application/json"

Response (200 OK)

{
  "organizations": [
    {
      "id": "12345678abcdef123456789a",
      "name": "my-organization",
      "members": [
        {
          "user_id": "12345678abcdef123456789b",
          "role": "admin"
        },
        {
          "user_id": "12345678abcdef123456789c",
          "role": "user"
        }
      ],
      "type": "team",
      "created_at": "2025-01-15T10:30:00.000000",
      "updated_at": "2025-01-15T14:20:00.000000"
    }
  ]
}

List All Documents

Retrieve all documents within a specific organization.

Request

curl -X GET "https://app.docrouter.ai/fastapi/v0/orgs/12345678abcdef123456789a/documents" \
     -H "Authorization: Bearer YOUR_ORGANIZATION_TOKEN" \
     -H "Content-Type: application/json"

Response (200 OK)

{
  "documents": [
    {
      "id": "12345678abcdef123456789d",
      "pdf_id": "12345678abcdef123456789e",
      "document_name": "invoice_2025_001.pdf",
      "upload_date": "2025-01-15T10:30:00.000000Z",
      "uploaded_by": "John Doe",
      "state": "llm_completed",
      "tag_ids": ["12345678abcdef123456789f"],
      "type": "invoice",
      "metadata": {}
    },
    {
      "id": "12345678abcdef123456789g",
      "pdf_id": "12345678abcdef123456789h",
      "document_name": "contract_agreement.pdf",
      "upload_date": "2025-01-14T15:20:00.000000Z",
      "uploaded_by": "Jane Smith",
      "state": "processing",
      "tag_ids": ["12345678abcdef123456789i"],
      "type": "contract",
      "metadata": {}
    }
  ],
  "total_count": 2,
  "skip": 0
}

Interactive Documentation

Open Swagger UI

Our interactive API documentation makes it easy to test endpoints, generate code samples, and understand the API structure.

1

Authenticate

• Click the "Authorize" button
• Enter your API token
• Click "Authorize" to authenticate

2

Test Endpoints

• Browse endpoints by category
• Click "Try it out" to enable
• Fill parameters and click "Execute"

3

Generate Code

• View the "Response" section
• Find the "Curl" tab
• Copy commands for your scripts

Resources & Tools

OpenAPI Specification

Complete API schema

Access the complete OpenAPI 3.0 specification for code generation and API exploration.

View OpenAPI JSON

Client Libraries

SDKs and code generation

Ready-to-use SDKs and tools for generating client libraries in your preferred language.

Python SDK

Official client library

OpenAPI Generator

Generate clients for TypeScript, Rust, Go, Java, and more