{
  "openapi": "3.1.0",
  "info": {
    "title": "Zapi — Temp Mail",
    "description": "Every Temp Mail endpoint on Zapi. Rendered catalog: https://zpi.web.id/category/temp-mail",
    "version": "1.0.0",
    "license": {
      "name": "Zapi Terms of Service",
      "url": "https://zpi.web.id/terms"
    }
  },
  "servers": [
    {
      "url": "https://api.zpi.web.id"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    },
    "schemas": {
      "Envelope": {
        "type": "object",
        "required": [
          "status",
          "message"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "success",
              "error"
            ]
          },
          "message": {
            "type": "string"
          },
          "content": {}
        }
      }
    },
    "responses": {
      "Error": {
        "description": "Invalid key, rate limit, or upstream failure",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Envelope"
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "url": "https://zpi.web.id/category/temp-mail/llms.txt"
  },
  "paths": {
    "/v1/temp-mail:guerrillamail/create": {
      "get": {
        "operationId": "temp_mail_guerrillamail_create",
        "summary": "Create",
        "description": "Buat alamat email sekali pakai.",
        "tags": [
          "Guerrilla Mail"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/guerrillamail#reference-create"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "address": "guqttpip@guerrillamailblock.com",
                    "createdAt": "2026-08-07T09:43:34.000Z",
                    "expiresAt": "2026-08-07T10:43:34.000Z",
                    "durationMinutes": 60
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:guerrillamail/inbox/{address}": {
      "get": {
        "operationId": "temp_mail_guerrillamail_inbox",
        "summary": "Inbox",
        "description": "Baca pesan yang masuk ke alamat sekali pakai.",
        "tags": [
          "Guerrilla Mail"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/guerrillamail#reference-inbox"
        },
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The disposable address to read (as returned by create).",
            "schema": {
              "type": "string",
              "example": "aqqifnke@guerrillamailblock.com"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "count": 1,
                    "items": [
                      {
                        "id": "1",
                        "from": "no-reply@guerrillamail.com",
                        "isRead": false,
                        "content": "Dear Random User,\r\n\r\nThank you for using Guerrilla Mail - your temporary email address friend and spam fighter's ally!\r\n\r\nYour disposable email address has been created ready for use.\r\n\r\nEmail: aqqifnke@sharklasers.com\r\n\r\nTips & Notes:\r\n\r\n- You can change this email address! Place your mouse over the Inbox ID at the top of this page and click to edit.\r\n\r\n- Once you change to a new address, the old address will remain available, simply change back to it. (Note: email is kept for 1 hour)\r\n\r\n- Waiting for your mail? There is no need to refresh the page, new emails will be added to the list as they come in.\r\n\r\n- All Emails are deleted after 1 hour.\r\n\r\nClick on the back the \"« Back to inbox\" to go back to the mail list\r\n\r\nThanks,\r\n\r\nGuerrilla Mail Team\r\nhttp://www.guerrillamail.com/\r\n\r\n\"Free to download, but you have to give your email address so they can inevitably attempt to sell you stuff in the future? guerrillamail.com FTW!\"\r\n\r\nConnect with us:\r\nhttps://www.facebook.com/GuerrillaMail\r\nhttps://twitter.com/GuerrillaMail",
                        "preview": "Dear Random User,\r\n\r\nThank you for using Guerrilla Mail - your temporary email address friend and spam fighter's ally!\r\n\r\nYour disposable email address has been created ready for use.\r\n\r\nEmail: aqqifn",
                        "subject": "Welcome to Guerrilla Mail"
                      }
                    ],
                    "address": "aqqifnke@guerrillamailblock.com"
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:mail-gw/create": {
      "get": {
        "operationId": "temp_mail_mail_gw_create",
        "summary": "Create",
        "description": "Buat alamat email sekali pakai.",
        "tags": [
          "Mail.gw"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/mail-gw#reference-create"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "address": "zp1j6c673t1v4y@oakon.com",
                    "createdAt": "2026-08-07T09:43:38+00:00",
                    "expiresAt": "2026-08-15T17:43:38+00:00",
                    "durationMinutes": 12000
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:mail-gw/inbox/{address}": {
      "get": {
        "operationId": "temp_mail_mail_gw_inbox",
        "summary": "Inbox",
        "description": "Baca pesan yang masuk ke alamat sekali pakai.",
        "tags": [
          "Mail.gw"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/mail-gw#reference-inbox"
        },
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The disposable address to read (as returned by create).",
            "schema": {
              "type": "string",
              "example": "zpmsiqmzvdk@oakon.com"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "count": 0,
                    "items": [],
                    "address": "zp1j6c673t1v4y@oakon.com"
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:mail-tm/create": {
      "get": {
        "operationId": "temp_mail_mail_tm_create",
        "summary": "Create",
        "description": "Buat alamat email sekali pakai.",
        "tags": [
          "Mail.tm"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/mail-tm#reference-create"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "address": "zp3e571w4m19g3@web-library.net",
                    "createdAt": "2026-08-07T09:43:41+00:00",
                    "expiresAt": null,
                    "durationMinutes": null
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:mail-tm/inbox/{address}": {
      "get": {
        "operationId": "temp_mail_mail_tm_inbox",
        "summary": "Inbox",
        "description": "Baca pesan yang masuk ke alamat sekali pakai.",
        "tags": [
          "Mail.tm"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/mail-tm#reference-inbox"
        },
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The disposable address to read (as returned by create).",
            "schema": {
              "type": "string",
              "example": "zpmsiql0ukq@web-library.net"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "count": 0,
                    "items": [],
                    "address": "zp3e571w4m19g3@web-library.net"
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:temp-mail-io/create": {
      "get": {
        "operationId": "temp_mail_temp_mail_io_create",
        "summary": "Create",
        "description": "Buat alamat email sekali pakai.",
        "tags": [
          "Temp-Mail.io"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/temp-mail-io#reference-create"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "address": "jkh13oxzfk@yzcalo.com",
                    "createdAt": "2026-08-07T09:43:45.926Z",
                    "expiresAt": null,
                    "durationMinutes": null
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:temp-mail-io/inbox/{address}": {
      "get": {
        "operationId": "temp_mail_temp_mail_io_inbox",
        "summary": "Inbox",
        "description": "Baca pesan yang masuk ke alamat sekali pakai.",
        "tags": [
          "Temp-Mail.io"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/temp-mail-io#reference-inbox"
        },
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The disposable address to read (as returned by create).",
            "schema": {
              "type": "string",
              "example": "7akk435stz@olipii.com"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "count": 0,
                    "items": [],
                    "address": "jkh13oxzfk@yzcalo.com"
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:tempmail/create": {
      "get": {
        "operationId": "temp_mail_tempmail_create",
        "summary": "Create address",
        "description": "Generate a new disposable email address.",
        "tags": [
          "Temp Mail (tempmail.ing)"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/tempmail#reference-create"
        },
        "parameters": [
          {
            "name": "duration",
            "in": "query",
            "required": false,
            "description": "Lifetime of the address in minutes (1-60). Default 10",
            "schema": {
              "type": "number",
              "example": "10"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "address": "mrwcqeq5sd61@animateany.com",
                    "createdAt": "2026-07-22T17:23:58.369Z",
                    "expiresAt": "2026-07-22T17:33:58.360Z",
                    "durationMinutes": 10
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/temp-mail:tempmail/inbox/{address}": {
      "get": {
        "operationId": "temp_mail_tempmail_inbox",
        "summary": "Read inbox",
        "description": "Read messages received by a disposable address.",
        "tags": [
          "Temp Mail (tempmail.ing)"
        ],
        "externalDocs": {
          "url": "https://zpi.web.id/api/temp-mail/tempmail#reference-inbox"
        },
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The disposable address to read (as returned by create).",
            "schema": {
              "type": "string",
              "example": "mrvvtfyf5vke@oldtranslator.com"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                },
                "example": {
                  "status": "success",
                  "message": "Success",
                  "content": {
                    "count": 0,
                    "items": [],
                    "address": "mrwcqeq5sd61@animateany.com"
                  }
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/Error"
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    }
  }
}