TempMailg API-documentatie

REST API v1 & Webhooks

TempMailg Ontwikkelaar API Documentatie

Gebruik deze documentatie om uw persoonlijke API-sleutel te genereren, de toegewezen gebruikers-API-host te verbinden, postbusberichten te lezen, bezette postbus te beheren en Temp Mail te integreren in uw eigen apps of automatiseringen.

Bearer Token-authenticatie Realtime-webhooks Gmail & Outlook-aliasen JSON-reacties
Gebruiker API-basis-URL HTTPS
Aanvraagformaat Gebruik uw API-sleutel alleen in de Autorisatie-Bearer-header en houd endpoint-URL's schoon.

Mailboxbeheer

Haal toegestane domeinen op, maak of wissel mailboxen, kies toegestane levensduur, en verwijder eigen adressen.

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

Lijst van toegestane domeinen

Lijst beschikbare domeinen voor het maken van tijdelijke e‑mailadressen. Filter op type om alleen gratis, premium of aangepaste domeinen te zien die door uw abonnement worden ondersteund.

Parameters 1
Parameter Locatie Type Status Beschrijving
type query string optioneel
Domeinniveau-filter. Bij weglaten wordt alles gebruikt wanneer premium-domeintoegang is ingeschakeld, anders gratis. Herkende waarden: free, basic, pro, premium, custom, ultimate, all
Standaard: Accountafhankelijk
Toegestane domeinen ophalen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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
            }
        ]
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.requested_type string
Toegepast domeinfilter.
data.plan string
Huidige planlabel.
data.plan_name string
Leesbare naam van het huidige plan.
data.allowed_types array<string>
Domeinfilters beschikbaar voor dit account. Een herkend filter kan nog steeds verboden zijn voor uw plan.
data.domains array
Selecteerbare domeinen na filtering; een lege array is geldig.
data.domains[].domain string
Selecteerbare domeinnaam.
data.domains[].type string
Leesbaar domein tier-label.
data.domains[].custom boolean
Of dit een aangepast domein is.
POST https://v1.tempmailg.com/api/emails
#

Tijdelijk postvak aanmaken

Maak een eigen tijdelijk postvak. Laat gebruikersnaam en domein weg voor willekeurige generatie, of lever een toegestane aangepaste gebruikersnaam en een toegestaan domein. De provider-parameter kan Gmail of Outlook aliasgeneratie selecteren.

Parameters 8
Parameter Locatie Type Status Beschrijving
username body string optioneel
Optionele aangepaste gebruikersnaam: 2 tot 64 ASCII-letters, cijfers, punten, onderstrepingen of koppeltekens. Vereist planpermissie; custom_username wordt ook geaccepteerd.
Standaard: Willekeurig gegenereerd
domain body string optioneel
Een van de toegestane domeinen die worden geretourneerd door GET /domains. Weglaten kiest een willekeurig toegestaan domein.
Standaard: Willekeurig toegestaan domein
lifetime body string optioneel
toegestane waarden:
10m — 10 Minuten 1h — 1 Uur 2h — 2 uur 1d — 1 dag 1w — 1 Week 1m — 30 dagen 3m — 90 dagen 6m — 180 dagen 1y — 365 dagen unlimited — Onbeperkt
Standaard: Standaard levensduur van het plan
provider body string optioneel
Postvakprovider: standard, gmail_alias, of outlook_alias.
Standaard: standard
pin_enabled body boolean optioneel
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard: false
pin body string optioneel
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
pin_confirmation body string optioneel
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
Idempotency-Key header string optioneel
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
Optionele body-parameters: username (aangepaste gebruikersnaam indien toegestaan door het abonnement), domain (toegestane domein, bijv. example.com), lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.
Mailbox aanmaken
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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:18:09+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:18:09+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.id integer
Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox.
data.pin_protected boolean
Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd.
data.email string
Volledig mailboxadres gegenereerd.
data.domain string
Domein van de gegenereerde mailbox.
data.provider string
Postvakprovider: standard, gmail_alias, of outlook_alias.
data.expire_at string|null
Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox.
data.expires_in_seconds number|null
Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul.
data.mailbox_state string
Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief.
data.receiving_enabled boolean
Of deze mailbox momenteel inkomende berichten accepteert.
data.message_count integer
Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen.
data.unread_message_count integer
Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven.
data.last_message_received_at string|null
Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar.
data.message_count_synced_at string|null
Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie.
data.created_at string|null
Mailboxcreatietijd in ISO-8601-formaat.
data.email_token string
Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie.
data.pin_grant object
Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg.
data.pin_grant.mailbox_id integer
Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld.
data.pin_grant.unlock_token string
Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering.
data.pin_grant.scope string
De scope lezen voor de voorwaardelijke creatietoekenning.
data.pin_grant.idle_timeout_seconds integer
Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden.
data.pin_grant.absolute_timeout_seconds integer
Maximum levensduur van de leesmachtiging, normaal 86400 seconden.
data.pin_grant.expires_at string
Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat.
data.pin_grant.absolute_expires_at string
Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Bijwerken / Wissel mailbox

Maak een mailbox aan of selecteer er een op de nieuwe gebruikersnaam en domein nadat u het eigendom van de huidige mailbox heeft geverifieerd. Dit hernoemt de oude mailbox niet en wijzigt de levensduur ervan niet op dezelfde plaats. Wanneer de bestemming verschilt, blijft de oude mailbox in de geschiedenis en kan deze worden gepauzeerd door limieten voor actieve mailboxen. Het hergebruiken van uw eigen actieve bestemming past de gevraagde levensduur of de standaardinstelling van het abonnement opnieuw toe.

Parameters 9
Parameter Locatie Type Status Beschrijving
email path string verplicht
Huidig volledig e-mailadres van de eigendom mailbox om te wisselen. URL-encode elk padsegment; codeer een plusteken als %2B.
username path string verplicht
Nieuwe gewenste gebruikersnaam: 2 tot 64 alfanumerieke tekens; onderhevig aan toestemming voor aangepaste gebruikersnaam.
domain path string verplicht
Nieuwe toegestane domeinnaam.
lifetime body string optioneel
toegestane waarden:
10m — 10 Minuten 1h — 1 Uur 2h — 2 uur 1d — 1 dag 1w — 1 Week 1m — 30 dagen 3m — 90 dagen 6m — 180 dagen 1y — 365 dagen unlimited — Onbeperkt
Standaard: Standaard levensduur van het plan
pin_enabled body boolean optioneel
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard: false
pin body string optioneel
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
pin_confirmation body string optioneel
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
Idempotency-Key header string optioneel
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
X-Mailbox-Unlock header string optioneel
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Gebruik een bestaand eigendomsmailbox-e-mailadres in {email}. Optionele body‑parameter: lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.
Eigendomsmailbox bijwerken
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'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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:28:09+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:18:09+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.id integer
Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox.
data.pin_protected boolean
Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd.
data.email string
Volledig mailboxadres gegenereerd.
data.domain string
Domein van de gegenereerde mailbox.
data.provider string
Postvakprovider: standard, gmail_alias, of outlook_alias.
data.expire_at string|null
Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox.
data.expires_in_seconds number|null
Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul.
data.mailbox_state string
Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief.
data.receiving_enabled boolean
Of deze mailbox momenteel inkomende berichten accepteert.
data.message_count integer
Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen.
data.unread_message_count integer
Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven.
data.last_message_received_at string|null
Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar.
data.message_count_synced_at string|null
Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie.
data.created_at string|null
Mailboxcreatietijd in ISO-8601-formaat.
data.email_token string
Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie.
data.pin_grant object
Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg.
data.pin_grant.mailbox_id integer
Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld.
data.pin_grant.unlock_token string
Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering.
data.pin_grant.scope string
De scope lezen voor de voorwaardelijke creatietoekenning.
data.pin_grant.idle_timeout_seconds integer
Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden.
data.pin_grant.absolute_timeout_seconds integer
Maximum levensduur van de leesmachtiging, normaal 86400 seconden.
data.pin_grant.expires_at string
Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat.
data.pin_grant.absolute_expires_at string
Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Mailbox verwijderen

Verwijder een eigendom mailbox en roep de opschoning van berichten en bestanden op. Behouden mailboxrecords kunnen intern zacht worden verwijderd; het adres is niet langer bruikbaar via de API.

Parameters 3
Parameter Locatie Type Status Beschrijving
email path string verplicht
Volledig e-mailadres van de mailbox die u bezit om te verwijderen. URL-encode het adres; codeer een plusteken als %2B.
X-Mailbox-Unlock header string optioneel
Header, alleen voor beveiligde mailboxen: gebruik de eenmalige delete unlock_token. Eerst POST pin, scope=delete en de action/target_id die wordt geretourneerd door de 423-respons op de PIN unlock URL. Een read token kan niet verwijderen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string optioneel
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
Eigendomsmailbox verwijderen
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
message string
Resultaat van de verwijdering. Een ontbrekende bron geeft HTTP 404 terug.

Gmail & Outlook-aliasen

Genereer aliasmailboxen met een hoge reputatie voor Gmail en Outlook/Hotmail.

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

Gmail-alias maken

Maak een nieuwe tijdelijke Gmail-aliasmailbox aan die eigendom is van de geauthenticeerde gebruiker.

Parameters 8
Parameter Locatie Type Status Beschrijving
mode body string optioneel
Generatiemodus: auto, dot, plus of plus_dot. Accepteert ook gmail_alias_mode. Als stijlselectie niet is toegestaan, wordt auto gebruikt.
Standaard: auto
username body string optioneel
Optionele aangepaste alias-achtervoegsel: 2 tot 32 ASCII-letters of cijfers, genormaliseerd naar kleine letters; onderhevig aan functiepermissie. Accepteert ook custom_username of alias_username.
Standaard: Automatisch gegenereerd
domain body string optioneel
Gebruik willekeurig, gmail.com of googlemail.com; alias_domain wordt ook geaccepteerd. Weglaten of onbeschikbare domein-selectie toestemming gebruikt willekeurig.
Standaard: random
lifetime body string optioneel
toegestane waarden:
10m — 10 Minuten 1h — 1 Uur 2h — 2 uur 1d — 1 dag 1w — 1 Week 1m — 30 dagen 3m — 90 dagen 6m — 180 dagen 1y — 365 dagen unlimited — Onbeperkt
Standaard: Standaard levensduur van het plan
pin_enabled body boolean optioneel
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard: false
pin body string optioneel
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
pin_confirmation body string optioneel
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
Idempotency-Key header string optioneel
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
Vereist dat de Gmail Alias API-machtiging is ingeschakeld op uw abonnementsplan of ontgrendeld via een API Credit-pakket. Optionele parameters: mode (auto, dot, plus, plus_dot), username (aangepaste alias gebruikersnaam), domain (bijv. gmail.com, googlemail.com), lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.
Gmail-aliasmailbox maken
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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:18:09+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:18:09+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.id integer
Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox.
data.pin_protected boolean
Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd.
data.email string
Volledig mailboxadres gegenereerd.
data.domain string
Domein van de gegenereerde mailbox.
data.provider string
Postvakprovider: standard, gmail_alias, of outlook_alias.
data.expire_at string|null
Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox.
data.expires_in_seconds number|null
Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul.
data.mailbox_state string
Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief.
data.receiving_enabled boolean
Of deze mailbox momenteel inkomende berichten accepteert.
data.message_count integer
Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen.
data.unread_message_count integer
Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven.
data.last_message_received_at string|null
Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar.
data.message_count_synced_at string|null
Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie.
data.created_at string|null
Mailboxcreatietijd in ISO-8601-formaat.
data.email_token string
Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie.
data.pin_grant object
Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg.
data.pin_grant.mailbox_id integer
Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld.
data.pin_grant.unlock_token string
Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering.
data.pin_grant.scope string
De scope lezen voor de voorwaardelijke creatietoekenning.
data.pin_grant.idle_timeout_seconds integer
Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden.
data.pin_grant.absolute_timeout_seconds integer
Maximum levensduur van de leesmachtiging, normaal 86400 seconden.
data.pin_grant.expires_at string
Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat.
data.pin_grant.absolute_expires_at string
Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook Aliasdomeinen

Haal actieve Outlook / Hotmail aliasdomeinen op die beschikbaar zijn voor mailboxgeneratie.

Vereist dat de Outlook Alias API-machtiging is ingeschakeld op uw abonnement of ontgrendeld via een API Credit-pakket. Geeft aan of specifieke domeinselectie ontgrendeld is in uw abonnement.
Ophalen Outlook-aliasdomeinen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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
            }
        ]
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.domains array
Actieve Outlook/Hotmail-domeinen; een lege array is geldig.
data.domains[].domain string
Beschikbare domeinnaam.
data.domains[].type string
Leesbaar providerlabel.
data.domains[].selectable boolean
Of uw account deze domein expliciet mag kiezen.
data.domains[].locked boolean
Of expliciete domeinselectie is vergrendeld voor uw account.
data.domains[].disabled_reason string|null
Reden dat domeinselectie vergrendeld is, of null wanneer selecteerbaar.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Outlook-alias maken

Maak een nieuw Outlook / Hotmail-alias tijdelijk mailbox die eigendom is van de geauthenticeerde gebruiker.

Parameters 7
Parameter Locatie Type Status Beschrijving
domain body string optioneel
Gebruik willekeurig of een domein van GET /outlook-alias/domains; outlook_alias_domain wordt ook geaccepteerd. Zonder selectierechten wordt willekeurig gebruikt.
Standaard: Willekeurige beschikbare domein
username body string optioneel
Optionele aangepaste alias-achtervoegsel: 2 tot 32 ASCII-letters of cijfers, genormaliseerd naar kleine letters; onderhevig aan functiepermissie. Accepteert ook custom_username of alias_username.
Standaard: Automatisch gegenereerd
lifetime body string optioneel
toegestane waarden:
10m — 10 Minuten 1h — 1 Uur 2h — 2 uur 1d — 1 dag 1w — 1 Week 1m — 30 dagen 3m — 90 dagen 6m — 180 dagen 1y — 365 dagen unlimited — Onbeperkt
Standaard: Standaard levensduur van het plan
pin_enabled body boolean optioneel
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard: false
pin body string optioneel
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
pin_confirmation body string optioneel
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
Idempotency-Key header string optioneel
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
Vereist dat de Outlook Alias API-machtiging is ingeschakeld op uw abonnement of ontgrendeld via een API Credit-pakket. Optionele parameters: domain (bijv. outlook.com, hotmail.com), username (aangepaste alias gebruikersnaam), lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.
Outlook-aliasmailbox maken
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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:18:09+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:18:09+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.id integer
Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox.
data.pin_protected boolean
Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd.
data.email string
Volledig mailboxadres gegenereerd.
data.domain string
Domein van de gegenereerde mailbox.
data.provider string
Postvakprovider: standard, gmail_alias, of outlook_alias.
data.expire_at string|null
Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox.
data.expires_in_seconds number|null
Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul.
data.mailbox_state string
Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief.
data.receiving_enabled boolean
Of deze mailbox momenteel inkomende berichten accepteert.
data.message_count integer
Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen.
data.unread_message_count integer
Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven.
data.last_message_received_at string|null
Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar.
data.message_count_synced_at string|null
Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie.
data.created_at string|null
Mailboxcreatietijd in ISO-8601-formaat.
data.email_token string
Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie.
data.pin_grant object
Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg.
data.pin_grant.mailbox_id integer
Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld.
data.pin_grant.unlock_token string
Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering.
data.pin_grant.scope string
De scope lezen voor de voorwaardelijke creatietoekenning.
data.pin_grant.idle_timeout_seconds integer
Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden.
data.pin_grant.absolute_timeout_seconds integer
Maximum levensduur van de leesmachtiging, normaal 86400 seconden.
data.pin_grant.expires_at string
Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat.
data.pin_grant.absolute_expires_at string
Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken.

Berichten & Bijlagen

Ophalen van binnenkomende inboxen, volledige HTML-/tekstberichten lezen en bijlagen streamen.

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

Mailboxberichten weergeven

Haal beschikbare berichtsamenvattingen en mailboxmetadata op. Standaard inbox-scans geven een recente batch van maximaal 25 berichten terug; dit is geen gepagineerd endpoint voor volledige geschiedenis. Gebruik GET /messages/{messageId} voor volledige inhoud en bijlagen.

Parameters 2
Parameter Locatie Type Status Beschrijving
email query string verplicht
Volledig e-mailadres van de eigen mailbox om berichten van te lezen. URL-encode de querywaarde; codeer een plusteken als %2B.
X-Mailbox-Unlock header string optioneel
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
De e-mail moet tot uw account behoren. Standaard- en Gmail-samenvattingen bevatten OTP- en verificatielinkvelden; Outlook bevat ook from_name, snippet, received_at en has_attachments. Provider-synchronisatie en caching kunnen nieuwe berichten en tellingen vertragen.
Mailboxberichten lezen
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'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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:18:09",
            "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:18:09+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:18:09+00:00",
    "message_count_synced_at": "2026-11-19T02:18:09+00:00"
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
mailbox string
Postvakadres waarvan de berichten werden opgevraagd.
email_token string
Ondoorzichtige versleutelde mailboxreferentie; normale authenticatie is nog steeds vereist.
mailbox_provider string
Postvakprovider: standard, gmail_alias, of outlook_alias.
messages array
Berichtoverzichten. Een lege inbox geeft een lege array terug; haal een enkel bericht op voor de inhoud en bijlagen.
expire_at string|null
Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox.
expires_in_seconds number|null
Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul.
mailbox_state string
Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief.
receiving_enabled boolean
Of deze mailbox momenteel inkomende berichten accepteert.
message_count integer
Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen.
unread_message_count integer
Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven.
last_message_received_at string|null
Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar.
message_count_synced_at string|null
Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie.
mailbox_limit.limit integer
Actieve mailboxlimiet voor deze provider; -1 betekent onbeperkt.
mailbox_limit.limit_label string
Weergavelabel voor de postvaklimiet.
mailbox_limit.active_count integer
Aantal actieve mailboxen voor deze provider.
mailbox_limit.paused_count integer
Aantal gepauzeerde mailboxen voor deze provider.
mailbox_limit.paused_mailboxes array<string>
Adressen gepauzeerd door de mailboxlimiet.
mailbox_limit.remaining integer
Resterende actieve mailbox slots; -1 betekent onbeperkt. Dit is geen API-verzoekquotum.
mailbox_limit.remaining_label string
Weergavelabel voor resterende mailboxplaatsen.
mailbox_limit.reached boolean
Of de limiet voor actieve mailboxen is bereikt.
mailbox_limit.blocked boolean
Of de actieve postvaklimiet nul is.
mailbox_limit.provider string|null
Provider waarop de mailboxlimiet van toepassing is.
messages[].id string
Ondoorzichtige bericht-ID gebruikt door de single-message-, verwijderings- en bijlage‑eindpunten.
messages[].is_seen boolean
Of het bericht als gelezen is gemarkeerd.
messages[].subject string
Berichtonderwerp.
messages[].from string
Weergavenaam of adres van de afzender.
messages[].from_email string
E‑mailadres van afzender.
messages[].receivedAt string
Ontvangsttijd in de tijdzone van de applicatie, geformatteerd als YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Gedetecteerde eenmalige code wanneer beschikbaar en toegestaan; anders null.
messages[].otp_locked boolean
Of een gedetecteerde eenmalige code verborgen is door functiepermissies.
messages[].verification_link string|null
Gedetecteerde verificatie-URL wanneer beschikbaar en toegestaan; anders null.
messages[].verification_link_locked boolean
Of een gedetecteerde verificatielink verborgen is door functierechten.
messages[].from_name string|null
Outlook-samenvattingsveld: originele afzendernaam. Afwezig in Standaard- en Gmail-samenvattingen.
messages[].snippet string|null
Outlook-samenvattingsveld: korte berichtpreview.
messages[].received_at string|null
Outlook-samenvattingsveld: ISO-8601 ontvangen tijd, indien bekend.
messages[].has_attachments boolean
Outlook-samenvattingsveld: of bijlage-metadata bestaat. Downloadbeschikbaarheid wordt afzonderlijk gecontroleerd.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Enkel bericht ophalen

Haal een eigen bericht op via zijn ondoorzichtige bericht-ID. Retourneert bodyformaten en bijlage‑metadata. Body‑velden zijn afhankelijk van het berichtformaat; Outlook voegt provider‑specifieke velden toe zoals hieronder vermeld.

Parameters 2
Parameter Locatie Type Status Beschrijving
messageId path string verplicht
Unieke bericht-ID geretourneerd in de berichtenlijst.
X-Mailbox-Unlock header string optioneel
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Een bericht lezen
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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:18:09",
        "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"
            }
        ]
    }
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
data.id string
Ondoorzichtig bericht-ID.
data.is_seen boolean
Berichtleesstatus. Lezen kan het als gezien markeren; gecachte gegevens kunnen een eerdere status weergeven.
data.subject string
Berichtonderwerp.
data.from string
Weergavenaam of adres van de afzender.
data.from_email string
E‑mailadres van afzender.
data.to string
Ontvanger mailboxadres.
data.mailbox_provider string
Postvakprovider: standard, gmail_alias, of outlook_alias.
data.receivedAt string
Ontvangsttijd in de tijdzone van de applicatie, geformatteerd als YYYY-MM-DD HH:mm:ss.
data.html boolean
Of het bericht een HTML-body heeft.
data.html_content string
HTML-body wanneer aanwezig. Standaardberichten zonder HTML kunnen dit veld weglaten. Beschouw de berichtinhoud als onbetrouwbaar.
data.text_content string
Tekstinhoud wanneer aanwezig; Standaardberichten kunnen escaped tekst in een pre-element bevatten of dit veld weglaten.
data.content string
Voorkeursinhoud voor weergave, normaal HTML wanneer beschikbaar.
data.attachments array
Bijlage‑metadata, of een lege array. Downloads vereisen normale authenticatie en toepasselijke PIN‑autorisatie.
data.attachments[].name string
Bestandsnaam om te URL-coderen als één padsegment bij het downloaden.
data.attachments[].size integer
Grootte van bijlage in bytes.
data.attachments[].url string
Download-URL van de API voor geverifieerde gebruikers toegevoegd aan bijlagen met een bestandsnaam. Een URL garandeert niet dat het lokale bestand beschikbaar is.
data.attachments[].extension string
Standaard/Gmail-metadataveld: bestandsextensie indien opgegeven.
data.attachments[].id string
Outlook-metadataveld: provider-bijlage-ID.
data.attachments[].content_type string
Outlook-metadataveld: MIME-inhoudstype.
data.from_name string|null
Outlook-detailveld: originele afzendernaam.
data.to_email string|null
Outlook detailveld: origineel ontvangeradres.
data.received_at string|null
Outlook-detailveld: ISO-8601 ontvangen tijd.
data.has_html boolean
Outlook-detailveld: of er een HTML-body bestaat.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Bericht Verwijderen

Een enkel eigendomsbericht verwijderen.

Parameters 3
Parameter Locatie Type Status Beschrijving
messageId path string verplicht
Unieke bericht-ID-tekenreeks om permanent te verwijderen.
X-Mailbox-Unlock header string optioneel
Header, alleen voor beveiligde mailboxen: gebruik de eenmalige delete unlock_token. Eerst POST pin, scope=delete en de action/target_id die wordt geretourneerd door de 423-respons op de PIN unlock URL. Een read token kan niet verwijderen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string optioneel
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
Verwijder één bericht
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Responsvelden
Veld Type Beschrijving
status boolean
Of de bewerking geslaagd is.
message string
Resultaat van de verwijdering. Een ontbrekende bron geeft HTTP 404 terug.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Bijlage downloaden

Download een bijlage van een bericht dat je bezit.

Parameters 3
Parameter Locatie Type Status Beschrijving
messageId path string verplicht
ID van het bericht dat het bestand bevat.
filename path string verplicht
Bestandsnaam en extensie van de bijlage om te downloaden.
X-Mailbox-Unlock header string optioneel
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Succes retourneert bestandsbytes, niet JSON. Te grote bestanden retourneren HTTP 403; ontbrekende of niet-beschikbare lokale bestanden retourneren HTTP 404. URL-encode de bestandsnaam als één padsegment. Alleen metadata van de bijlage garandeert geen downloadbeschikbaarheid.
Download een bijlage
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
Downloadgedrag Dit eindpunt retourneert het aangevraagde bestand rechtstreeks in plaats van een JSON-lichaam.
Responsvelden
Veld Type Beschrijving
Content-Disposition header
Succesvolle respons downloadt de gevraagde bestandsnaam.
body binary
Bestandsbytes bij succes, niet JSON. Fouten retourneren JSON met een niet-2xx status.

Limieten & Quotums

Bewaak real-time aanvraagbudgetten, snelheidslimieten en accountquota zonder credits te verbruiken.

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

Rate Limiet & Quotum

Controleer uw huidige limiet en quotastatus zonder enige API‑gebruik te verbruiken. Dit eindpunt is quotavrij en trekt geen maandelijkse API‑tegoed af (misbruikbeschermingslimiet: 60 verzoeken/min).

X-RateLimit-* beschrijft het aangegeven aanvraagbudget; X-Quota-* beschrijft de maandelijkse en aangeschafte capaciteit wanneer beschikbaar. X-Mailbox-RateLimit-* rapporteert het afzonderlijke mailbox‑aanmaak-/update‑budget. Een alleen‑mailbox‑afwijzing gebruikt de mailbox‑scope en zijn eigen retry‑venster. Minuut‑limiet‑afwijzingen kunnen quota‑informatie weglaten. Retry-After wordt alleen opgenomen voor een getimede retry; uitgeschakelde toegang kan een accountwijziging vereisen. In deze succesvolle statusrespons beschrijven data.limit, data.remaining en data.reset het minuutbudget van het account, niet de besteedbare credits. Het data.quota-object beschrijft de maandelijkse toelage, creditbalansen en gebruik. De bestaande velden data.monthly_limit, data.monthly_remaining en data.purchased_credits blijven aliassen van de overeenkomstige quota-velden. Een succesvolle statuscontrole geeft geen toestemming voor een andere API‑bewerking. Bewerkingen vereisen nog steeds ingeschakelde toegang, beschikbare quota en toelating binnen alle toepasselijke limieten. Het quotum‑momentopname garandeert geen capaciteit die al gereserveerd is door een lopend verzoek.
Controleer limietstatus
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.

Voorbeeldantwoord
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"
        }
    }
}
Responsvelden
Veld Type Beschrijving
data.limit integer|string
Accountverzoeken-per-minuut limiet. De tekenreeks unlimited duidt op een onbeperkt minuutbudget; dit is onafhankelijk van de maandelijkse quota.
data.remaining integer|string
Resterende account minuutbudget slots, of de string unlimited. Een positieve waarde betekent niet dat API-credits overblijven.
data.reset integer
Seconden voor het accountminuutvenster, niet de maandelijkse quotaherstelling. Uitgeschakelde of onbeperkte minuutbudgetten kunnen een nominale waarde van 60 seconden behouden; dit garandeert geen toegang na wachten.
data.plan string
Huidige plan-tag. De leesbare plannaam wordt apart geleverd in data.quota.plan_name.
data.quota.enabled boolean
Of globale en plan/credit API-toegang is ingeschakeld. Dit geeft geen indicatie van resterende capaciteit of vervangt de gebruikers-API-schakelaar.
data.quota.user_api_status boolean
Of de gebruiker hun User API-schakelaar heeft ingeschakeld. Operaties vereisen deze schakelaar evenals ingeschakelde toegang en beschikbare capaciteit.
data.quota.plan_name string
Leesbare naam van het huidige plan.
data.quota.period string
Kalendermaand gebruiksperiode in YYYY-MM formaat, gebruikmakend van de toepassingstijdzone; niet noodzakelijk de factureringsperiode van het abonnement.
data.quota.base_limit integer
Basis maandelijkse plantoewijzing. Een waarde van -1 betekent onbeperkt.
data.quota.extra_requests integer
Extra maandelijkse toelage toegekend voor de huidige gebruiksperiode; gescheiden van gekochte credits.
data.quota.monthly_limit integer
Basisvergoeding plus extra verzoeken van de huidige periode. Een waarde van -1 betekent onbeperkt. Aangeschafte credits zijn niet inbegrepen.
data.quota.monthly_remaining integer|null
Resterende eindige maandelijkse toelage, of null wanneer de maandelijkse quota onbeperkt is. Null mag niet worden geïnterpreteerd als nul.
data.quota.used integer
Succesvolle, getelde API-bewerkingen in de huidige gebruiksperiode, inclusief bewerkingen met credits. Statuscontroles verhogen deze waarde niet.
data.quota.purchased_credits integer
Huidige creditbalans, inclusief bonuscredits van het actieve abonnement. Bonuscredits mogen niet een tweede keer aan deze balans worden toegevoegd.
data.quota.bonus_credits integer
Actief planbonusdeel van het credit saldo; een uitsplitsing van purchased_credits, niet extra capaciteit.
data.quota.direct_purchased_credits integer
Credietsaldo exclusief het actieve plan‑bonusgedeelte. Deze waarde plus bonus_credits is gelijk aan purchased_credits.
data.quota.remaining integer|null
Maandelijks resterende toelage plus het huidige kredietsaldo, zonder bonussen dubbel te tellen. Null betekent onbeperkte maandelijkse quota. Individuele functiepermissies en andere aanvraaglimieten blijven van toepassing.
data.quota.unlimited boolean
Of de maandelijkse quota onbeperkt is. Dit maakt het minutenbudget van het account of andere functielimieten niet onbeperkt.
data.quota.usage_percent integer
Dashboard-compatibel afgerond percentage van 0 tot 100: gebruikt gedeeld door gebruikt plus resterend, vermenigvuldigd met 100. Het omvat beschikbare kredietcapaciteit, dus opladen kan het percentage verlagen. Het is 0 voor onbeperkte quota of een pool van nul grootte; het is niet het minuut‑rate‑limitpercentage of een toegangsbeslissing.
data.quota.reset_at string
ISO-8601-tijdstempel met tijdzone-offset voor de volgende kalendermaand-quota-reset. Dit is niet de vervaldatum van het abonnement, en de maandelijkse reset vult gekochte credits niet bij.
status string
De letterlijke succeswaarde voor dit status‑endpoint. Andere succesvolle mailbox‑endpoints gebruiken de booleaanse true.
data.monthly_limit integer
Compatibiliteitsalias van het overeenkomstige data.quota-veld; voeg het niet opnieuw toe bij het berekenen van saldi.
data.monthly_remaining integer|null
Compatibiliteitsalias van het overeenkomstige data.quota-veld; voeg het niet opnieuw toe bij het berekenen van saldi.
data.purchased_credits integer
Compatibiliteitsalias van het overeenkomstige data.quota-veld; voeg het niet opnieuw toe bij het berekenen van saldi.

Mailbox PIN-bescherming

Voer de PIN in om door te gaan. Uw mailbox blijft ontgrendeld zolang deze actueel is in deze websessie.

Accepteert u cookies?

Wij gebruiken cookies om uw browse-ervaring te verbeteren. Door deze site te gebruiken, stemt u in met ons cookiebeleid.

Meer