---
title: "Temp email check"
full: true
_openapi:
  method: POST
  toc: []
  structuredData:
    headings: []
    contents:
      - content: "Reports whether an email address or bare domain is disposable, a role address, or from a free consumer provider. Public and unauthenticated; rate limited per IP. Nothing is stored."
_apiData:
  document: "https://reloop.sh/api/tools/openapi/json"
  operationData: [{"path":"/api/tools/v1/temp-email-checker","method":"post"}]
  parameterList: [{"name":"email","type":"string","required":true,"description":"An email address or a bare domain.","location":"body","minLength":1,"maxLength":400,"example":"you@mailinator.com"}]
  responseMap: {"200":{"description":"Response for status 200","schema":{"input":"example_input","kind":"email","domain":"send.example.com","unicodeDomain":"example_unicodeDomain","verdict":"invalid","isValidSyntax":true,"syntaxFailure":"example_syntaxFailure","isDisposable":true,"disposableMatch":{"kind":"exact","domain":"send.example.com","pattern":"example_pattern"},"isAllowlisted":true,"isRoleAddress":true,"isFreeProvider":true,"signals":{"syntax":"pass","disposable":"pass","role":"pass","freeProvider":"pass"},"mxRecords":["example_mxRecords"],"confidence":0,"riskScore":0,"flags":["INVALID_SYNTAX"]}},"400":{"description":"Response for status 400","schema":{"message":"Contact already exists","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead.","link":"https://reloop.sh/docs/api/contacts"}},"429":{"description":"Response for status 429","schema":{"message":"Contact already exists","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead.","link":"https://reloop.sh/docs/api/contacts"}}}
  codeSamples: [{"id":"curl","lang":"bash","label":"cURL","source":"curl -X POST https://reloop.sh/api/tools/v1/temp-email-checker \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@mailinator.com\"}'"},{"id":"node","lang":"javascript","label":"Node.js","source":"// No SDK, no API key — it is a plain POST.\nconst res = await fetch(\n  \"https://reloop.sh/api/tools/v1/temp-email-checker\",\n  {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({ email: \"you@mailinator.com\" }),\n  },\n);\n\nconst result = await res.json();"},{"id":"python","lang":"python","label":"Python","source":"# pip install requests\nimport requests\n\nresult = requests.post(\n    \"https://reloop.sh/api/tools/v1/temp-email-checker\",\n    json={\"email\": \"you@mailinator.com\"},\n).json()"},{"id":"go","lang":"go","label":"Go","source":"body, _ := json.Marshal(map[string]string{\n    \"email\": \"you@mailinator.com\",\n})\n\nres, err := http.Post(\n    \"https://reloop.sh/api/tools/v1/temp-email-checker\",\n    \"application/json\",\n    bytes.NewReader(body),\n)"}]
---
> For the complete documentation index, see [llms-docs.txt](/llms-docs.txt) or the site index [llms.txt](/llms.txt). Full docs corpus: [llms-full-docs.txt](/llms-full-docs.txt). Prefer markdown URLs (append `.md`) for agent consumption. Product skill: [skill.md](/skill.md).


{/* This file was generated by the OpenAPI doc generator. Do not edit this file directly. Run `bun run generate:api-docs` to regenerate. */}

<APIPage />
