Agora Legal Platform API

Agora is an enterprise legal technology platform for law firms.

Base URL: https://agora.redbroomsoftware.com

---

Overview

Agora provides:

• Matter Management: Case tracking and organization
• Document Management: Storage with AI-powered analysis
• Time Tracking: Ghost Timer for automatic time capture
• Billing & Trust: Invoicing and IOLTA trust accounting
• AI Services: Multi-provider AI for document review and research

---

Authentication

Authorization: Bearer <api_key>
Content-Type: application/json

Agora uses RBS ecosystem authentication via Camino SSO.

---

Matter Management

List Matters

GET /api/matters

Query Parameters:

Parameter	Type	Description
status	string	Filter by status
client_id	uuid	Filter by client
limit	number	Max results (default 50)

Response:

{
  "matters": [
    {
      "id": "uuid",
      "title": "Smith v. Jones",
      "clientId": "uuid",
      "clientName": "John Smith",
      "status": "active",
      "practiceArea": "Litigation",
      "createdAt": "2026-01-15T10:00:00Z"
    }
  ]
}

Get Matter

GET /api/matters/{id}

Create Matter

POST /api/matters

Request Body:

{
  "title": "New Case",
  "clientId": "uuid",
  "practiceArea": "Corporate",
  "description": "Merger & acquisition consultation"
}

---

Document Management

List Documents

GET /api/documents?matter_id={matterId}

Upload Document

POST /api/documents
Content-Type: multipart/form-data

Form Fields:

Field	Type	Required	Description
file	file	Yes	Document file
matterId	uuid	Yes	Associated matter
category	string	No	Document category

Search Documents

GET /api/documents/search?q={query}&matter_id={matterId}

AI-powered semantic search across documents.

---

Time Tracking

Ghost Timer

Automatic time tracking with activity detection.

Start Timer

POST /api/time/ghost-timer

Request Body:

{
  "matterId": "uuid",
  "description": "Document review"
}

Get Session

GET /api/time/ghost-timer/{sessionId}

Stop Timer

DELETE /api/time/ghost-timer/{sessionId}

Manual Time Entries

POST /api/time

Request Body:

{
  "matterId": "uuid",
  "date": "2026-01-28",
  "hours": 2.5,
  "description": "Client meeting",
  "billable": true,
  "rate": 2500.00
}

---

Billing & Invoicing

Create Invoice

POST /api/billing/invoices

Request Body:

{
  "matterId": "uuid",
  "timeEntryIds": ["uuid", "uuid"],
  "dueDate": "2026-02-28",
  "notes": "Payment due within 30 days"
}

Get Invoice

GET /api/billing/invoices/{id}

IOLTA Trust Accounts

GET /api/billing/trust

Trust account balances and transactions for client funds.

---

AI Services

Agora integrates with multiple AI providers for legal work.

Document Summary

POST /api/ai/document-summary

Request Body:

{
  "documentId": "uuid",
  "type": "brief" | "detailed"
}

Case Analysis

POST /api/ai/case-analysis

Request Body:

{
  "matterId": "uuid",
  "question": "What are the key liability risks?"
}

Legal Research

POST /api/ai/research

Request Body:

{
  "query": "Mexican corporate law requirements for foreign ownership",
  "jurisdiction": "Mexico"
}

AI Chat

POST /api/ai/chat

Conversational AI for matter-specific questions.

Deadline Detection

POST /api/ai/deadlines

Extract deadlines from uploaded documents.

---

Ecosystem Integration

Constanza (CFDI)

Stamp invoices as Mexican tax compliant:

POST /api/ecosystem/cfdi/stamp

Request Body:

{
  "invoiceId": "uuid",
  "receptor": {
    "rfc": "XAXX010101000",
    "razonSocial": "Client Name",
    "usoCfdi": "G03"
  }
}

Colectiva (Payments)

Process invoice payments:

POST /api/ecosystem/payments

Ecosystem Intakes

POST /api/ecosystem/intakes

Receive new client intakes from Camino CRM.

---

Error Handling

{
  "error": "Matter not found",
  "code": "MATTER_NOT_FOUND"
}

Error Codes

Code	HTTP Status	Description
UNAUTHORIZED	401	Invalid credentials
MATTER_NOT_FOUND	404	Matter doesn't exist
DOCUMENT_TOO_LARGE	413	File exceeds limit
AI_RATE_LIMITED	429	AI usage limit reached
TRUST_INSUFFICIENT	400	Insufficient trust balance

---

Related Documentation

• Constanza CFDI - Tax invoice stamping
• Colectiva Payments - Payment processing
• Camino CRM - Client intake and CRM
• SSO Authentication - Ecosystem authentication