DocRouter REST API Reference

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 Tokens

User-scoped access

Scope: APIs under /v0/account

To Create: Click Settings → Account Tokens

Organization Tokens

Team-scoped access

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

To Create: Click Settings → Organization Tokens

Token Management Interface

Access Settings

Click your user menu → Settings

Manage Tokens

Click "Manage" for Account or Organization Tokens

Screenshots showing how to access 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
}