TempMailg API-Dokumentation

REST-API v1 & Webhooks

TempMailg Entwickler-API-Dokumentation

Verwenden Sie diese Dokumentation, um Ihren persönlichen API-Schlüssel zu generieren, den dedizierten Benutzer-API-Host zu verbinden, Postfachnachrichten zu lesen, eigene Postfächer zu verwalten und Temp Mail in Ihre eigenen Apps oder Automatisierungen zu integrieren.

Bearer-Token-Authentifizierung Echtzeit-Webhooks Gmail & Outlook Aliase JSON-Antworten
Benutzer-API-Basis-URL HTTPS
Anforderungsformat Verwenden Sie Ihren API-Schlüssel nur im Authorization Bearer Header und halten Sie die Endpunkt-URLs sauber.

Postfachverwaltung

Erlaubte Domains abrufen, Postfächer erstellen oder wechseln, zulässige Laufzeiten auswählen und eigene Adressen löschen.

GET https://v1.tempmailg.com/api/domains?type={type}
#

Erlaubte Domains auflisten

Liste verfügbare Domains für die Erstellung temporärer E-Mails auf. Filtere nach Typ, um nur kostenlose, Premium- oder benutzerdefinierte Domains zu sehen, die von deinem Abonnementplan unterstützt werden.

Parameter 1
Parameter Ort Typ Status Beschreibung
type query string optional
Domain-Stufenfilter. Das Weglassen verwendet alle, wenn Premium-Domain-Zugriff aktiviert ist, sonst kostenlos. Anerkannte Werte: free, basic, pro, premium, custom, ultimate, all
Standard: Kontenabhängig
Erhalten Sie zugelassene Domänen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "requested_type": "free",
        "plan": "pro",
        "plan_name": "Pro Plan",
        "allowed_types": [
            "free",
            "basic",
            "pro",
            "premium",
            "custom",
            "ultimate",
            "all"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.requested_type string
Domain-Filter angewendet.
data.plan string
Aktuelles Plan-Tag.
data.plan_name string
Lesbarer Name des aktuellen Plans.
data.allowed_types array<string>
Domainfilter, die für dieses Konto verfügbar sind. Ein erkannter Filter kann dennoch für Ihren Plan gesperrt sein.
data.domains array
Auswählbare Domains nach dem Filtern; ein leeres Array ist gültig.
data.domains[].domain string
Auswählbarer Domainname.
data.domains[].type string
Lesbares Domänen‑Stufen‑Label.
data.domains[].custom boolean
Ob dies eine benutzerdefinierte Domain ist.
POST https://v1.tempmailg.com/api/emails
#

Temporäres Postfach erstellen

Erstellen Sie ein eigenes temporäres Postfach. Lassen Sie Benutzername und Domain für eine zufällige Generierung weg oder geben Sie einen zulässigen benutzerdefinierten Benutzernamen und eine erlaubte Domain an. Der Parameter provider kann die Generierung von Gmail- oder Outlook-Alias auswählen.

Parameter 8
Parameter Ort Typ Status Beschreibung
username body string optional
Optionaler benutzerdefinierter Benutzername: 2 bis 64 ASCII‑Buchstaben, Ziffern, Punkte, Unterstriche oder Bindestriche. Erfordert Planberechtigung; custom_username wird ebenfalls akzeptiert.
Standard: Zufällig generiert
domain body string optional
Einer der erlaubten Domains, die von GET /domains zurückgegeben werden. Das Weglassen wählt eine zufällige erlaubte Domain aus.
Standard: Zufällige erlaubte Domain
lifetime body string optional
erlaubte Werte:
10m — 10 Minuten 1h — 1 Stunde 2h — 2 Stunden 1d — 1 Tag 1w — 1 Woche 1m — 30 Tage 3m — 90 Tage 6m — 180 Tage 1y — 365 Tage unlimited — Unbegrenzt
Standard: Standardlebensdauer des Plans
provider body string optional
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
Standard: standard
pin_enabled body boolean optional
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard: false
pin body string optional
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
pin_confirmation body string optional
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
Idempotency-Key header string optional
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
Optionale Body-Parameter: username (Benutzerdefinierter Benutzername, falls vom Plan erlaubt), domain (erlaubte Domain, z. B. example.com), lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.
Postfach erstellen
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:17:50+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:50+00:00",
        "email_token": "encrypted-email-token"
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.id integer
Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach.
data.pin_protected boolean
Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben.
data.email string
Vollständige Postfachadresse generiert.
data.domain string
Domain des erzeugten Postfachs.
data.provider string
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
data.expire_at string|null
Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach.
data.expires_in_seconds number|null
Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null.
data.mailbox_state string
Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv.
data.receiving_enabled boolean
Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert.
data.message_count integer
Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln.
data.unread_message_count integer
Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln.
data.last_message_received_at string|null
Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar.
data.message_count_synced_at string|null
Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation.
data.created_at string|null
Mailbox-Erstellungszeit im ISO-8601-Format.
data.email_token string
Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung.
data.pin_grant object
Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg.
data.pin_grant.mailbox_id integer
Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist.
data.pin_grant.unlock_token string
Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung.
data.pin_grant.scope string
Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen.
data.pin_grant.idle_timeout_seconds integer
Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden.
data.pin_grant.absolute_timeout_seconds integer
Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden.
data.pin_grant.expires_at string
Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format.
data.pin_grant.absolute_expires_at string
Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Postfach aktualisieren / wechseln

Erstellen oder wählen Sie ein Postfach mit dem neuen Benutzernamen und der Domain, nachdem Sie den Besitz des aktuellen Postfachs verifiziert haben. Dies benennt das alte Postfach nicht um und ändert dessen Lebensdauer nicht. Wenn das Ziel abweicht, bleibt das alte Postfach in der Historie und kann durch aktive-Postfach‑Grenzen pausiert werden. Die Wiederverwendung Ihres eigenen aktiven Ziels wendet dessen angeforderte Lebensdauer oder den Standardplan erneut an.

Parameter 9
Parameter Ort Typ Status Beschreibung
email path string erforderlich
Aktuelle vollständige E-Mail-Adresse des zu wechselnden eigenen Postfachs. URL-codieren Sie jedes Pfadsegment; kodieren Sie ein Pluszeichen als %2B.
username path string erforderlich
Neuer gewünschter Benutzername: 2 bis 64 alphanumerische Zeichen; abhängig von der Berechtigung für benutzerdefinierte Benutzernamen.
domain path string erforderlich
Neuer zulässiger Domainname.
lifetime body string optional
erlaubte Werte:
10m — 10 Minuten 1h — 1 Stunde 2h — 2 Stunden 1d — 1 Tag 1w — 1 Woche 1m — 30 Tage 3m — 90 Tage 6m — 180 Tage 1y — 365 Tage unlimited — Unbegrenzt
Standard: Standardlebensdauer des Plans
pin_enabled body boolean optional
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard: false
pin body string optional
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
pin_confirmation body string optional
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
Idempotency-Key header string optional
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
X-Mailbox-Unlock header string optional
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Verwenden Sie eine vorhandene eigene Postfach-E-Mail in {email}. Optionaler body parameter: lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.
Eigenes Postfach aktualisieren
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:27:50+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:50+00:00",
        "email_token": "encrypted-email-token"
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.id integer
Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach.
data.pin_protected boolean
Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben.
data.email string
Vollständige Postfachadresse generiert.
data.domain string
Domain des erzeugten Postfachs.
data.provider string
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
data.expire_at string|null
Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach.
data.expires_in_seconds number|null
Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null.
data.mailbox_state string
Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv.
data.receiving_enabled boolean
Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert.
data.message_count integer
Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln.
data.unread_message_count integer
Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln.
data.last_message_received_at string|null
Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar.
data.message_count_synced_at string|null
Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation.
data.created_at string|null
Mailbox-Erstellungszeit im ISO-8601-Format.
data.email_token string
Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung.
data.pin_grant object
Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg.
data.pin_grant.mailbox_id integer
Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist.
data.pin_grant.unlock_token string
Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung.
data.pin_grant.scope string
Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen.
data.pin_grant.idle_timeout_seconds integer
Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden.
data.pin_grant.absolute_timeout_seconds integer
Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden.
data.pin_grant.expires_at string
Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format.
data.pin_grant.absolute_expires_at string
Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Postfach löschen

Löschen Sie ein eigenes Postfach und führen Sie dessen Nachrichten- und Dateibereinigung durch. Beibehaltene Postfachdatensätze können intern soft-gelöscht werden; die Adresse ist über die API nicht mehr nutzbar.

Parameter 3
Parameter Ort Typ Status Beschreibung
email path string erforderlich
Vollständige E-Mail-Adresse des zu löschenden eigenen Postfachs. URL-encode die Adresse; encode ein Pluszeichen als %2B.
X-Mailbox-Unlock header string optional
Header, nur geschützte Postfächer: Verwenden Sie das einmalig nutzbare Delete‑unlock_token. Zuerst POST pin, scope=delete und die von der 423‑Antwort zurückgegebene action/target_id an die PIN‑unlock URL. Ein Lese‑Token kann nicht löschen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string optional
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
Eigenes Postfach löschen
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
message string
Ergebnis der Löschung. Eine fehlende Ressource liefert HTTP 404.

Gmail & Outlook Aliase

Erstelle Gmail- und Outlook/Hotmail-Alias-Postfächer mit hoher Reputation.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Gmail-Alias erstellen

Erstellen Sie ein neues temporäres Gmail-Alias-Postfach, das dem authentifizierten Benutzer gehört.

Parameter 8
Parameter Ort Typ Status Beschreibung
mode body string optional
Generierungsmodus: auto, dot, plus oder plus_dot. Akzeptiert außerdem gmail_alias_mode. Wenn die Stilauswahl nicht erlaubt ist, wird auto verwendet.
Standard: auto
username body string optional
Optionaler benutzerdefinierter Alias-Suffix: 2 bis 32 ASCII-Buchstaben oder Ziffern, in Kleinbuchstaben normalisiert; abhängig von der Funktionsberechtigung. Akzeptiert außerdem custom_username oder alias_username.
Standard: Automatisch generiert
domain body string optional
Verwenden Sie zufällig, gmail.com oder googlemail.com; alias_domain wird ebenfalls akzeptiert. Bei Weglassen oder wenn die Domainauswahl nicht verfügbar ist, wird zufällig verwendet.
Standard: random
lifetime body string optional
erlaubte Werte:
10m — 10 Minuten 1h — 1 Stunde 2h — 2 Stunden 1d — 1 Tag 1w — 1 Woche 1m — 30 Tage 3m — 90 Tage 6m — 180 Tage 1y — 365 Tage unlimited — Unbegrenzt
Standard: Standardlebensdauer des Plans
pin_enabled body boolean optional
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard: false
pin body string optional
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
pin_confirmation body string optional
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
Idempotency-Key header string optional
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
Erfordert, dass die Gmail Alias API-Berechtigung in Ihrem Abonnementplan aktiviert ist oder über ein API-Guthaben-Paket freigeschaltet wird. Optionale Parameter: mode (auto, dot, plus, plus_dot), username (Benutzerdefinierter Alias-Benutzername), domain (z. B. gmail.com, googlemail.com), lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.
Gmail-Alias-Postfach erstellen
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:17:50+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:50+00:00",
        "email_token": "encrypted-email-token"
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.id integer
Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach.
data.pin_protected boolean
Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben.
data.email string
Vollständige Postfachadresse generiert.
data.domain string
Domain des erzeugten Postfachs.
data.provider string
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
data.expire_at string|null
Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach.
data.expires_in_seconds number|null
Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null.
data.mailbox_state string
Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv.
data.receiving_enabled boolean
Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert.
data.message_count integer
Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln.
data.unread_message_count integer
Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln.
data.last_message_received_at string|null
Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar.
data.message_count_synced_at string|null
Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation.
data.created_at string|null
Mailbox-Erstellungszeit im ISO-8601-Format.
data.email_token string
Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung.
data.pin_grant object
Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg.
data.pin_grant.mailbox_id integer
Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist.
data.pin_grant.unlock_token string
Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung.
data.pin_grant.scope string
Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen.
data.pin_grant.idle_timeout_seconds integer
Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden.
data.pin_grant.absolute_timeout_seconds integer
Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden.
data.pin_grant.expires_at string
Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format.
data.pin_grant.absolute_expires_at string
Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook-Alias-Domänen

Abrufen aktiver Outlook-/Hotmail-Alias-Domains, die für die Postfachgenerierung verfügbar sind.

Erfordert, dass die Outlook-Alias-API-Berechtigung in Ihrem Abonnementplan aktiviert oder über ein API-Guthaben-Paket freigeschaltet wird. Gibt an, ob die Auswahl einer bestimmten Domain in Ihrem Plan freigeschaltet ist.
Outlook-Alias-Domains abrufen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "domains": [
            {
                "domain": "outlook.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            },
            {
                "domain": "hotmail.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            }
        ]
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.domains array
Aktive Outlook/Hotmail-Domains; ein leeres Array ist gültig.
data.domains[].domain string
Verfügbarer Domainname.
data.domains[].type string
Lesbare Anbieterbezeichnung.
data.domains[].selectable boolean
Ob Ihr Konto diese Domain ausdrücklich auswählen darf.
data.domains[].locked boolean
Ob die explizite Domänenauswahl für Ihr Konto gesperrt ist.
data.domains[].disabled_reason string|null
Grund, warum die Domainauswahl gesperrt ist, oder null, wenn auswählbar.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Outlook-Alias erstellen

Erstellen Sie ein neues Outlook / Hotmail Alias-Temporärpostfach, das dem authentifizierten Benutzer gehört.

Parameter 7
Parameter Ort Typ Status Beschreibung
domain body string optional
Verwenden Sie zufällig oder eine Domain von GET /outlook-alias/domains; outlook_alias_domain wird ebenfalls akzeptiert. Ohne Auswahlberechtigung wird zufällig verwendet.
Standard: Zufällige verfügbare Domain
username body string optional
Optionaler benutzerdefinierter Alias-Suffix: 2 bis 32 ASCII-Buchstaben oder Ziffern, in Kleinbuchstaben normalisiert; abhängig von der Funktionsberechtigung. Akzeptiert außerdem custom_username oder alias_username.
Standard: Automatisch generiert
lifetime body string optional
erlaubte Werte:
10m — 10 Minuten 1h — 1 Stunde 2h — 2 Stunden 1d — 1 Tag 1w — 1 Woche 1m — 30 Tage 3m — 90 Tage 6m — 180 Tage 1y — 365 Tage unlimited — Unbegrenzt
Standard: Standardlebensdauer des Plans
pin_enabled body boolean optional
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard: false
pin body string optional
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
pin_confirmation body string optional
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
Idempotency-Key header string optional
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
Erfordert, dass die Outlook-Alias-API-Berechtigung in Ihrem Abonnementplan aktiviert oder über ein API-Guthaben-Paket freigeschaltet wird. Optionale Parameter: domain (z. B. outlook.com, hotmail.com), username (Benutzerdefinierter Alias-Benutzername), lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.
Outlook-Alias-Postfach erstellen
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:17:50+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:50+00:00",
        "email_token": "encrypted-email-token"
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.id integer
Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach.
data.pin_protected boolean
Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben.
data.email string
Vollständige Postfachadresse generiert.
data.domain string
Domain des erzeugten Postfachs.
data.provider string
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
data.expire_at string|null
Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach.
data.expires_in_seconds number|null
Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null.
data.mailbox_state string
Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv.
data.receiving_enabled boolean
Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert.
data.message_count integer
Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln.
data.unread_message_count integer
Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln.
data.last_message_received_at string|null
Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar.
data.message_count_synced_at string|null
Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation.
data.created_at string|null
Mailbox-Erstellungszeit im ISO-8601-Format.
data.email_token string
Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung.
data.pin_grant object
Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg.
data.pin_grant.mailbox_id integer
Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist.
data.pin_grant.unlock_token string
Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung.
data.pin_grant.scope string
Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen.
data.pin_grant.idle_timeout_seconds integer
Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden.
data.pin_grant.absolute_timeout_seconds integer
Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden.
data.pin_grant.expires_at string
Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format.
data.pin_grant.absolute_expires_at string
Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen.

Nachrichten & Anhänge

Abrufen eingehender Postfächer, vollständige HTML-/Textnachrichten lesen und Anhänge streamen.

GET https://v1.tempmailg.com/api/messages?email={email}
#

Postfachnachrichten auflisten

Rufen Sie verfügbare Nachrichtenübersichten und Postfach-Metadaten ab. Standardmäßige Posteingangs‑Scans geben einen aktuellen Stapel von bis zu 25 Nachrichten zurück; dies ist kein paginiertes Vollverlauf‑Endpunkt. Verwenden Sie GET /messages/{messageId} für vollständige Nachrichteninhalte und Anhänge.

Parameter 2
Parameter Ort Typ Status Beschreibung
email query string erforderlich
Vollständige E-Mail-Adresse des eigenen Postfachs, aus dem Nachrichten gelesen werden sollen. URL-codieren Sie den Abfragewert; codieren Sie ein Pluszeichen als %2B.
X-Mailbox-Unlock header string optional
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Die E‑Mail muss zu Ihrem Konto gehören. Standard‑ und Gmail‑Zusammenfassungen enthalten OTP‑ und verification‑link‑Felder; Outlook enthält außerdem from_name, snippet, received_at und has_attachments. Anbieter‑Synchronisation und Caching können neue Nachrichten und Zähler verzögern.
Postfachnachrichten lesen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:17:50",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:17:50+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:17:50+00:00",
    "message_count_synced_at": "2026-11-19T02:17:50+00:00"
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
mailbox string
Postfachadresse, deren Nachrichten angefordert wurden.
email_token string
Undurchsichtige verschlüsselte Postfachreferenz; normale Authentifizierung ist weiterhin erforderlich.
mailbox_provider string
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
messages array
Nachrichtenzusammenfassungen. Ein leerer Posteingang gibt ein leeres Array zurück; rufen Sie eine einzelne Nachricht für deren Inhalt und Anhänge ab.
expire_at string|null
Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach.
expires_in_seconds number|null
Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null.
mailbox_state string
Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv.
receiving_enabled boolean
Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert.
message_count integer
Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln.
unread_message_count integer
Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln.
last_message_received_at string|null
Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar.
message_count_synced_at string|null
Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation.
mailbox_limit.limit integer
Aktives Postfachlimit für diesen Anbieter; -1 bedeutet unbegrenzt.
mailbox_limit.limit_label string
Anzeigeetikett für das Postfachlimit.
mailbox_limit.active_count integer
Anzahl der aktiven Postfächer für diesen Anbieter.
mailbox_limit.paused_count integer
Anzahl der pausierten Postfächer für diesen Anbieter.
mailbox_limit.paused_mailboxes array<string>
Adressen wurden aufgrund des Postfachlimits pausiert.
mailbox_limit.remaining integer
Verbleibende aktive Postfachplätze; -1 bedeutet unbegrenzt. Dies ist kein API-Anfragekontingent.
mailbox_limit.remaining_label string
Anzeigebezeichnung für verbleibende Postfachplätze.
mailbox_limit.reached boolean
Ob das aktive Postfachlimit erreicht wurde.
mailbox_limit.blocked boolean
Ob das aktive Postfachlimit Null ist.
mailbox_limit.provider string|null
Anbieter, für den das Postfachlimit gilt.
messages[].id string
Undurchsichtige Nachrichten-ID, die von den Endpunkten für Einzelnachrichten, Löschung und Anhang verwendet wird.
messages[].is_seen boolean
Ob die Nachricht als gelesen markiert ist.
messages[].subject string
Nachrichtenthema.
messages[].from string
Anzeigename oder Adresse des Absenders.
messages[].from_email string
Absender-E-Mail-Adresse.
messages[].receivedAt string
Empfangszeit in der Zeitzone der Anwendung, formatiert als YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Erkannte Einmalcode, wenn verfügbar und erlaubt; andernfalls null.
messages[].otp_locked boolean
Ob ein erkannter Einmalcode durch Funktionsberechtigungen verborgen ist.
messages[].verification_link string|null
Erkannte Verifizierungs-URL, wenn verfügbar und erlaubt; andernfalls null.
messages[].verification_link_locked boolean
Ob ein erkannter Verifizierungslink durch Funktionsberechtigungen verborgen ist.
messages[].from_name string|null
Outlook-Zusammenfassungsfeld: Name des ursprünglichen Absenders. Nicht in Standard- und Gmail-Zusammenfassungen enthalten.
messages[].snippet string|null
Outlook‑Zusammenfassungsfeld: Kurze Nachrichtenvorschau.
messages[].received_at string|null
Outlook‑Zusammenfassungsfeld: ISO‑8601‑Empfangszeit, falls bekannt.
messages[].has_attachments boolean
Outlook-Zusammenfassungsfeld: ob Anhang-Metadaten vorhanden sind. Die Verfügbarkeit des Downloads wird separat geprüft.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Einzelne Nachricht abrufen

Rufen Sie eine eigene Nachricht anhand ihrer undurchsichtigen Nachrichten-ID ab. Gibt Body-Formate und Anhangs-Metadaten zurück. Body-Felder hängen vom Nachrichtenformat ab; Outlook fügt die unten aufgeführten anbieterspezifischen Felder hinzu.

Parameter 2
Parameter Ort Typ Status Beschreibung
messageId path string erforderlich
Eindeutige Nachrichten-ID, die in der Nachrichtenliste zurückgegeben wird.
X-Mailbox-Unlock header string optional
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Lesen Sie eine Nachricht
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:17:50",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "html_content": "<p>Hello from the inbox.</p>",
        "text_content": "<pre>Hello from the inbox.</pre>",
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
data.id string
Undurchsichtige Nachrichten-ID.
data.is_seen boolean
Nachrichten-Lesezustand. Das Lesen kann es als gesehen markieren; zwischengespeicherte Daten können einen früheren Zustand widerspiegeln.
data.subject string
Nachrichtenthema.
data.from string
Anzeigename oder Adresse des Absenders.
data.from_email string
Absender-E-Mail-Adresse.
data.to string
Empfängerpostfachadresse.
data.mailbox_provider string
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
data.receivedAt string
Empfangszeit in der Zeitzone der Anwendung, formatiert als YYYY-MM-DD HH:mm:ss.
data.html boolean
Ob die Nachricht einen HTML-Body hat.
data.html_content string
HTML-Body, falls vorhanden. Standardnachrichten ohne HTML können dieses Feld weglassen. Behandeln Sie den Nachrichteninhalt als nicht vertrauenswürdig.
data.text_content string
Textkörper, wenn vorhanden; Standardnachrichten können escaped Text in einem pre-Element enthalten oder dieses Feld weglassen.
data.content string
Bevorzugter Body für die Anzeige, normalerweise HTML, wenn verfügbar.
data.attachments array
Anhangs-Metadaten oder ein leeres Array. Downloads erfordern normale Authentifizierung und anwendbare PIN‑Autorisierung.
data.attachments[].name string
Dateiname, der beim Herunterladen als einzelnes Pfadsegment URL-codiert werden soll.
data.attachments[].size integer
Anhanggröße in Bytes.
data.attachments[].url string
Authentifizierte Benutzer‑API‑Download‑URL zu Anhängen mit einem Dateinamen hinzugefügt. Eine URL garantiert nicht, dass die lokale Datei verfügbar ist.
data.attachments[].extension string
Standard-/Gmail-Metadatenfeld: Dateierweiterung, falls angegeben.
data.attachments[].id string
Outlook-Metadatenfeld: Provider-Anhang-ID.
data.attachments[].content_type string
Outlook-Metadatenfeld: MIME-Inhaltstyp.
data.from_name string|null
Outlook-Detailfeld: Originalabsendername.
data.to_email string|null
Outlook-Detailfeld: ursprüngliche Empfängeradresse.
data.received_at string|null
Outlook-Detailfeld: ISO-8601-Empfangszeit.
data.has_html boolean
Outlook-Detailfeld: ob ein HTML-Body vorhanden ist.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Nachricht löschen

Löschen Sie eine einzelne eigene Nachricht.

Parameter 3
Parameter Ort Typ Status Beschreibung
messageId path string erforderlich
Eindeutige Nachrichten-ID-Zeichenkette zum dauerhaften Löschen.
X-Mailbox-Unlock header string optional
Header, nur geschützte Postfächer: Verwenden Sie das einmalig nutzbare Delete‑unlock_token. Zuerst POST pin, scope=delete und die von der 423‑Antwort zurückgegebene action/target_id an die PIN‑unlock URL. Ein Lese‑Token kann nicht löschen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string optional
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
Eine Nachricht löschen
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Antwortfelder
Feld Typ Beschreibung
status boolean
Ob die Operation erfolgreich war.
message string
Ergebnis der Löschung. Eine fehlende Ressource liefert HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Anhang herunterladen

Einen Anhang von einer eigenen Nachricht herunterladen.

Parameter 3
Parameter Ort Typ Status Beschreibung
messageId path string erforderlich
ID der Nachricht, die die Datei enthält.
filename path string erforderlich
Dateiname und Erweiterung des Anhangs zum Herunterladen.
X-Mailbox-Unlock header string optional
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Bei Erfolg werden Dateibytes zurückgegeben, nicht JSON. Zu große Dateien geben HTTP 403 zurück; fehlende oder nicht verfügbare lokale Dateien geben HTTP 404 zurück. URL-codieren Sie den Dateinamen als einzelnes Pfadsegment. Nur die Metadaten des Anhangs garantieren nicht die Verfügbarkeit des Downloads.
Einen Anhang herunterladen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt
Download-Verhalten Dieser Endpunkt gibt die angeforderte Datei direkt zurück, anstatt eines JSON-Bodys.
Antwortfelder
Feld Typ Beschreibung
Content-Disposition header
Erfolgreiche Antwort lädt den angeforderten Dateinamen herunter.
body binary
Dateibytes bei Erfolg, nicht JSON. Fehler geben JSON mit einem Nicht-2xx-Status zurück.

Ratenlimits & Kontingente

Überwachen Sie Echtzeit-Anfragebudgets, Ratenlimits und Kontingente, ohne Credits zu verbrauchen.

GET https://v1.tempmailg.com/api/rate-limit
#

Ratenbegrenzung & Kontingent

Überprüfen Sie Ihr aktuelles Rate‑Limit und den Kontingentstatus, ohne API‑Nutzung zu verbrauchen. Dieser Endpunkt ist kontingentfrei und zieht keine monatlichen API‑Credits ab (Missbrauchsschutz‑Limit: 60 Anfragen/Min).

X-RateLimit-* beschreibt das angegebene Anforderungsbudget; X-Quota-* beschreibt die monatliche und gekaufte Kapazität, wenn verfügbar. X-Mailbox-RateLimit-* meldet das separate Budget für das Erstellen/Aktualisieren von Postfächern. Eine Ablehnung nur für das Postfach verwendet den Postfachbereich und sein eigenes Wiederholungsfenster. Ablehnungen aufgrund eines Minutenlimits können Quoteninformationen weglassen. Retry-After wird nur für einen zeitlich begrenzten Wiederholungsversuch eingeschlossen; deaktivierter Zugriff kann eine Kontenänderung erfordern. In dieser erfolgreichen Statusantwort beschreiben data.limit, data.remaining und data.reset das Minutenbudget des Kontos, nicht ausgabefähige Credits. Das Objekt data.quota beschreibt das monatliche Kontingent, Guthaben und Nutzung von Credits. Die vorhandenen Felder data.monthly_limit, data.monthly_remaining und data.purchased_credits bleiben Aliase der entsprechenden Quota-Felder. Ein erfolgreicher Status-Check autorisiert keine weitere API-Operation. Operationen erfordern weiterhin aktivierten Zugriff, verfügbares Kontingent und die Zulassung durch alle geltenden Limits. Der Kontingent‑Snapshot garantiert nicht die bereits durch eine laufende Anfrage reservierte Kapazität.
Rate-Limit-Status prüfen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.

Beispielantwort
200 OK • JSON
{
    "status": "success",
    "data": {
        "limit": 60,
        "remaining": 45,
        "reset": 32,
        "plan": "premium",
        "monthly_limit": 50000,
        "monthly_remaining": 48210,
        "purchased_credits": 5000,
        "quota": {
            "enabled": true,
            "user_api_status": true,
            "plan_name": "Premium Plan",
            "period": "2026-10",
            "base_limit": 50000,
            "extra_requests": 0,
            "monthly_limit": 50000,
            "monthly_remaining": 48210,
            "used": 1790,
            "purchased_credits": 5000,
            "bonus_credits": 1000,
            "direct_purchased_credits": 4000,
            "remaining": 53210,
            "unlimited": false,
            "usage_percent": 3,
            "reset_at": "2026-11-01T00:00:00+00:00"
        }
    }
}
Antwortfelder
Feld Typ Beschreibung
data.limit integer|string
Konto-Anfragen-pro-Minute-Limit. Der String unlimited bezeichnet ein unbegrenztes Minutenbudget; dies ist unabhängig vom monatlichen Kontingent.
data.remaining integer|string
Verbleibende Kontominuten-Budgetplätze, oder der String unlimited. Ein positiver Wert bedeutet nicht, dass API-Guthaben verbleiben.
data.reset integer
Sekunden für das Minutenfenster des Kontos, nicht für den monatlichen Kontingent-Reset. Deaktivierte oder unbegrenzte Minutenbudgets können einen nominalen Wert von 60 Sekunden beibehalten; dies garantiert keinen Zugriff nach dem Warten.
data.plan string
Aktuelles Plan-Tag. Der lesbare Planname wird separat in data.quota.plan_name bereitgestellt.
data.quota.enabled boolean
Ob globaler und Plan-/Kredit-API-Zugriff aktiviert ist. Dies gibt keinen Aufschluss über die verbleibende Kapazität und ersetzt nicht den Benutzer‑API‑Schalter.
data.quota.user_api_status boolean
Ob der Benutzer seinen User-API-Schalter aktiviert hat. Vorgänge erfordern diesen Schalter sowie aktivierten Zugriff und verfügbare Kapazität.
data.quota.plan_name string
Lesbarer Name des aktuellen Plans.
data.quota.period string
Kalender-Monats-Nutzungszeitraum im Format YYYY-MM, unter Verwendung der Anwendungszeitzone; nicht unbedingt der Abrechnungszeitraum des Abonnements.
data.quota.base_limit integer
Basis-Monatsplan-Kontingent. Ein Wert von -1 bedeutet unbegrenzt.
data.quota.extra_requests integer
Zusätzliche monatliche Zuteilung für den aktuellen Nutzungszeitraum gewährt; getrennt von gekauften Credits.
data.quota.monthly_limit integer
Grundfreigabe plus zusätzliche Anfragen des aktuellen Zeitraums. Ein Wert von -1 bedeutet unbegrenzt. Gekaufte Credits sind nicht enthalten.
data.quota.monthly_remaining integer|null
Verbleibendes endliches monatliches Kontingent oder null, wenn das monatliche Kontingent unbegrenzt ist. Null darf nicht als Null interpretiert werden.
data.quota.used integer
Erfolgreiche, gezählte API-Operationen im aktuellen Nutzungszeitraum, einschließlich Operationen mit Credits. Statusprüfungen erhöhen diesen Wert nicht.
data.quota.purchased_credits integer
Aktueller Guthabenstand, einschließlich Bonusguthaben des aktiven Plans. Bonusguthaben dürfen diesem Saldo nicht ein zweites Mal hinzugefügt werden.
data.quota.bonus_credits integer
Aktiver Plan-Bonusanteil des Guthabens; eine Aufschlüsselung von purchased_credits, nicht zusätzliche Kapazität.
data.quota.direct_purchased_credits integer
Guthaben ohne den aktiven plan-bonus Teil. Dieser Wert plus bonus_credits entspricht purchased_credits.
data.quota.remaining integer|null
Monatliches Restkontingent plus das aktuelle Guthaben, ohne Bonus doppelt zu zählen. Null bedeutet unbegrenztes monatliches Kontingent. Individuelle Funktionsberechtigungen und andere Anforderungsgrenzen gelten weiterhin.
data.quota.unlimited boolean
Ob das monatliche Kontingent unbegrenzt ist. Dies macht das Minutenbudget des Kontos oder andere Funktionslimits nicht unbegrenzt.
data.quota.usage_percent integer
Dashboard-kompatibler gerundeter Prozentsatz von 0 bis 100: verwendet geteilt durch verwendet plus verbleibend, multipliziert mit 100. Er beinhaltet die verfügbare Kreditkapazität, sodass Aufladen den Prozentsatz senken kann. Er ist 0 für unbegrenztes Kontingent oder einen Pool mit Größe Null; er ist nicht der Minuten‑Rate‑Limit‑Prozentsatz oder eine Zugriffsentscheidung.
data.quota.reset_at string
ISO-8601-Zeitstempel mit Zeitzonenoffset für den nächsten Kalendermonats-Quota-Reset. Dies ist nicht das Ablaufdatum des Abonnements, und der monatliche Reset füllt gekaufte Credits nicht auf.
status string
Der wörtliche Erfolg für diesen Status-Endpunkt. Andere erfolgreiche Postfach-Endpunkte verwenden den booleschen Wert true.
data.monthly_limit integer
Kompatibilitätsalias des entsprechenden data.quota-Feldes; nicht erneut hinzufügen, wenn Salden berechnet werden.
data.monthly_remaining integer|null
Kompatibilitätsalias des entsprechenden data.quota-Feldes; nicht erneut hinzufügen, wenn Salden berechnet werden.
data.purchased_credits integer
Kompatibilitätsalias des entsprechenden data.quota-Feldes; nicht erneut hinzufügen, wenn Salden berechnet werden.

Postfach-PIN-Schutz

Geben Sie die PIN ein, um fortzufahren. Ihr Postfach bleibt entsperrt, solange es in dieser Browsersitzung aktuell ist.

Akzeptieren Sie Cookies?

Wir verwenden Cookies, um Ihr Navigationserlebnis zu verbessern. Durch die Nutzung dieser Seite stimmen Sie unserer Cookie-Richtlinie zu.

Mehr