Uni Lann Pya API

Response Envelope

{
  "success": "boolean",
  "message": "string",
  "timestamp": "ISO-8601 string",
  "requestId": "string",
  "data": "endpoint-specific payload or null",
  "meta": "safe response metadata or null",
  "error": "public error object or null"
}

Production Boundaries

• API routes validate HTTP input and return typed envelopes.
• Rule-engine services own eligibility and dataset filtering.
• LLM responses explain verified results without overriding them.
• Public responses never expose prompts or internal reasoning.

Request

Content type: application/json

{
  "message": "I want to find universities based on my matriculation marks."
}

Response

{
  "success": true,
  "message": "Chat response generated.",
  "timestamp": "2026-07-04T00:00:00.000Z",
  "requestId": "uuid",
  "data": {
    "answer": "Based on verified data, you can consider universities that match your marks and target career.",
    "recommendations": [
      {
        "rank": 1,
        "universityName": "Yangon Technological University",
        "universityNameMm": "ရန်ကုန်နည်းပညာတက္ကသိုလ်",
        "category": "Technology",
        "minimumMarks": 420,
        "durationYears": 5,
        "degrees": [
          "B.E.",
          "B.Tech."
        ],
        "matchReason": "This is a verified Technology option; minimum mark is 420."
      }
    ],
    "followUpQuestions": [
      "Add my target major",
      "Add my career goal"
    ]
  },
  "meta": {
    "intent": "university_eligibility",
    "language": "English",
    "recommendationCount": 1,
    "dailyLimit": 10,
    "dailyUsed": 1,
    "dailyRemaining": 9,
    "dailyResetAt": "2026-07-04T17:30:00.000Z"
  },
  "error": null
}