API Reference
Reusable Email API Reference
This document details the available API endpoints, their usage, and parameters.
Headers
{
"Authorization": "Your_API_Key"
}
Endpoints
GET /v1/inbox
Fetches all emails in the specified inbox.
Parameters
alias (string): The alias name of the inbox.
Example Request
GET /v1/inbox?alias=example_alias HTTP/1.1
Host: api.reusable.email
Example Response
{
"alias": "EXAMPLE",
"inbox": [
{
"body": "Example Body\n",
"headers": {
"MIME": {"MIME":"MIME Related Info"},
"SMTP": {"SMTP":"SMTP Related Info"}
},
"id": "861cbdb0b223ad18",
"sender": "Carter <Carter@carter2565.dev>",
"subject": "Example Title",
"timestamp": 1734448240.0
},
]
}
GET /v1/email
Fetches the body of a specific email.
Parameters
alias (string): The alias name of the inbox.
id (string): The email ID to fetch.
Example Request
GET /v1/email?alias=example&id=861cbdb0b223ad18 HTTP/1.1
Host: api.reusable.email
Example Response
<div dir="ltr">Example Body<br/></div>
DELETE /v1/email
Deletes a specific email from the inbox.
Parameters
alias (string): The alias name of the inbox.
id (string): The email ID to delete.
Example Request
DELETE /v1/email?alias=example&id=861cbdb0b223ad18 HTTP/1.1
Host: api.reusable.email
Example Response
{
"success": true
}
POST /v1/encrypted/inbox
Creates a new encrypted inbox.
Request Body
publicKey (string): The public key encoded in UTF-8.
inboxName (string): The alias name in the format ^[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$. See more in our Encrypted Inbox Management docs in API Documentation
Example Request
POST /v1/encrypted/inbox HTTP/1.1
Host: api.reusable.email
Content-Type: application/json
{
"publicKey": "MIIBIjANBgkqhki...",
"inboxName": "ABCD-1234-EFGH"
}
Example Response
{
"message": "Inbox created successfully"
}
GET /v1/encrypted/inbox
Fetches the details of an encrypted inbox.
Parameters
alias (string): The alias name in the required format.
Example Request
GET /v1/encrypted/inbox?alias=R0WB-FNSC-NVLP HTTP/1.1
Host: api.reusable.email
Example Response
{
"alias": "R0WB-FNSC-NVLP",
"inbox": [
{
"encrypted_aes_key": "mXZCi0eKaw/u+Az8CpMOaUDX/99g13jCLss/QYU64vpHr1yZstcdSKWyRR03IsTVstGVNnpDH2Xi05gJ7CpbTKQ0Fcy/brCjDSCgQtwPcJkJwBapWT+hTNoFWgerWtJMg02whhJLItuNwVb45k+ZKPDls7rvhawIeeLIyAxftLrOj3xXimpUv5C82I+rx3KspS029rWiTdqBvjJPq1I4HEiZdW5WHDGOf1erNop4I2enHzxZXw6HG75uh8OWWi+N7gl1TIWEF9BbwXJQ8/GgQyqsEBCRxoNFLmhvzy9BkyepAEYJOTTnjct3JRUAdMKBxV8FMfUa3ao9U01TLy90Ww==",
"encrypted_email_data": "D0P5UaervsZOlgFYt5SQbygrUvLoaV/jQsX1e2snmuR7uNcc0o9EuGeO36SCmChOaT6FOnSf0v5vP2o6QBxr5Ov6z1VlEpopZjHBnnsMVJkdb09hSdplmW39D5/txdY9mXlg0UYyIGnzy57wvDTjkgGG2r/vRTz+MqR+N6Ck3/767k6n43qNe8/AMoDLJ9wwVWxiohai9+qRf2Se5+BS18JxPuum98vzE4gYhuK/oMvOYGTYkLk7cr+TzRGEtgMfmbjKpJf5gCOZ8fUXAjQc",
"encrypted_iv": "vVLFgDcY0hJi1ylDX2sO8A==",
"public_key": "PUBLIC_KEY",
"timestamp": 1734451731
}
]
}
GET /v1/encrypted/email
Fetches the details of a specific encrypted email.
Parameters
alias (string): The alias name in the required format.
id (string): The email ID to fetch.
Example Request
GET /v1/encrypted/email?alias=R0WB-FNSC-NVLP&id=e3c83defb603f949 HTTP/1.1
Host: api.reusable.email
Example Response
{
"encrypted_aes_key": "mXZCi0eKaw/u+Az8CpMOaUDX/99g13jCLss/QYU64vpHr1yZstcdSKWyRR03IsTVstGVNnpDH2Xi05gJ7CpbTKQ0Fcy/brCjDSCgQtwPcJkJwBapWT+hTNoFWgerWtJMg02whhJLItuNwVb45k+ZKPDls7rvhawIeeLIyAxftLrOj3xXimpUv5C82I+rx3KspS029rWiTdqBvjJPq1I4HEiZdW5WHDGOf1erNop4I2enHzxZXw6HG75uh8OWWi+N7gl1TIWEF9BbwXJQ8/GgQyqsEBCRxoNFLmhvzy9BkyepAEYJOTTnjct3JRUAdMKBxV8FMfUa3ao9U01TLy90Ww==",
"encrypted_email_data": "D0P5UaervsZOlgFYt5SQbygrUvLoaV/jQsX1e2snmuR7uNcc0o9EuGeO36SCmChOaT6FOnSf0v5vP2o6QBxr5Ov6z1VlEpopZjHBnnsMVJkdb09hSdplmW39D5/txdY9mXlg0UYyIGnzy57wvDTjkgGG2r/vRTz+MqR+N6Ck3/767k6n43qNe8/AMoDLJ9wwVWxiohai9+qRf2Se5+BS18JxPuum98vzE4gYhuK/oMvOYGTYkLk7cr+TzRGEtgMfmbjKpJf5gCOZ8fUXAjQc",
"encrypted_iv": "vVLFgDcY0hJi1ylDX2sO8A==",
"public_key": "PUBLIC_KEY",
"timestamp": 1734451731
}
DELETE /v1/encrypted/email
Deletes a specific encrypted email.
Parameters
alias (string): The alias name in the required format.
id (string): The email ID to delete.
Example Request
DELETE /v1/encrypted/email?alias=ABCD-1234-EFGH&id=123 HTTP/1.1
Host: api.reusable.email
Example Response
{
"success": true,
}
Keys used in examples
Public Key
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtZqCdquUjHek14rf7Wwl
JTDwcVs9goxKwATXgcpKB+vL9qMeLnzztlKN+kKMUKh3oUuSKpR5le+JsawzCMyO
tciHNa1eGr/Rj7QjR9tfmXu3WNNFQgKSVUCEnU238RLRW92Nn34YueYN1ANnm9LL
Mly9BYIIrzGQca4+J6a3/nQ6OuP/ggTKfsLMR8F6WtFsfBbfo5eO1ZtS+bsh4CyX
K//CDFuVBdLjCXqA9PPV5kTJAF2EoIE03dCi7JpqHwL2YtRYn/vDoS7/2VmHCHm1
f4XZeQWco5xhmSXyguQzicxrD16O4QfNYuK34MhkrdGpRJLgUadht2m0hubE7g2M
6wIDAQAB
-----END PUBLIC KEY-----
Private Key
-----BEGIN PRIVATE KEY-----
MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQC1moJ2q5SMd6TX
it/tbCUlMPBxWz2CjErABNeBykoH68v2ox4ufPO2Uo36QoxQqHehS5IqlHmV74mx
rDMIzI61yIc1rV4av9GPtCNH21+Ze7dY00VCApJVQISdTbfxEtFb3Y2ffhi55g3U
A2eb0ssyXL0FggivMZBxrj4nprf+dDo64/+CBMp+wsxHwXpa0Wx8Ft+jl47Vm1L5
uyHgLJcr/8IMW5UF0uMJeoD089XmRMkAXYSggTTd0KLsmmofAvZi1Fif+8OhLv/Z
WYcIebV/hdl5BZyjnGGZJfKC5DOJzGsPXo7hB81i4rfgyGSt0alEkuBRp2G3abSG
5sTuDYzrAgMBAAECggEAKLvbf5rE2y0LAH3Z9HtJaaoshICer2WgbqmnXSluqZAu
U8gKwQqt77tctUGwD3d6PeehhYOAMi1kiUHCwLqBWCz+hv+4F+/mpYEWWMvQCbFC
Ut4wrrm88PpjxJTmKWC7LQvo9FloWmpLt757wuvpQAalL1MXd5R6fcVDk8lFhAFU
IKtQLmG3ZK7bV+X3epXpyeys1ujSQGq4O7dAb8iuXpWHx0CHNZcOOiuzdR9yOrV4
1sdmsi0TGXZGLePsl1iaLQTcCUTyzz7BYKYvzyCxj+wE9MbtM2hojz+Rz/tqBIyR
Ibim1akVFjzY9H88PbzbQGZkq+YgXV2OF6ezkWJZgQKBgQD7VXvfhpe4OsWukR2f
4FxuOo+EFpzPUz4nVvraOVDLG5lcyJjhGSeFPEEnSx/r9+kB6/9IWVolNGC6hMkC
fiaYOdDhljw5ww2Yd7m+SLVp7+9BJjT1yT4NkY3XZUSKfz5c1mzs6oWmvktmfZHN
EZE0wbG2cqU3S1ElEiRtPlrz+wKBgQC4+Z4qinlwnOe640Tq+mXe15pTneC+ptlL
AorZHk5HyvNqZ+if5S0lWxZsG+FMvavk9ZMDD0oT78UJ1uOK9Wg344KBltynrcJg
ftG46dUkDZNOQt1vSx6o4aCWAOcG36tIjrvYd2FuwLMyKBGXCUAW76jcFz6yDxEL
6s0nQPmH0QKBgBhRVBPzjNh5b0kNp2Uhqy/LILmyCmgQ8NGTm9/jbcrJF9SfYBNf
gLBmfRNVNHh7WyMhd2jDpHI3GCjT0jMYi5ls9qXtCFS6Z6VZ6DHeDRd77JVMIhGp
8AQWEjhGBxSzbRBEevONWXMhtF/tRF8oFPmayBwUCaJI+kfw8m9Tei9jAoGAfKRv
aNkQhcqk97DnIrOB64w6yLds1utVJo9bAnzCYOwn4/6KqRvjtPVRAZ4zzeNNLiYw
XvJxh0ec7Ulo4J0HEgnzSeFfZHnYre8m4MRoRDgFl8nErpbe3QvUit+mzWHwaB8O
AwpGlDuzREvttmmcTxhFH7FmJNO0N+SLQzUsL9ECgYAKZJVf62Jxz1aXMaNCbjWu
O3OdanHfNjOVPcLQoPmztUR1VzdZgrGXtLWXxLF8UTEG/VdkVulVzG8iqfJkhH1m
ZqNY123aj6DYgkhBbe8N4IG9/Lm8NWStKph5lASsXHJYunmB4k8pxob9/DGlwJVQ
dH2Y3rso/ZF0XpVccQlY4g==
-----END PRIVATE KEY-----