Developer Portal & API Reference

Overview

The CecAI Studio REST API provides programmatic access to document parsing, entity verification, and legal document generation tailored for the Malaysian legal market. All endpoints communicate over TLS 1.3 and return standard JSON payloads.

Quickstart

Extract structured legal entities from a scanned land title in one HTTP request using cURL:

curl -X POST https://cecaiautomation.my/api/v1/documents/parse \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -F "file=@/path/to/geran_hakmilik_grn58219.pdf" \\
  -F "document_type=geran_hakmilik" \\
  -F "confidence_threshold=0.90"

Authentication

Authenticate API requests using your secret API key generated in the CecAI Studio Console. Include your key in the standard Authorization header using the Bearer scheme:

Keep your API keys secret. Never expose secret keys in client-side applications or public git repositories.

POST /v1/documents/parse

Uploads and parses a legal conveyancing document. Processes Land Titles, SSM Profiles, MyKad, or Loan Facility Letters.

Parameters

• file (binary, required): PDF, TIFF, or PNG up to 100MB.
• document_type (string, optional): geran_hakmilik, ssm_corporate_profile, mykad_identification, facility_letter, or auto_detect. Default: auto_detect.
• confidence_threshold (float, optional): Threshold (0.0 to 1.0) below which fields require human secretary verification. Default: 0.90.

Example Response (200 OK)

{
  "job_id": "doc_9f81a7b8e21",
  "document_type": "geran_hakmilik",
  "overall_confidence": 0.994,
  "entities": {
    "title_number": "GRN 58219",
    "lot_number": "Lot 4821",
    "mukim": "Mukim Petaling",
    "daerah": "Petaling",
    "negeri": "Selangor",
    "land_area": "782.5 sq metres",
    "tenure": "Freehold (Pegangan Selamanya)",
    "registered_proprietors": [
      {
        "name": "TAN SENG HOCK",
        "id_number": "820415-10-5893",
        "share": "1/1"
      }
    ],
    "encumbrances": [
      "Charged to Malayan Banking Berhad (Presentation No. 04812/2021)"
    ],
    "restrictions_in_interest": "Tanah ini tidak boleh dipindahmilik melainkan dengan kebenaran Pihak Berkuasa Negeri."
  }
}

GET /v1/health

Live health check endpoint returning operational metrics and component status for automated monitoring.

{
  "status": "operational",
  "version": "2.4.1",
  "region": "ap-southeast-1 (Kuala Lumpur / Singapore)"
}