ILHAM AUSTRALIA™

ILHAM API Documentation

Build with ILHAM APIs.

Connect your applications to ILHAM services through simple, reliable APIs built for email validation, AI and business automation.

API Documentation

ILHAM Developer APIs

ILHAM provides APIs that allow developers to integrate individual ILHAM services directly into their own websites, applications and backend systems.

The documentation currently covers three API services: IEV for email validation, IUC for ILHAM services and BOTing for AI-powered enquiry and conversation workflows.

ILHAM Email Validation

IEV API

IEV, ILHAM Email Validation, provides backend email validation for applications that need more than a basic email-format check.

IEV can return individual validation signals covering email syntax, overall validity, MX records, BIMI, disposable providers, blacklist information and sender risk.

API endpoint

POSThttps://api.ilham.au/email/

Backend cURL request

IEV can be called from your backend using a standard HTTP POST request. Keep your API key on the server and do not expose it in frontend JavaScript.

PHP / cURLPOST
$email = '[email protected]';
$apiKey = 'YOUR_API_KEY';

$ch = curl_init('https://api.ilham.au/email/');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $apiKey
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'email' => $email
    ])
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new Exception(curl_error($ch));
}

curl_close($ch);

$result = json_decode($response, true);

API authentication

Authentication is performed using an API key. API keys should be kept private and used from your backend server.

1
Open your ILHAM ConsoleSign in to your ILHAM Console.
2
Open API KeysGo to API Keys and select Create New Key.
3
Select IEVSelect IEV as the service for the new key.
4
Store your key securelyThe key is displayed only once.
Important: API keys do not expire

Your API key does not expire automatically. The secret value is shown only once when the key is created. If you lose the key, delete it and create a new one.

Response

A successful IEV response returns individual validation signals. Your application can use these values to determine how it wants to handle an email address.

JSONResponse
{
    "email": "[email protected]",

    "syntax": false,
    "valid": false,
    "mx": false,

    "bimi": false,
    "logo": null,
    "issuer": null,

    "disposable": false,

    "blacklisted": null,
    "reason": null,

    "risk": "low"
}

Response fields

FieldTypeDescription
emailstringThe email address submitted for validation.
syntaxbooleanIndicates whether the email format is valid.
validbooleanThe overall validation result.
mxbooleanIndicates whether the domain has valid MX records.
bimibooleanIndicates whether a BIMI record was detected.
logostring / nullBIMI logo information when available.
issuerstring / nullBIMI certificate issuer when available.
disposablebooleanIndicates whether the address belongs to a detected disposable email provider.
blacklistedboolean / nullOverall blacklist status.
reasonstring / nullProvides the reason associated with a blacklist or risk result when available.
riskstringRisk level returned by IEV: low, medium or high.

Risk and sender intelligence

IEV can also identify signals associated with domains involved in known NSFW or malware activity, as well as email addresses or senders associated with known spam, scam, junk or phishing activity.

These signals contribute to the information returned by the API and can be used by your application as part of its own acceptance or rejection rules.

ILHAM API

IUC API

IUC provides API access to ILHAM services and functionality for applications that need to communicate with the ILHAM platform programmatically.

Detailed IUC endpoints, authentication requirements, request parameters and response structures will be added to this documentation.

Documentation coming soon

IUC API endpoint and response documentation will be published here.

AI API

BOTing API

BOTing provides API-based access to ILHAM's AI conversation and enquiry-collection capabilities.

BOTing can be integrated into websites and applications that need an AI-powered interface for collecting project, contact or enquiry information.

Documentation coming soon

BOTing API authentication, endpoints, request parameters, responses and integration examples will be added here.

Legal & Usage

Terms & policies

Use of ILHAM APIs is subject to the applicable ILHAM terms, privacy requirements and API usage and limits policies.