{"openapi":"3.1.0","info":{"title":"MailByGet temporary email API","version":"1.0.0"},"paths":{"/v1/mail/new":{"get":{"summary":"Create a receive-only mailbox with GET","description":"Returns an address, mailbox `id`, expiry, and a `read_token` shown only in the response. Save the token securely. Read the inbox and messages with GET and `Authorization: Bearer <read_token>`; this service never sends mail. To make creation retries idempotent, send both a caller-generated bearer token and an `Idempotency-Key` header.","operationId":"new_mailbox_v1_mail_new_get","parameters":[{"name":"ttl_seconds","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":86400,"minimum":60},{"type":"null"}],"title":"Ttl Seconds"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":253},{"type":"null"}],"title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mail/inbox/{mailbox_id}":{"get":{"summary":"Read a mailbox with GET","description":"Use the mailbox `id` returned by `/v1/mail/new` and send its `read_token` in the `Authorization: Bearer` header. Returns message IDs and summaries; use `/v1/mail/message/{message_id}` to read a message. Tokens never belong in the URL.","operationId":"inbox_v1_mail_inbox__mailbox_id__get","parameters":[{"name":"mailbox_id","in":"path","required":true,"schema":{"type":"string","title":"Mailbox Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"mailboxToken":[]}]}},"/v1/mail/message/{message_id}":{"get":{"summary":"Read one received message with GET","description":"Use a message ID from the inbox response and the same mailbox `read_token` in the `Authorization: Bearer` header. Only the mailbox holder can read the message; expired mailboxes return 404.","operationId":"message_v1_mail_message__message_id__get","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"mailboxToken":[]}]}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"mailboxToken":{"type":"http","scheme":"bearer","description":"Private read_token returned by mailbox creation."}}},"servers":[{"url":"https://mailbyget.com"}]}