compile(group: 'com.aspose', name: 'aspose-email-cloud', version: '21.4.0')
<dependency org="com.aspose" name="aspose-email-cloud" rev="21.4.0">
    <artifact name="aspose-email-cloud" ext="jar"/>
libraryDependencies += "com.aspose" % "aspose-email-cloud" % "21.4.0"

Manage Emails in Cloud via Java REST API


Product Page | Documentation | Live Demo | Swagger UI | Code Samples | Blog | Free Support | Free Trial

Aspose.Email Cloud SDK for Java helps you work with 3D file formats within your cloud-based Java Apps, without installing any 3rd party software. It is a wrapper around Aspose.Email Cloud REST APIs.

Cloud Email Processing Features

  • Works with different emails’ formats such as Outlook® MSG, EML, VCard, and iCalendar® files.
  • Supports AI functions: – Business card recognition – Parse business card image to vCard – Parsing and handling of personal names – Detect similar names – Identify person’s gender based on name – Suggest possible alternatives of a name – Guess person’s name based on its initials
  • Provides built-in email client: – Supports IMAP, POP3, SMTP, EWS, WebDav. – Virtual multi-account – Message threads (POP3 accounts are also supported)
  • Email configuration discovery
  • Disposable email address detection.

Email Cloud Storage Features

  • Upload, download, copy, move and delete files, including versions handling (if you are using Cloud storage that supports this feature - true by default).
  • Create, copy, move and delete folders.
  • Copy and move files and folders accross separate storages in scope of a single operation.
  • Check if certain file, folder or storage exists.

Supported Email File Formats

Microsoft Outlook®: MSG
Contact: VCF, MSG
iCalendar®: ICS, MSG
Business Card Recognition AI: PNG, JPG or JPEG, TIFF, BMP, GIF


Building the API client library requires:

  1. Java 1.7+
  2. Maven


To use Aspose.Email Cloud SDK for Java you need to register an account with Aspose Cloud and lookup/create Client ID and Client Secret at Cloud Dashboard. There is free quota available. For more details, see Aspose Cloud Pricing.


Install from Maven

Add Aspose Cloud repository to your application pom.xml

    <name>Aspose Cloud Repository</name>

Install from source

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project’s POM:



At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

  • target/aspose-email-cloud-21.9.0.jar
  • target/lib/*.jar

Usage examples

To use the API, you should create an EmailCloud object:

EmailCloud api = new EmailCloud("Your Client secret", "Your Client id");

Business cards recognition API

Use AiBcrApi.parse method to parse business card image to VCard DTO:

byte[] fileBytes = IOUtils.toByteArray(new FileInputStream("/tmp/alex.png"));
ContactList result = api.ai().bcr().parse(Models.aiBcrParseRequest()
ContactDto contact = result.getValue().get(0);
assert contact.getDisplayName().contains("Parsed Display Name");


All Aspose.Email Cloud SDKs, helper scripts and templates are licensed under MIT License.

Authorization & Authentication

Authentication schemes defined for the API is as follows:



It’s recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Product Page | Documentation | Live Demo | Swagger UI | Code Samples | Blog | Free Support | Free Trial

VersionRelease Date
21.9.0September 21, 2021
21.4.0April 13, 2021
20.12.0December 30, 2020
20.10.0October 29, 2020
20.9.0September 9, 2020
20.7.0July 23, 2020
20.5.0May 27, 2020
1.0.1May 11, 2020
20.3.0March 16, 2020
20.2.0February 26, 2020
20.1.0January 28, 2020
19.12.0December 31, 2019
19.11.0November 27, 2019
1.0.0July 24, 2015