API Documentation

AUTHENTICATION

OAuth 2.0 Protocol.

All API requests require a valid Bearer token. Tokens are scoped to specific firm resources and expire after 24 hours. Refresh tokens are valid for 90 days.

Endpoint

POST https://api.lawya.com/v1/auth/token

curl -X POST https://api.lawya.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "firm_abc123",
    "client_secret": "sk_live_...",
    "grant_type": "client_credentials"
  }'

# Response
{
  "access_token": "eyJhbGc...",
  "token_type": "Bearer",
  "expires_in": 86400
}

Core Endpoints.

CASES

List All Cases

GET /v1/cases

Returns a paginated list of all cases accessible to the authenticated firm.

Query Parameters

status (string): Filter by case status (active, closed, archived)
page (integer): Page number for pagination
limit (integer): Results per page (max 100)

ARGU AI

Generate Legal Brief

POST /v1/ai/generate

Invoke Argü AI to draft legal documents based on case context and precedent analysis.

Request Body

{
  "case_id": "IKE-2025-001",
  "document_type": "motion",
  "context": "Bail application for economic crimes",
  "tone": "formal"
}

VAULT

Upload Document

POST /v1/vault/upload

Upload files directly to the Vault with automatic OCR, hashing, and indexing.

Headers

Content-Type: multipart/form-data
X-Case-ID: Target case identifier

Need API Access?

API access is available for Firm Medium and Enterprise tiers.

View Pricing