{"components":{"securitySchemes":{"inboxToken":{"description":"The token from createInbox. Issued anonymously; no registration.","scheme":"bearer","type":"http"}}},"info":{"contact":{"url":"https://dev-mail.com/docs/api"},"description":"Free, no account, no API key. Create an inbox, poll it, read the one-time code. Reads are idempotent: polling never consumes messages.","summary":"Disposable inboxes for verification codes and test mail.","title":"Dev-Mail open API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v1/domains":{"get":{"operationId":"listDomains","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"domains":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Domain list"},"429":{"description":"Rate limited; see Retry-After"}},"security":[],"summary":"List the public receiving domains"}},"/v1/inboxes":{"post":{"operationId":"createInbox","requestBody":{"content":{"application/json":{"schema":{"properties":{"domain":{"description":"Optional. Random when omitted.","enum":["diyapn.com","winmail.cfd","mailcom.top","i-os.top","kingshould.com","nicepl.com","aeria-mall.com"],"type":"string"},"style":{"enum":["american","chinese","japanese"],"type":"string"}},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"address":{"type":"string"},"expires_at":{"format":"date-time","type":"string"},"token":{"description":"Bearer token for the other endpoints","type":"string"},"ttl_seconds":{"type":"integer"}},"type":"object"}}},"description":"The new inbox"},"429":{"description":"Rate limited; see Retry-After"}},"security":[],"summary":"Create a disposable inbox"}},"/v1/inboxes/{address}/code":{"get":{"operationId":"getVerificationCode","parameters":[{"description":"The address returned by createInbox","in":"path","name":"address","required":true,"schema":{"type":"string"}},{"description":"Seconds to long-poll for a code, 0-60","in":"query","name":"wait","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"type":"string"},"found":{"type":"boolean"},"from":{"type":"string"},"received_at":{"format":"date-time","type":"string"},"subject":{"type":"string"}},"type":"object"}}},"description":"The code, when one has arrived"},"429":{"description":"Rate limited; see Retry-After"}},"summary":"Extract the newest one-time code, optionally long-polling for it"}},"/v1/inboxes/{address}/messages":{"get":{"operationId":"listMessages","parameters":[{"description":"The address returned by createInbox","in":"path","name":"address","required":true,"schema":{"type":"string"}},{"description":"Only messages received after this unix timestamp","in":"query","name":"since","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"address":{"type":"string"},"count":{"type":"integer"},"messages":{"items":{"properties":{"body":{"description":"Original body, usually HTML","type":"string"},"body_text":{"description":"Body flattened to plain text","type":"string"},"from":{"type":"string"},"from_address":{"type":"string"},"id":{"type":"integer"},"received_at":{"format":"date-time","type":"string"},"received_ts":{"type":"integer"},"subject":{"type":"string"},"to":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"Messages"},"429":{"description":"Rate limited; see Retry-After"}},"summary":"List messages; safe to poll, never consumes"}}},"security":[{"inboxToken":[]}],"servers":[{"url":"https://dev-mail.com"}]}