Documentation de l’API

Intégrez des adresses e-mail jetables à vos applications et flux de travail

https://dustmail.net/api/v1

🔑 Authentification

Toutes les requêtes API nécessitent une clé API. Transmettez votre clé via l’en-tête Authorization ou l’en-tête X-API-Key .

Générez des clés API depuis votre Tableau de bord. Chaque clé commence par 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"

Limites de débit

Gratuit

100

requêtes / jour

Premium

∞

illimité

POST/api/v1/inbox

Créez une nouvelle boîte e-mail temporaire. Renvoie les détails de la boîte, notamment l’adresse e-mail générée et l’heure d’expiration. Les clés Premium peuvent aussi demander un nom d’utilisateur personnalisé, choisir parmi des domaines partagés configurés ou sélectionner des domaines personnalisés vérifiés appartenant à l’utilisateur Premium après vérification DNS TXT + MX.

Corps de la requête

Paramètre	Type	Description
usernamefacultatif	string	Nom d’utilisateur personnalisé pour l’adresse e-mail. Nécessite une clé API Premium.
domainfacultatif	string	Domaine demandé pour la boîte. Les clés gratuites utilisent le domaine partagé principal, tandis que les clés Premium peuvent sélectionner des domaines partagés configurés ou des domaines personnalisés vérifiés appartenant au propriétaire de la clé API.

Exemple

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

Réponse

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

Liste toutes les boîtes actives associées à votre compte. Renvoie jusqu’à 50 boîtes avec leur nombre d’e-mails.

Exemple

bash

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

Réponse

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

Obtenez les détails de la boîte et tous les e-mails reçus. Renvoie jusqu’à 100 e-mails les plus récents avec le contenu complet (texte et HTML).

Paramètres de chemin

Paramètre	Type	Description
idobligatoire	uuid	L’ID de la boîte renvoyé lors de sa création

Exemple

bash

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

Réponse

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

Exemples de code

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

Supprimez (désactivez) une boîte. Vous ne pouvez supprimer que les boîtes appartenant à votre compte. La boîte ne sera plus renvoyée par l’API après sa suppression.

Exemple

bash

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

Réponse

json

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