Skip to content

OpenAPI Specification

The complete MAHATI Systems API specification following OpenAPI 3.0 standards.

📖 About This Specification

Our OpenAPI specification provides:

  • Complete API Reference - All endpoints, parameters, and responses
  • Interactive Documentation - Browse and test APIs directly
  • Schema Definitions - Detailed data models and validation rules
  • Authentication Details - JWT Bearer token requirements
  • Multi-Service Architecture - 14 specialized microservices

🔍 View Full Specification

The complete OpenAPI specification is available in multiple formats:

YAML Format

Download openapi.yml

JSON Format

You can convert the YAML specification to JSON using tools like: - Swagger Editor - Online YAML to JSON converters - Command line tools (yq or js-yaml)

📋 API Information

Property Value
Title MAHATI OpenAPI Center
Version 1.0.0
Format OpenAPI 3.0.3
License MIT
Base URLs Multiple microservice endpoints (ports 3005-3035)

🏗️ Services Overview

Our API is organized into specialized microservices:

  • Auth Service (3023) - Authentication & authorization
  • Application Service (3020) - Core application management
  • Admin Service (3033) - System administration
  • Policy Service (3028) - Insurance policy management
  • Claims Service (3026) - Claims processing
  • Billing Service (3025) - Payment processing
  • Individual Service (3027) - Customer profiles
  • Document Service (3005) - Document management
  • External Integration (3034) - Third-party APIs
  • Audit Service (3035) - Activity logging
  • Reinsurance Service (3030) - Reinsurance operations
  • Policy Transaction (3029) - Transaction processing
  • Relationship Service (3031) - CRM functionality
  • Command Line (3032) - CLI operations

🔐 Security Schemes

All APIs use JWT Bearer Authentication:

securitySchemes:
  bearerAuth:
    type: http
    scheme: bearer
    bearerFormat: JWT
    description: "Enter your JWT token in the format: Bearer <token>"

📝 Using the Specification

For Developers

  • Import into your IDE for autocomplete and validation
  • Generate client SDKs using code generation tools
  • Use with API testing tools like Postman or Insomnia

For API Consumers

  • Browse interactive documentation in Swagger UI
  • Understand request/response formats
  • View authentication requirements

For API Designers

  • Edit and validate using Swagger Editor
  • Collaborate on API design and documentation
  • Maintain consistency across services