Cuentas de correo

Numestri vende buzones listos para usar (Outlook, Hotmail, Gmail y otros) en cantidades de 1 a 500, con sus credenciales entregadas al instante y guardadas en tu cuenta.

Productos

La lista de productos es pública: no necesitas clave de API. Sin clave ves los precios de lista públicos; envía tu clave para ver los precios de tu cuenta, que son los que se cobrarán en una compra. Una clave incorrecta se rechaza con 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 es lo que pasas como product; name describe el tipo de buzón. stock_level es una franja aproximada (plenty, limited, …), no una cantidad.

Comprar

Comprar, listar tus cuentas y leer las bandejas de entrada requieren una clave de API.

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": "…" } ]
}

El stock puede agotarse a mitad de un pedido. Recibes lo que había y la diferencia se reembolsa antes de que llegue la respuesta: compara siempre delivered con requested.

Tus cuentas

GET /email/accounts devuelve todas las cuentas que has comprado, con sus credenciales. No caducan.

• Pasa order_id para obtener las cuentas de un pedido.

• Si no, el resultado va paginado: limit (1–200, 200 por defecto) y offset; sigue next_offset hasta que sea null.

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

Leer un buzón

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
  }
}

Un buzón vacío devuelve "message": null, no un error. Consúltalo periódicamente como harías con un pedido de SMS.