# Mail.gw — Zapi reference

> Alamat email sekali pakai dari Mail.gw — buat alamat lalu baca pesan yang masuk.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/temp-mail/mail-gw
- Endpoint catalog: https://zpi.web.id/category/temp-mail
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Mail.gw

**Category:** temp-mail · **Slug:** `mail-gw`
**Detail page:** https://zpi.web.id/api/temp-mail/mail-gw

Alamat email sekali pakai dari Mail.gw — buat alamat lalu baca pesan yang masuk.

**Tags:** tempmail, email, disposable, otp

### Create

Buat alamat email sekali pakai.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/temp-mail:mail-gw/create`

**Parameters:**

_No parameters._

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/temp-mail:mail-gw/create" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/temp-mail:mail-gw/create", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/temp-mail:mail-gw/create",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "address": "zp1j6c673t1v4y@oakon.com",
  "createdAt": "2026-08-07T09:43:38+00:00",
  "expiresAt": "2026-08-15T17:43:38+00:00",
  "durationMinutes": 12000
}
```

---

### Inbox

Baca pesan yang masuk ke alamat sekali pakai.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/temp-mail:mail-gw/inbox/:address`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `address` | string | path | yes | The disposable address to read (as returned by create). |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/temp-mail:mail-gw/inbox/:address" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/temp-mail:mail-gw/inbox/:address", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/temp-mail:mail-gw/inbox/:address",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 0,
  "items": [],
  "address": "zp1j6c673t1v4y@oakon.com"
}
```

---


_Generated: 2026-08-08T02:21:18.874Z_