DraftRight API

AI-powered legal document generation, audio transcription, file conversion, contract analysis, and agreement building. One API key, one integration.

Base URL: https://draftright.co.uk/api

Authentication

API Key (Business)

Include your key in the x-api-key header.

curl -H "x-api-key: dr_your_api_key_here" \
  https://draftright.co.uk/api/invoice/scan \
  -F "file=@invoice.pdf"Copy

Bearer Token (Consumer)

From /api/auth/login.

curl -H "Authorization: Bearer eyJhbG..." \
  https://draftright.co.uk/api/documents/generate \
  -d '{"templateId":"nda","answers":{...}}'Copy

Plans & Pricing

Consumer

Business API

Enterprise Premium — Compliance Signals

Quick Start

1. Get your API key

POST /api/business/onboard
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{ "companyName": "Acme Ltd", "email": "dev@acme.com" }Copy

2. Scan an invoice

curl -X POST https://draftright.co.uk/api/invoice/scan \
  -H "x-api-key: dr_your_key" \
  -F "file=@invoice.pdf"Copy

3. Check usage

curl https://draftright.co.uk/api/biz-dashboard \
  -H "Authorization: Bearer YOUR_TOKEN"Copy

Errors

All errors return JSON with an error field.

{ "error": "Monthly API limit reached", "used": 200, "limit": 200, "upgrade": true }

Refresh Tokens & 2FA

Access tokens expire after 15 minutes. Use the refresh token (rotated on every refresh, family-tracked for theft detection) to mint a new access token without re-prompting the user.

curl -X POST https://draftright.co.uk/api/auth/refresh \
  -H "Content-Type: application/json" \
  --cookie "dr_refresh=YOUR_REFRESH_TOKEN" \
  --cookie-jar cookies.txtCopy

{
  "token": "eyJhbG...",
  "refreshToken": "eyJrZWY..."
}

Two-factor authentication (TOTP)

curl -X POST https://draftright.co.uk/api/auth/2fa/setup \
  -H "Authorization: Bearer TOKEN"Copy

{
  "secret": "JBSWY3DPEHPK3PXP",
  "qrUrl": "otpauth://totp/DraftRight:user@x?secret=...&issuer=DraftRight",
  "backupCodes": ["...","...","..."]
}

curl -X POST https://draftright.co.uk/api/auth/2fa/verify-setup \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"code":"123456"}'Copy

curl -X POST https://draftright.co.uk/api/auth/2fa/login \
  -H "Content-Type: application/json" \
  -d '{"tempToken":"...","code":"123456"}'Copy

Document Generator

Generate UK legal documents from 14+ templates (and growing). AI-powered with legislation references. The template library expands automatically as users interact with the platform.

curl -X POST https://draftright.co.uk/api/documents/generate \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "nda",
    "answers": {
      "party1_name": "Acme Ltd",
      "party2_name": "Jane Smith",
      "purpose": "Partnership discussion",
      "duration": "2 years"
    }
  }'Copy

{
  "content": "NON-DISCLOSURE AGREEMENT\n\nDate: 13 March 2026...",
  "templateId": "nda",
  "wordCount": 1247
}

Transcriber

Transcribe audio/video up to 1GB. Smart-splits long recordings at silence breaks, processes chunks with context continuity.

curl -X POST https://draftright.co.uk/api/transcribe \
  -H "Authorization: Bearer TOKEN" \
  -F "file=@meeting.mp3" \
  -F "timestamps=true" \
  -F "diarise=true" \
  -F "summarise=true"Copy

{
  "text": "Welcome to the masterclass...",
  "duration": 5586,
  "srt": "1\n00:00:00,000 --> 00:00:13,640\nWelcome...",
  "summary": "A 90-minute NLP masterclass covering...",
  "diarised_text": "[Speaker 1] Welcome..."
}

File Converter

Convert between 15+ formats. Documents, images, audio, video.

curl -X POST https://draftright.co.uk/api/converter/pdf_to_word \
  -H "Authorization: Bearer TOKEN" \
  -F "files=@document.pdf" --output converted.docxCopy

Smart Doc Reader

Upload any document and chat with it. AI extracts data, answers questions, provides summaries.

Agreement Builder

Upload meeting recordings or transcripts. AI extracts parties, terms, obligations, deadlines, financial terms — then generates a professional legal agreement.

curl -X POST https://draftright.co.uk/api/agreement/create \
  -H "Authorization: Bearer TOKEN" \
  -F "files=@meeting.mp3" \
  -F "title=Service Agreement" \
  -F "templateType=service_agreement"Copy

{
  "draftId": 42,
  "status": "processing",
  "message": "Analysing transcripts..."
}

curl https://draftright.co.uk/api/agreement/42 \
  -H "Authorization: Bearer TOKEN"Copy

curl https://draftright.co.uk/api/agreement/42/download?format=pdf \
  -H "Authorization: Bearer TOKEN" --output agreement.pdfCopy

Legal Analyser

Type-agnostic legal analysis of any document or recording. Identifies legal issues, parties, risk assessment, action items, and applicable UK legislation. Used by Cases as the analysis backbone.

curl -X POST https://draftright.co.uk/api/legal-analyse/analyse \
  -H "Authorization: Bearer TOKEN" \
  -F "files=@contract.pdf" \
  -F "title=Compliance Check" \
  -F "aiContext=Full compliance check under UK law"Copy

{
  "id": 17,
  "status": "queued",
  "title": "Compliance Check"
}

Cases (Matter Container)

A case is a matter-level container that ties transcripts, documents, analyses, agreements, and chat history together as a single unit. The case digest is an LLM-summarised view of everything attached; the chat lets you ask cited questions across the whole case.

Content attachment

Case digest (the AI summary)

Case chat (Pro+, returns 402 below)

curl -X POST https://draftright.co.uk/api/cases/3/chat \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"Was anything said that constitutes harassment?"}'Copy

{
  "role": "assistant",
  "content": "Based on the call transcript [transcripts:42] at 14:32...",
  "citations": [{"kind":"transcripts","id":42}],
  "model": "llama-3.1-70b-versatile",
  "provider": "groq"
}

Corrections (ground-truth overrides)

{
  "key_facts": {
    "tenant_name": "Mike Bestart",
    "property_address": "14 Marlowe Road"
  },
  "notes": "Tenant agreed verbally to vacate by month-end."
}

Document generation from case

Collaborators & sharing

Event Stream (SSE)

Server-Sent Events channel for push-based job state updates. Eliminates the ~15s polling lag from the heartbeat fallback — events arrive in ~50ms.

const es = new EventSource('https://draftright.co.uk/api/events/stream', {withCredentials:true});
es.addEventListener('hello', () => console.log('connected'));
es.addEventListener('job.update', (e) => {
  const {jobId} = JSON.parse(e.data);
  refetchJob(jobId);
});Copy

Invoice Scanner

Extract structured data from PDF/image invoices using OCR + AI.

curl -X POST https://draftright.co.uk/api/invoice/scan \
  -H "x-api-key: dr_your_key" \
  -F "file=@invoice.pdf"Copy

{
  "vendor": "Acme Supplies Ltd",
  "invoiceNumber": "INV-2026-0142",
  "date": "2026-03-01",
  "dueDate": "2026-03-31",
  "total": 1250.00,
  "tax": 250.00,
  "currency": "GBP",
  "lineItems": [
    { "description": "Web Development", "qty": 1, "unitPrice": 1000, "total": 1000 }
  ]
}

Contract Analysis

AI analysis of contracts: clause breakdown, red flags, compliance score, key dates.

curl -X POST https://draftright.co.uk/api/contract/analyze \
  -H "x-api-key: dr_your_key" \
  -F "file=@contract.pdf"Copy

{
  "summary": "12-month service agreement...",
  "complianceScore": 78,
  "clauses": [...],
  "redFlags": [
    { "clause": "4.2", "risk": "Unlimited liability", "severity": "high" }
  ],
  "keyDates": [
    { "date": "2026-04-01", "event": "Start date" }
  ]
}

Bulk Document Generation (API)

Generate up to 500 documents in a single call from a CSV upload or a JSON records array — one document per row, each formatted with UK legislation references.

curl -X POST https://draftright.co.uk/api/bulk-docs/api/generate \
  -H "x-api-key: dr_your_key" \
  -F "templateId=tenancy" \
  -F "file=@tenants.csv"Copy

{
  "total": 42,
  "success": 42,
  "failed": 0,
  "results": [
    { "index": 0, "content": "TENANCY AGREEMENT..." }
  ]
}

File Conversion (API)

Convert files via API key.

curl -X POST https://draftright.co.uk/api/converter/pdf_to_word \
  -H "x-api-key: dr_your_key" \
  -F "files=@document.pdf" --output converted.docxCopy

Transcription (API)

Full transcription via API key. Same capabilities as consumer.

curl -X POST https://draftright.co.uk/api/transcribe \
  -H "x-api-key: dr_your_key" \
  -F "file=@recording.mp3" \
  -F "timestamps=true" \
  -F "summarise=true"Copy

Agreement Builder (API)

Programmatically generate legal agreements from transcripts via API.

curl -X POST https://draftright.co.uk/api/agreement/api/create \
  -H "x-api-key: dr_your_key" \
  -F "files=@meeting.mp3" \
  -F "title=Service Agreement" \
  -F "templateType=service_agreement"Copy

{
  "draftId": 42,
  "status": "ready",
  "parties": [
    { "name": "Sarah", "role": "provider", "organisation": "The Coaching Corner" }
  ],
  "agreedTerms": [
    { "term": "500/month coaching", "confidence": "high", "category": "payment" }
  ],
  "generatedContent": "SERVICE AGREEMENT\n\nDate: 13 March 2026...",
  "usage": { "used": 3, "limit": 10 }
}

Company Search

Search UK Companies House.

curl "https://draftright.co.uk/api/company/search?q=Tesco" \
  -H "x-api-key: dr_your_key"Copy

curl "https://draftright.co.uk/api/company/profile/00445790" \
  -H "x-api-key: dr_your_key"Copy

Usage Stats

Real-time usage by endpoint, daily breakdown, recent activity.

curl https://draftright.co.uk/api/biz-dashboard \
  -H "Authorization: Bearer TOKEN"Copy

Compliance Signals

Enterprise Premium product. Continuous UK regulatory monitoring across seven live sources (gov.uk policy/HMRC/HSE/ICO/ACAS/Companies House/Parliament bills), AI-matched to your SIC codes, sectors and data posture. Signals carry severity, applicable actions, and pre-drafted compliance documents.

Business profile

Signal feed

curl https://draftright.co.uk/api/compliance-signals/signals?severity=high \
  -H "Authorization: Bearer TOKEN"Copy

Director Radar & Timeline

Personal-liability radar for company directors. Tracks regulatory exposure timelines, signal frequency by area, board-level risk surface.

Board Pack Generation

Quarterly board pack PDF synthesising signals + actions + health into a director-ready compliance brief.

Reviewer Onboarding & Identity

The Reviewer Portal lets UK-qualified solicitors review AI-drafted templates and earn royalties on every sale of templates they’ve approved. Onboarding requires SRA number, PII attestation, practising certificate attestation, and Stripe Identity verification.

Review Queue

Active reviewers see the AI-drafted templates needing review. Each round is a single template revision; reviewers can claim, then submit accept/reject/edit decisions.

Earnings, Stats & Stripe Connect

Reviewers earn royalty on every sale of a template they’ve approved. Earnings paid out via Stripe Connect.

Stripe Payments Webhook

Inbound webhook receiving Stripe events for subscription lifecycle, one-off purchases, and refunds. Signature-verified with idempotent handling.

Identity Verification Webhook

Same /api/payments/webhook endpoint also dispatches Stripe Identity events to the reviewer verification flow.

Document Templates

Gating semantics: Audit-gated templates return 410 Gone on all tiers (free + AI). RRA-gated returns 410 on Free tier only; AI-tier path generates with RRA-2025-aware prompts. Audit findings at AUDIT-2026-04-11.md; solicitor sign-off required before un-gating.

Public Config

Unauthenticated endpoint exposing client-side build flags — e.g. Sentry DSN if frontend telemetry is enabled.

curl https://draftright.co.uk/api/public/configCopy

{
  "sentryDsn": "https://...@sentry.io/...",
  "version": "v1.1",
  "env": "production"
}

Conversion Formats

Rate Limits

Monthly. Resets on the 1st.