Skip to main content

API Reference

Complete REST API documentation for EMAP India. Build integrations with our exam management API, webhooks, and official SDKs.

Quick Start

Get started with the EMAP India API in minutes. Our RESTful API uses standard HTTP methods and returns JSON responses.

  1. Get Your API Key

    Generate an API key from your dashboard settings.

  2. Make Your First Request

    Use the API key in the Authorization header.

  3. Handle Responses

    Process JSON responses and handle errors gracefully.

Authentication Example

JavaScript
const response = await fetch(
  'https://api.emapindia.com/v1/centers',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);
const data = await response.json();

API Endpoints

GET/v1/centers

Retrieve all exam centers with filtering & pagination

POST/v1/centers

Create a new exam center record

GET/v1/centers/{id}

Retrieve a specific center by ID

PUT/v1/centers/{id}

Update an existing center record

DELETE/v1/centers/{id}

Delete a center record

GET/v1/exams

List all examinations with status filters

POST/v1/exams

Create a new examination

GET/v1/candidates

Retrieve candidates with filtering & pagination

Official SDKs

Use our official SDKs to integrate EMAP India into your applications with ease.

JavaScript / Node.js

Official SDK with TypeScript support, built-in validation, and automatic retries.

npm install @emapindia/sdk
import { EMAP } from '@emapindia/sdk';

const emap = new EMAP('your-api-key');
const centers = await emap.centers.list({
  state: 'Maharashtra',
  limit: 50
});

Python

Python SDK with async support, comprehensive error handling, and type hints.

pip install emapindia-python
from emapindia import EMAP

emap = EMAP('your-api-key')
centers = emap.centers.list(
    state="Maharashtra",
    limit=50
)

PHP

PHP SDK compatible with modern PHP versions and popular frameworks.

composer require emapindia/php-sdk
use EMAPIndia\Client;

$emap = new Client('your-api-key');
$centers = $emap->centers()->list([
    'state' => 'Maharashtra',
    'limit' => 50
]);

Rate Limits & Security

Rate Limits

Free Plan
100 requests/hour
Pro Plan
1,000 requests/hour
Enterprise
Custom limits

Rate limits are enforced per API key.

Security

  • HTTPS encryption required
  • API key authentication
  • Request signing for webhooks
  • IP whitelisting available

Start Building with Our API

Ready to integrate EMAP India into your application? Get your API key and start building today.