Mailgen API Documentation

Use your API key to access balance, services, orders and order details.

Base URL https://mailgen.uk/api.php

Authentication: include apikey in every request. Keep this key private and do not expose it in client-side code.

GET

Get balance

https://mailgen.uk/api.php?action=get-balance&apikey=YOUR_API_KEY

Parameter	Required	Description
`apikey`	Yes	Your Mailgen API key.

Response

{
    "code": 0,
    "message": "success",
    "balance": 99000
}

GET/POST

Read OTP from mailbox

https://mailgen.uk/api.php?action=read-otp&apikey=YOUR_API_KEY&raw_mail=EMAIL%7CPASS%7CREFRESH_TOKEN%7CCLIENT_ID

Parameter	Required	Description
`apikey`	Yes	Your Mailgen API key.
`raw_mail`	Yes	One or more lines in the format `email\|pass\|refresh_token\|client_id`. Separate multiple mailboxes with a newline. Maximum 10 mailboxes per request.

Filtering: only OTP codes from supported apps and social services are returned. Codes from unrelated newsletters, rewards, payments, and notifications are left blank.

Response

{
    "code": 0,
    "message": "success",
    "otp": "123456",
    "mailboxes": [{
        "email": "[email protected]",
        "status": true,
        "messages": [{
            "stt": 1,
            "from": "[email protected]",
            "code": "123456"
        }]
    }]
}

GET

List services

https://mailgen.uk/api.php?action=get-services&apikey=YOUR_API_KEY

Parameter	Required	Description
`apikey`	Yes	Your Mailgen API key.

Response

{
    "code": 0,
    "message": "success",
    "data": [{
        "service_id": 1,
        "service_name": "Service name",
        "price": "1000",
        "description": "Service description",
        "quantity": 15
    }]
}

GET

Create order

https://mailgen.uk/api.php?action=create-order&apikey=YOUR_API_KEY&service_id=1&amount=1

Parameter	Required	Description
`apikey`	Yes	Your Mailgen API key.
`service_id`	Yes	Service ID returned by `get-services`.
`amount`	Yes	Quantity to purchase.

Response

{
    "code": 200,
    "data": ["product data"],
    "message": "Order created successfully",
    "order_id": 2
}

GET

Get order detail

https://mailgen.uk/api.php?action=get-order-detail&apikey=YOUR_API_KEY&order_id=2

Parameter	Required	Description
`apikey`	Yes	Your Mailgen API key.
`order_id`	Yes	Order ID returned after purchase.

Response

{
    "code": 0,
    "message": "success",
    "order": {
        "order_id": 2,
        "amount": 1,
        "status": 1,
        "price": 1000,
        "data": ["product data"]
    }
}

GET

List all orders

https://mailgen.uk/api.php?action=get-orders&apikey=YOUR_API_KEY

Parameter	Required	Description
`apikey`	Yes	Your Mailgen API key.

Response

{
    "code": 0,
    "message": "success",
    "orders": []
}