API Reference

case.dev provides a comprehensive suite of APIs for building legal tech applications. All APIs follow OpenAPI standards and are accessible via RESTful HTTP endpoints.

Base URL

https://api.case.dev

Authentication

All API requests require your API key in the Authorization header:

Authorization: Bearer sk_case_your_api_key_here

Get your API key from the console.

Available Services

LLMs

Access 130+ language models from OpenAI, Anthropic, Google, and more through a unified interface.

• Base Path: /llm/v1
• Key Endpoints: /chat/completions, /embeddings, /models
• View LLM Documentation →

Workflows

Execute 700+ pre-built legal document workflows without exposing prompts.

• Base Path: /workflows/v1
• Key Endpoints: /workflows, /search, /{id}/execute
• View Workflows Documentation →

Actions

Orchestrate multi-step processes by chaining services together.

• Base Path: /actions/v1
• Key Endpoints: /actions, /{id}/execute, /executions/{id}
• View Actions Documentation →

Vaults

Secure document storage with semantic search powered by S3 and vector embeddings.

• Base Path: /vault
• Key Endpoints: /vault, /{id}/upload, /{id}/objects
• View Vaults Documentation →

OCR / Vision

Extract text from documents using advanced computer vision models.

• Base Path: /ocr/v1
• Key Endpoints: /process, /{id}
• View Vision Documentation →

Voice

Transcription and text-to-speech services for audio processing.

• Base Path: /voice
• Key Endpoints: /transcription, /transcription/{id}
• View Voice Documentation →

Convert

Convert FTR court recording files to standard M4A audio format.

• Base Path: /convert/v1
• Key Endpoints: /process, /jobs/{id}, /download/{id}
• View Convert Documentation →

Knowledge Graphs (Coming Soon)

Graph-based knowledge retrieval for discovering entity relationships.

• Base Path: /graph/v1
• Key Endpoints: /ingest, /search
• View Knowledge Graphs Documentation →

Common Patterns

Error Responses

All APIs return consistent error responses:

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Descriptive error message"
  }
}

Common error codes:

• AUTH_INVALID (401) - Invalid or missing API key
• PERMISSION_DENIED (403) - API key lacks required permissions
• NOT_FOUND (404) - Resource not found
• INVALID_REQUEST (400) - Invalid request parameters
• RATE_LIMIT_EXCEEDED (429) - Too many requests

Pagination

List endpoints support pagination:

GET /workflows/v1?limit=50&offset=0

Parameters:

• limit - Max results per page (default: 50)
• offset - Number of results to skip

Async Operations

Long-running operations return immediately with a job/execution ID:

{
  "id": "job_abc123",
  "status": "processing"
}

Poll for status:

GET /service/jobs/{id}

Or configure webhooks for notifications.

Rate Limits

• Default: 100 requests/minute per API key
• Burst: Up to 200 requests/minute
• Headers: Check X-RateLimit-* headers in responses

Upgrade your plan for higher limits.

SDKs

Official SDKs coming soon for:

• TypeScript/JavaScript
• Python
• Go
• Ruby

For now, use any HTTP client with the OpenAPI-compatible endpoints.

Support

• Documentation: docs.case.dev
• Console: console.case.dev
• Status Page: status.case.dev
• Email: support@case.dev