Mail.tm
API Reference

Accounts

Create and manage temporary email accounts.

POST /accounts

Create a new temporary email account.

Body

NameTypeDescription
addressstringAccount's address. Example: user@example.com
passwordstringAccount's password.

Params

None

Response

{
  "@context": "string",
  "@id": "string",
  "@type": "string",
  "id": "string",
  "address": "user@example.com",
  "quota": 0,
  "used": 0,
  "isDisabled": true,
  "isDeleted": true,
  "createdAt": "2022-04-01T00:00:00.000Z",
  "updatedAt": "2022-04-01T00:00:00.000Z"
}

At this point, you could now get the token and do all the cool stuff you want to do.

GET /accounts/{id}

Get an Account resource by its id (Obviously, the Bearer token needs to be the one of the account you are trying to retrieve)

Body

None

Params

NameTypeDescription
idstringThe message you want to gets id

Response

{
  "@context": "string",
  "@id": "string",
  "@type": "string",
  "id": "string",
  "address": "user@example.com",
  "quota": 0,
  "used": 0,
  "isDisabled": true,
  "isDeleted": true,
  "createdAt": "2022-04-01T00:00:00.000Z",
  "updatedAt": "2022-04-01T00:00:00.000Z"
}

DELETE /accounts/{id}

Deletes the Account resource.

Be careful! We can't restore your account, if you use this method, bye bye dear account

Body

None

Params

NameTypeDescription
idstringThe account you want to delete by id

Response

None (Returns status code 204 if successful.)

GET /me

Returns the Account resource that matches the Bearer token that sent the request.

Body

None

Params

None

Response

{
  "@context": "string",
  "@id": "string",
  "@type": "string",
  "id": "string",
  "address": "user@example.com",
  "quota": 0,
  "used": 0,
  "isDisabled": true,
  "isDeleted": true,
  "createdAt": "2022-04-01T00:00:00.000Z",
  "updatedAt": "2022-04-01T00:00:00.000Z"
}