API Documentation

📋 API Overview

Welcome to the ADMA Laboratory Management System API. This documentation provides comprehensive information for frontend developers to integrate with our lab management system.

Base URLs

Response Format

{
  "success": true,
  "data": { ... }
}

// Error Response
{
  "success": false,
  "message": "Error description"
}

🔐 Authentication

Most endpoints require JWT authentication. Include the token in the Authorization header.

Request Example

// Login Request
fetch('/api/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: "lab@example.com",
    password: "password123"
  })
})
.then(res => res.json())
.then(data => {
  const token = data.token;
  // Save token for future requests
});

Using the Token

// All authenticated requests
fetch('/api/test-orders', {
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
})

🏥 Lab Management

Find Nearby Labs - Frontend Example

// Get user's location
navigator.geolocation.getCurrentPosition(async (position) => {
  const { latitude, longitude } = position.coords;
  
  const response = await fetch(
    `/api/labs/nearby?latitude=${latitude}&longitude=${longitude}&radius=10`
  );
  
  const { labs } = await response.json();
  // Display labs on map
});

🧪 Test Orders

Create and manage test orders for patients

Create Test Order - Frontend Example

async function createTestOrder(orderData) {
  const response = await fetch('/api/test-orders', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      patientName: "John Doe",
      patientPhone: "+92-300-1234567",
      patientCnic: "42101-1234567-8",
      labId: 1,
      testType: "blood_test",
      tests: ["CBC", "Blood Glucose"],
      preferredDate: "2026-02-20",
      preferredTime: "10:00 AM"
    })
  });
  
  return await response.json();
}

Order Status Values

📊 Test Results

Get Patient Results - Frontend Example

// Fetch all results for a patient
async function getPatientResults(phoneNumber) {
  const response = await fetch(
    `/api/test-results/patient/${phoneNumber}`,
    {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    }
  );
  
  const { results } = await response.json();
  return results;
}

🔗 Doctor Integration

Integration with ADMA Doctor Backend for seamless test ordering

Doctor Order Flow

// Doctor sends test order from their system
const doctorOrder = {
  doctorId: "DOC001",
  doctorName: "Dr. Sarah Khan",
  hospitalName: "City Hospital",
  patient: {
    patientId: "P001",
    name: "John Doe",
    phone: "+92-300-1234567",
    admaCardNumber: "ADMA123456789"
  },
  labId: 1,
  testType: "blood_test",
  tests: ["CBC", "Liver Function Test"],
  priority: "urgent",
  notes: "Check liver function"
};

🔄 Complete Workflow

⚠️ Error Handling

Error Response Example

{
  "success": false,
  "message": "Invalid credentials"
}