Receiving email
List messages
GEThttps://api.temporam.com/v3/emails
| Parameter | Type | Default | Description |
|---|
| email | string | — | Mailbox address to query |
| page | integer | 1 | Page number |
| limit | integer | 20 | Items per page |
- 1curl "https://api.temporam.com/v3/emails?email=demo%40temporam.com&page=1&limit=20" \
- 2 -H "Authorization: Bearer YOUR_API_KEY"
| Response field | Type | Description |
|---|
| data | array | Inbound messages |
| data[].id | string | Message UUID |
| data[].uuid | string | Message UUID |
| data[].created_at | string | Received time |
| data[].from_name | string | Sender display name, when available |
| data[].from_email | string | Sender email address |
| data[].to_name | string | Recipient display name, when available |
| data[].to_email | string | Recipient email address |
| data[].subject | string | Subject |
| data[].summary | string | Content summary |
| data[].from_domain | string | Sender domain, when available |
| data[].to_domain | string | Recipient domain, when available |
| meta.total | integer | Total matching messages |
| meta.page | integer | Current page |
| meta.limit | integer | Items per page |
| meta.remaining | integer | Remaining inbound quota, when available |
Read the latest message
GEThttps://api.temporam.com/v3/emails/latest
| Parameter | Location | Type | Required | Description |
|---|
| email | query | string | Yes | Mailbox address to query |
| Response field | Type | Description |
|---|
| data | object | Latest message, with the message fields listed above |
| data.content | string | Full message content |
| meta.remaining | integer | Remaining inbound quota, when available |
Get message details
GEThttps://api.temporam.com/v3/emails/{id}
| Parameter | Location | Type | Required | Description |
|---|
| id | path | string (UUID) | Yes | Message UUID |
| Response field | Type | Description |
|---|
| data | object | Message details, with the message fields listed above |
| data.content | string | Full message content |
| meta.remaining | integer | Remaining inbound quota, when available |
Reading a new inbound message may use inbound quota.