Quick Start

Get Started in 5 Minutes

Follow these simple steps to start using KhaleejiAPI in your applications.

1

Create an Account & Get Your API Key

Sign up for a free account to get your API key. You'll get 1,000 free requests per month to start.

Create Free AccountSign In
2

Make Your First API Call

Use our official SDKs or call the REST API directly. All endpoints are available at https://khaleejiapi.dev/api/v1/

Important: REST requests must use the Authorization header with the bearer scheme. Sending the raw key by itself or using x-api-key will return 401 Unauthorized.

Install an SDK (recommended)

bash
# JavaScript / TypeScript
npm install @khaleejiapi/sdk
 
# Python
pip install khaleejiapi

cURL

bash
curl -X GET "https://khaleejiapi.dev/api/v1/email/[email protected]" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"

JavaScript / TypeScript

javascript
// Using fetch (Node.js 18+, Deno, Bun, browsers)
const response = await fetch(
  'https://khaleejiapi.dev/api/v1/email/[email protected]',
  {
    headers: {
      'Authorization': 'Bearer your_api_key_here',
      'Content-Type': 'application/json',
    },
  }
);
 
const data = await response.json();
console.log(data);
// {
//   data: {
//     email: "[email protected]",
//     valid: true,
//     deliverabilityScore: 98,
//     reason: "Valid email address",
//     checks: { syntax: true, disposable: true, mx: true, role: false, freeProvider: false }
//   },
//   meta: { timestamp: "2025-07-01T12:00:00.000Z" }
// }

Python

python
import requests
 
response = requests.get(
    "https://khaleejiapi.dev/api/v1/email/validate",
    params={"email": "[email protected]"},
    headers={"Authorization": "Bearer your_api_key_here"}
)
 
data = response.json()
print(data["data"]["valid"])  # True
3

Explore Available APIs

We offer 26+ APIs for the Middle East — email validation, IP geolocation, VAT calculation, exchange rates, Islamic finance, and more. Browse the full catalog to find what you need.

Browse APIsSDKs & Libraries

Tip: Never expose your API key in client-side code. Always keep it on the server or use environment variables.

4

Monitor API Status

KhaleejiAPI provides two health check endpoints so you can monitor platform availability from your own infrastructure.

GET /api/v1/ping — Unauthenticated liveness

Returns HTTP 200 with { ok: true } instantly — no API key needed. Use this for uptime monitors (UptimeRobot, Freshping) and load-balancer health checks.

bash
curl https://khaleejiapi.dev/api/v1/ping
# → { "ok": true }

GET /api/v1/health — Authenticated diagnostics

Returns a detailed breakdown of platform version, region, uptime, and subsystem status. Requires your API key. Returns HTTP 503 when any subsystem is degraded.

bash
curl https://khaleejiapi.dev/api/v1/health \
  -H "Authorization: Bearer ******"
# → { data: { status: "healthy", version: "1.3.0", checks: { validation: "healthy" } } }

See the Health & Liveness docs for full details and monitoring integration examples.

Next Steps

Authentication

Learn about API keys and security best practices.

Rate Limits

Understand rate limits and how to handle them.

Explore APIs

Explore all APIs available on KhaleejiAPI.

Health & Liveness

Monitor platform status with ping and health endpoints.

SDKs & Libraries

Find SDKs for your preferred programming language.