Files
Goa-gel-fullstack/Documentation/developers/core-apis.md
Mahi 435889ee79 docs: Rebuild documentation as enterprise-grade TLAS platform
- Migrate from custom HTTP server to VitePress framework
- Rename project to Tokenized License Approval System (TLAS)
- Add comprehensive documentation for all stakeholders:
  - Business: Executive summary, value proposition, governance
  - Operations: Infrastructure, installation, monitoring, backup
  - Departments: User guide, workflows, verification, issuance
  - Developers: API reference, authentication, webhooks, SDKs
  - Compliance: OWASP, DPDP Act, IT Act, audit framework
- Add modern theme with dark mode and full-text search
- Update Dockerfile for VitePress build process

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-10 00:05:20 -04:00

2.2 KiB

Core APIs

Applications

Submit Application

POST /applications

Request Body

{
  "licenseType": "TRADE_LICENSE",
  "applicantId": "DL-12345678",
  "businessName": "ABC Enterprises",
  "address": {
    "line1": "123 Main Street",
    "city": "Panaji",
    "state": "Goa",
    "pincode": "403001"
  },
  "documents": [
    { "type": "IDENTITY_PROOF", "documentId": "DOC-001" },
    { "type": "ADDRESS_PROOF", "documentId": "DOC-002" }
  ]
}

Response

{
  "success": true,
  "data": {
    "applicationId": "APP-2026-00001",
    "status": "SUBMITTED",
    "submittedAt": "2026-02-09T10:30:00Z",
    "estimatedCompletion": "2026-02-16T10:30:00Z"
  }
}

Get Application Status

GET /applications/:applicationId

Response

{
  "success": true,
  "data": {
    "applicationId": "APP-2026-00001",
    "status": "IN_REVIEW",
    "currentStage": "DOCUMENT_VERIFICATION",
    "stages": [
      { "name": "SUBMITTED", "completedAt": "2026-02-09T10:30:00Z" },
      { "name": "DOCUMENT_VERIFICATION", "startedAt": "2026-02-09T11:00:00Z" }
    ],
    "nextAction": "Awaiting document verification"
  }
}

List Applications

GET /applications?status=PENDING&page=1&limit=20

Documents

Upload Document

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

Form Fields

  • file: Document file (PDF, JPG, PNG)
  • type: Document type code
  • applicationId: Associated application (optional)

Response

{
  "success": true,
  "data": {
    "documentId": "DOC-2026-00001",
    "fileName": "identity_proof.pdf",
    "fileSize": 245678,
    "mimeType": "application/pdf",
    "uploadedAt": "2026-02-09T10:25:00Z"
  }
}

Get Document

GET /documents/:documentId

Verification

Verify Certificate

GET /verify/:tokenId

Response

{
  "success": true,
  "data": {
    "valid": true,
    "license": {
      "number": "GOA/TRADE/2026/00001",
      "holder": "ABC Enterprises",
      "issuedBy": "Department of Trade",
      "issuedAt": "2026-02-09",
      "validUntil": "2027-02-08"
    },
    "blockchain": {
      "tokenId": "0x1234...",
      "transactionHash": "0xabcd...",
      "blockNumber": 12345
    }
  }
}