API Reference

CryptoMails API Documentation

Integrate verified email account purchasing, wallet deposits and mailbox reading into your workflow. All endpoints return JSON.

Base URL https://cryptomails.world
Authentication: Protected endpoints require an Authorization: Bearer <token> header. Get your token from the login endpoint.

Endpoints

Returns all available products including Hotmail and Outlook account packages with live stock and pricing.

Response

{
  "products": [
    {
      "id": 5,
      "name": "Hotmail TRUSTED [GRAPH API]",
      "category": "hotmail",
      "quality": "trusted",
      "priceUsd": 0.02,
      "stock": 38279,
      "isActive": true
    }
  ]
}

Create a new CryptoMails user account. An email verification code is sent.

Request Body

{
  "email": "user@example.com",
  "username": "myusername",
  "password": "YourPassword123!"
}

Response

{
  "message": "Account created. Please verify your email.",
  "email": "user@example.com"
}

Authenticate with email/username and password. Returns a JWT bearer token (valid 30 days).

Request Body

{
  "identifier": "user@example.com",
  "password": "YourPassword123!"
}

Response

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": "...", "email": "user@example.com", "walletBalance": 25.00 }
}

Returns all orders placed by the authenticated user.

Response

{
  "orders": [
    { "id": "...", "productId": 5, "quantity": 5, "totalPrice": 0.10, "status": "completed" }
  ],
  "total": 1
}

Purchase email accounts using your wallet balance. Delivery is instant once confirmed.

Request Body

{
  "productId": 5,
  "quantity": 10
}

Response

{
  "id": "...", "status": "completed", "quantity": 10, "totalPrice": 0.20
}

Create a crypto payment invoice. Returns a hosted payment URL to send funds.

Request Body

{
  "amount": 10.00,
  "currency": "USDT"
}

Response

{
  "invoiceId": "...",
  "paymentUrl": "https://pay.cryptomus.com/...",
  "amount": 10, "currency": "USDT", "status": "pending"
}

Scan an Outlook/Hotmail mailbox (via OAuth2) and return the latest verification code.

Request Body

{
  "email": "x@outlook.com",
  "refreshToken": "...",
  "clientId": "..."
}

Response

{
  "email": "x@outlook.com",
  "code": "492817"
}

Need help? Open a support ticket — we respond within 2 hours.