E-Porikkha.
API Reference

Build on E-Porikkha

A REST API to submit papers, fetch results, and manage batches programmatically — integrate grading directly into your school's systems.

Base URL: https://api.e-porikkha.com

Authentication

Bearer token in every request header

All API requests require an API key passed as a Bearer token. Generate your key from Settings → API Keys.

Authorization: Bearer ep_live_xxxxxxxxxxxxxxxxxxxx

Papers

POST/api/papers/
GET/api/papers/
GET/api/papers/{id}/
POST/api/papers/{id}/regrade/

Batches

POST/api/batches/
GET/api/batches/
GET/api/batches/{id}/
PATCH/api/batches/{id}/
DELETE/api/batches/{id}/

Results

GET/api/results/
GET/api/results/{id}/
GET/api/results/export/

Schools & Users

GET/api/auth/me/
POST/api/auth/company/
POST/api/auth/invite/
DELETE/api/auth/members/{id}/

Example — Submit a paper

POST /api/papers/

Request
curl -X POST https://api.e-porikkha.com/api/papers/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "batch": 42,
    "student_name": "Rahim Uddin",
    "roll": "2024-101",
    "text": "প্রশ্ন ১: বাষ্পীভবন হলো..."
  }'
Response 201
{
  "id": 1893,
  "status": "GRADED",
  "student_name": "Rahim Uddin",
  "roll": "2024-101",
  "total_marks": 78,
  "percentage": 78.0,
  "grade": "A",
  "questions": [
    {
      "number": 1,
      "awarded": 8,
      "max": 10,
      "confidence": 0.91,
      "flagged": false,
      "rationale": "Answer covers the key concept..."
    }
  ]
}
Need help with integration?

Email us at hello@e-porikkha.com — we can help set up your first API call.

DocsContact us