Email accounts

Numestri sells ready-made mailboxes — Outlook, Hotmail, Gmail and others — in quantities from 1 to 500, with their credentials delivered instantly and kept in your account.

Products

The product list is public: no API key needed. Without a key you see public list prices; send your key to see your account's own prices, which is what a purchase will charge. A wrong key is refused with 403.

curl https://numestri.com/api/v1/email/products

{
  "success": 1,
  "data": [
    { "id": "outlooktrustedgraph", "name": "Outlook Trusted Graph", "price": "0.026", "price_micros": 26000, "in_stock": true, "stock_level": "plenty" },
    { "id": "gmailtrusted2019", "name": "Gmail Trusted 2019", "price": "3.64", "price_micros": 3640000, "in_stock": true, "stock_level": "limited" }
  ]
}

id is what you pass as product; name describes the mailbox type. stock_level is a coarse band (plenty, limited, …), not a count.

Buy

Buying, listing your accounts and reading inboxes need an API key.

curl https://numestri.com/api/v1/email/purchase -H "Authorization: Bearer $NUMESTRI_KEY" \
  -d product=outlooktrustedgraph -d quantity=10

{
  "success": 1,
  "order_id": "K2M4PQ7X",
  "requested": 10,
  "delivered": 7,
  "charged": "0.19",
  "refunded": "0.08",
  "accounts": [ { "email": "…@outlook.com", "password": "…", "refresh_token": "…", "client_id": "…" } ]
}

Stock can run out part-way through an order. You get what there was, and the difference is refunded before the response returns — always compare delivered with requested.

Your accounts

GET /email/accounts returns every account you have bought, with credentials. They do not expire.

• Pass order_id to get one order's accounts.

• Otherwise it is paged: limit (1–200, default 200) and offset; follow next_offset until it is null.

{
  "success": 1,
  "accounts": [ { "id": "acct_…", "order_id": "K2M4PQ7X", "email": "…@outlook.com", "password": "…", "refresh_token": "…", "client_id": "…" } ],
  "next_offset": 200
}

Read a mailbox

curl "https://numestri.com/api/v1/email/inbox?email=jaymond…@outlook.com" -H "Authorization: Bearer $NUMESTRI_KEY"

{
  "success": 1,
  "message": {
    "from": "noreply@service.com",
    "subject": "Your verification code",
    "text": "Your code is 553311",
    "received_at": 1792131600000
  }
}

An empty mailbox returns "message": null — not an error. Poll it the way you would an SMS order.