Documentación de la API

Integra direcciones de correo desechables en tus aplicaciones y flujos de trabajo

https://dustmail.net/api/v1

🔑 Autenticación

Todas las solicitudes a la API requieren una clave API. Envía tu clave mediante el encabezado Authorization o el encabezado X-API-Key .

Genera claves API desde tu Panel. Cada clave comienza por dm_live_.

bash

# Using Authorization header (recommended)
curl https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_your_api_key"

# Using X-API-Key header
curl https://dustmail.net/api/v1/inbox \
  -H "X-API-Key: dm_live_your_api_key"

Límites de uso

Gratis

100

solicitudes / día

Premium

∞

ilimitado

POST/api/v1/inbox

Crea una nueva bandeja de correo temporal. Devuelve los detalles de la bandeja, incluida la dirección generada y la hora de vencimiento. Las claves Premium también pueden solicitar un nombre de usuario personalizado, elegir dominios compartidos configurados o seleccionar dominios personalizados verificados que pertenezcan al usuario Premium después de la verificación DNS TXT + MX.

Cuerpo de la solicitud

Parámetro	Tipo	Descripción
usernameopcional	string	Nombre de usuario personalizado para la dirección de correo. Requiere una clave API Premium.
domainopcional	string	Dominio solicitado para la bandeja. Las claves gratuitas usan el dominio compartido principal, mientras que las Premium pueden elegir dominios compartidos configurados o dominios personalizados verificados del propietario de la clave API.

Ejemplo

bash

curl -X POST https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"swift.fox4291","domain":"brand.example"}'

Respuesta

json

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "[email protected]",
    "domain": "brand.example",
    "created_at": "2026-03-30T12:00:00.000Z",
    "expires_at": "2027-03-30T12:00:00.000Z"
  },
  "meta": {
    "plan": "premium",
    "rate_limit": { "limit": null, "used": 1 },
    "available_domains": ["dustmail.net", "<configured-shared-domain>", "brand.example"]
  }
}

GET/api/v1/inbox

Enumera todas las bandejas activas asociadas con tu cuenta. Devuelve hasta 50 bandejas con sus recuentos de correo.

Ejemplo

bash

curl https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_your_api_key"

Respuesta

json

{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-...",
      "email": "[email protected]",
      "domain": "dustmail.net",
      "created_at": "2026-03-30T12:00:00.000Z",
      "expires_at": "2026-03-30T12:30:00.000Z",
      "email_count": 3
    }
  ],
  "meta": {
    "total": 1,
    "plan": "free",
    "rate_limit": { "limit": 100, "used": 2 }
  }
}

GET/api/v1/inbox/:id

Obtiene los detalles de la bandeja y todos los correos recibidos. Devuelve hasta 100 correos más recientes con contenido completo (texto y HTML).

Parámetros de ruta

Parámetro	Tipo	Descripción
idobligatorio	uuid	El ID de la bandeja devuelto al crearla

Ejemplo

bash

curl https://dustmail.net/api/v1/inbox/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer dm_live_your_api_key"

Respuesta

json

{
  "success": true,
  "data": {
    "inbox": {
      "id": "a1b2c3d4-...",
      "email": "[email protected]",
      "domain": "dustmail.net",
      "created_at": "2026-03-30T12:00:00.000Z",
      "expires_at": "2026-03-30T12:30:00.000Z"
    },
    "emails": [
      {
        "id": "e1f2a3b4-...",
        "from": "[email protected]",
        "subject": "Verify your email address",
        "text": "Click the link below to verify...",
        "html": "<html>...</html>",
        "received_at": "2026-03-30T12:05:30.000Z"
      }
    ]
  },
  "meta": {
    "email_count": 1,
    "rate_limit": { "limit": 100, "used": 3 }
  }
}

Ejemplos de código

javascript

// Node.js / JavaScript
const response = await fetch(
  'https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID',
  { headers: { 'Authorization': 'Bearer dm_live_your_api_key' } }
);
const { data } = await response.json();
console.log(data.emails); // Array of received emails

python

# Python
import requests

resp = requests.get(
    "https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID",
    headers={"Authorization": "Bearer dm_live_your_api_key"}
)
emails = resp.json()["data"]["emails"]
print(f"Received {len(emails)} emails")

DELETE/api/v1/inbox/:id

Elimina (desactiva) una bandeja. Solo puedes eliminar bandejas que pertenezcan a tu cuenta. La API dejará de devolver la bandeja después de eliminarla.

Ejemplo

bash

curl -X DELETE https://dustmail.net/api/v1/inbox/a1b2c3d4-... \
  -H "Authorization: Bearer dm_live_your_api_key"

Respuesta

json

{
  "success": true,
  "message": "Inbox deleted"
}