Package Versions

Satisfied Customers Make Us Happy


1. API Overview

1.1 Audience

This documentation is intended for programmers who are writing client applications that interact with their Juvlon account. It provides explanation and examples of basic Application Programming Interface (API) operations using REST (REpresentational State Transfer) and JSON (Java Script Object Notation). It supports all the technologies which can use Java Script as part of their application.

This documentation assumes that you understand:

  • Juvlon and it's functionalities
  • General principles behind the any programming languages and concepts, code examples and links to sample code provided.

This documentation explains all possible interfaces available to access your Juvlon account via your internal programs.

1.2 Juvlon APIs

The Juvlon's API's allows you to integrate your application directly to your Juvlon account. The API Documentation covers all aspects including detailed explanation about API, Parameters, Return values, Examples, Sample Error and Success responses of the Juvlon's APIs.

To ensure maximum privacy for clients and their data over web, Juvlon API are fully available via SSL. The JSON data call to Juvlon should be requested through a secure transport only. Using SSL ensures that the entire content and access tokens of a Space remain secure and can not be intercepted by potential eavesdroppers.

Juvlon Support will help you to enable the APIs for your account and you will be able to generate the API Key from your Juvlon account itself. You may want to look at details here.

The APIs for all the consumers have been hosted at:

https://api.juvlon.com/[apiName]

To make a call to the Juvlon's APIs, one need to POST your REST requests in JSON format.

1.3 Active and Deprecated APIs

Juvlon is continuously getting upgraded with new functionality and Juvlon's API might get optimized over period of time. As a result of this optimization, few APIs will get deprecated and will not be supported by Juvlon. Off-course, the same functionality can be supported by different API.

This process of deprecation is intended to allow us to make changes to the APIs that are not backward compatible. This will also allow us to better deliver new functionality as well as make improvements to existing functionality. Be aware that all the Active APIs will appear under "Active APIs" and the deprecated APIs will under "Deprecated" in the left side tree.

1.4 API Usage

Java Scripts are simple to use and yet powerful. Juvlon APIs are also using Java Scripts and you need to include one Java Script file in your Programs. This file contains a wrapper what intern uses Java Scripts for jQuery and JSON.

All the requests from your application to Juvlon are expected to be coming in JSON format and in POST (not GET) method. Off-course, the data and parameters will vary depending the API that you are using.

1.5 Error handling and Timeouts

Juvlon APIs have well defined error handling and responding mechanism. The first digit of the status code specifies one of five classes of response; the bare minimum for an HTTP client is that it recognizes these five types.


1xx : Informational
2xx : Success
3xx : Redirection
4xx : Client Error
5xx : Server Error
e.g.
1. Codes starting with 2 (e.g. 200) are considered to be "Success" or "Processed".

2. Codes starting with 4 (e.g. 400, 401, 412) are considered Client Errors: the caller/client is doing something wrong and the payload should present you a possible solution to the problem;

3. Codes starting with 5 (e.g. 500, 503, 504) are considered Server Errors: there is something wrong with the way the server is handling your request and the payload should give you more details about the situation, including if it's permanent or temporary.

On occasion, your application may experience a timeout when calling the Juvlon's API. The timeout will appear as an HTTP error with a useful error message in the HTTP Header. It could be that you exceeded the number of queries per second or day in your Terms of Service or it is possible that you were denied access due to the aggregate queries per second limit. The aggregate queries per second limit is a fail-safe of the Juvlon's API, where the system denies all requests over a certain amount per second (set by Juvlon) to ensure the stability of the Juvlon's environment. This second type of timeout should only happen in the rarest of situations.

1.6 API Pre-Development Tool

If you would like to test out the Juvlon's API without writing code to do so, we are developing a web based sandbox tool which will be freely available for all the developers. It's coming soon..!!

This tool will help you how to use a specific API with sample data and it's parameters. And one can see the output immediately on screen.

2. Authentication

Every client is provided with a unique API Key that needs to be used as part of each request to the Juvlon's API service. This API Key is specific to an environment. Therefore, your Juvlon's API Development Environment key will not work for Production Environment and vice-a-verse. Make sure you are using the correct key with appropriate environment.

Juvlon authentication parameter "API Key" is used as:

                     
call_juvlon_api( [Your API Key], [API Name], [Your data Array], function(response) 
{   
    document.getElementById('show').innerHTML=response;
}

3. Juvlon's API Support

If you have an urgent Production issue, please email the details to Juvlon Support and we will help you at earliest possible.

addCampaign

Description

Add a new Campaign

This API allows you to Add a new Campaign to your Juvlon Account. This API, expects Campaign Name as a mandatory parameter.

addCampaign( String $campaignName, ) : String

Arguments

NameTypeDescriptionDefault
$campaignName String

(Mandatory) Campaign Name that you want to add to your Juvlon account.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var campaign_details = {
16     campaignname : 'New_Campaign'
17  }
18
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'addCampaign', campaign_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
{
"code":"200",
"status":"Success:Campaign Created successfully"
}

Error-Response

HTTP/1.1
{
 "code":"441",
 "status":"Error:Campaign Already Exist"
}

Possible-Response-Codes

200    Success:Campaign Created successfully
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Campaign Already Exist
442    Error:Invalid Campaign name
443    Error:Unauthorized Request
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

addList

Description

Add a new Subscriber List

This API allows you to add a new Subscriber List to your Juvlon Account. It expects a List Name as mandatory parameter.

addList( String $listName, ) : String

Arguments

NameTypeDescriptionDefault
$listName String

(Mandatory) List Name that you want to add in your Juvlon account.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var list_details = {
16     listname: 'New_Website_List',
17  }
18
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'addList', list_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
{
 "code":"200",
 "status":"Success:List added successfully"
}
                

Error-Response

HTTP/1.1
{
  "code":"441",
  "status"":"Error:List Name Already Exist"
}
                

Possible-Response-Codes

200    Success:List added successfully
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:List Name Already Exist
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
                

addNSend

Description

Send a mail to single subscriber

This API allows you to send an instant mail to a subscriber at your Juvlon Account. To this API, "Email Address" and "Mailer id" of pre-created Mailer at your Juvlon account are the two mandatory parameters. If you do NOT specify the List name, Juvlon will create a default List with name : RealTime_Via_API and proceed. All other parameters can be used to Personalize your email

addNSend( String $email, String $mailerId, String $listName, String $prefix, String $firstName, String $middleName, String $lastName, String $telephone, String $address, String $city, String $state, String $pincode, String $country, String $mobile, String $designation, String $company, String $companyPhone, String $birthDate, String $anniversary, String $extra1, String $extra2, ) : String

Arguments

NameTypeDescriptionDefault
$email String

(Mandatory) Email address

 
$mailerId String

(Mandatory) Existing mailer id at your Juvlon account

 
$listName String

List name from your Juvlon account

RealTime_Via_API

 

 
$prefix String

Prefix

 
$firstName String

First name

 
$middleName String

Middle name

 
$lastName String

Last name

 
$telephone String

Telephone

 
$address String

Address

 
$city String

City

 
$state String

State

 
$pincode String

Pincode

 
$country String

Country

 
$mobile String

Mobile

 
$designation String

Designation

 
$company String

Company

 
$companyPhone String

Company phone

 
$birthDate String

Birth date in format "YYYY-MM-DD"

 
$anniversary String

Anniversary date in format "YYYY-MM-DD"

 
$extra1 String

Extra Information 1

 
$extra2 String

Extra Information 2

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
 01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var mail_details = {
16      email        : 'John.Doe@foo.com',
17      mailerid     : '82',
18      listname     : '',
19      prefix       : '',
20      firstname    : 'John',
21      middlename   : '',
22      lastname     : 'Doe',
23      telephone    : '',
24      address      : '',
25      city         : '',
26      state        : '',
27      pincode      : '',
28      country      : '',
29      mobile       : '',
30      designation  : '',
31      company      : '',
32      companyphone : '',
33      birthdate    : '',
34      anniversary  : '',
35      extra1       : '',
36      extra2       : ''
37    }
38   // Send your data to your Juvlon account
39   //
40
41   call_juvlon_api(apikey, 'addNSend', mail_details, function(response) {
42       document.getElementById('show').innerHTML=response;
43   });
44
45   </script>

Success-Response

HTTP/1.1
  {
     "code":200,
     "status":"Request accepted"
  }

Error-Response

]
  HTTP/1.1
  {
     "code":446,
     "status":"Mailer not found"
  }

Possible-Response-Codes

200    Success:Request accepted
201    Subscriber Exists & Request accepted
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mail credit not available
442    Error:Invalid request
443    Error:INACTIVE Subscriber
444    Error:Not more than 10 in Test List
445    Error:Invalid List Name
446    Error:Mailer not found
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
  

addSingleSubscriber

Description

Add a single subscriber to an existing List

This API allows you to add a subscriber to an existing List at your Juvlon Account. To this API, "List Name" and "Email Address" are the two mandatory parameters. All other parameters can be used to Personalize your email.

addSingleSubscriber( String $listName, String $email, String $prefix, String $firstName, String $middleName, String $lastName, String $telephone, String $address, String $city, String $state, String $pincode, String $country, String $mobile, String $designation, String $company, String $companyPhone, String $birthDate, String $anniversary, String $extra1, String $extra2, ) : String

Arguments

NameTypeDescriptionDefault
$listName String

(Mandatory) List name from your Juvlon account

 
$email String

(Mandatory) Email address

 
$prefix String

Prefix

 
$firstName String

First name

 
$middleName String

Middle name

 
$lastName String

Last name

 
$telephone String

Telephone

 
$address String

Address

 
$city String

City

 
$state String

State

 
$pincode String

Pincode

 
$country String

Country

 
$mobile String

Mobile

 
$designation String

Designation

 
$company String

Company

 
$companyPhone String

Company phone

 
$birthDate String

Birth date in format "YYYY-MM-DD"

 
$anniversary String

Anniversary date in format "YYYY-MM-DD"

 
$extra1 String

Extra Information 1

 
$extra2 String

Extra Information 2

Return value

Type Description
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15
16  var subscriber_details = {
17      listname      : 'Website_List',
18      email         : 'John.Doe@foo.com',
19      prefix        : '',
20      firstname     : 'John',
21      middlename    : '',
22      lastname      : 'Doe',
23      telephone     : '',
24      address       : '',
25      city          : '',
26      state         : '',
27      pincode       : '',
28      country       : '',
29      mobile        : '',
30      designation   : '',
31      company       : '',
32      companyphone  : '',
33      birthdate     : '',
34      anniversary   : '',
35      extra1        : '',
36      extra2        : ''
37   }
38   // Send your data to your Juvlon account
39   //
40
41   call_juvlon_api(apikey, 'addSingleSubscriber', subscriber_details, function(response) {
42       document.getElementById('show').innerHTML=response;
43   });
44
45   </script>
  

Success-Response>

  HTTP/1.1
  {
     "code":200,
     "status":"Subscriber added successfully"
  }
  

Error-Response

  HTTP/1.1
  {
     "code":442,
     "status":"Subscriber already exists"
  }

Possible-Response-Codes

  200    Success:Subscriber added successfully
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
440    Error:Subscriber credit not available
441    Error:Invalid List Name
442    Error:Subscriber Already Exist
443    Error:INACTIVE Subscriber
444    Error:Can not add more than 10 Subscribers in Test List
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

changeSender

Description

Change sender Email Id of a mailer

This API allows you to change sender Id of an existing mailer to existing sender Id. It expects both MailerId and eMailId as mandatory parameters.

changeSender( String $mailerId, String $email, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId String

(Mandatory) Id of mailer from your Juvlon account.

 
$email String

(Mandatory) Email Id that you want to change to.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
 01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var change_sender = {
16    mailerid : '1',  
17    email : 'john@doe.com'
18  }
19  
20
21  // Send your data to your Juvlon account
22  //
23  call_juvlon_api(apikey, 'findSubscriber', change_sender, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>
 

Success-Response

HTTP/1.1
  {
     "code":"200",
     "status":"Success:Sender email updated successfully"
   }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer does not exists"
  }

Error-Response

  HTTP/1.1
  {
     "code":"444",
     "status":"Error:Sender email is Inactive"
  }

Possible-Error-Codes

200    Success:Sender email updated successfully
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer does not exists
442    Error:Mailer sent, can not change sender
443    Error:Sender email does not exists
444    Error:Sender email is Inactive
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
  

deleteList

Description

Delete an existing Subscriber List

This API allows you to Delete an existing Subscriber List from your Juvlon Account. It expects a List name as mandatory parameter.

deleteList( String $listName, ) : String

Arguments

NameTypeDescriptionDefault
$listName String

(Mandatory) Existing List name in your Juvlon account.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
 01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var delete_list_detail = {
16     listname : 'Existing_List1',
17  }
18
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'deleteList', delete_list_detail, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>
 

Success-Response

 HTTP/1.1
  {
     "code":"200",
     "status":"Success:List deleted successfully"
  }
 

Error-Response

 HTTP/1.1
  {
     "code":"441",
     "status":"Error:List Name not Exist"
  }
 

Possible-Response-Codes

200    Success:List deleted successfully
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:List Name not Exist
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
 

findSubscriber

Description

Find a specific subscriber within lists.

This API allows you to find a particular email within multiple lists in your Juvlon account. To this API, email is only mandatory parameter. It returns list name(s) along with it's status.

findSubscriber( String $email, ) : String

Arguments

NameTypeDescriptionDefault
$email String

(Mandatory) eMailId you want to search for in Juvlon account.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
  01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var find_subscriber = {
16      email   : 'john@doe.com'    
17  }
18
19  // Send your data to your Juvlon account
20  //
21  
22  call_juvlon_api(apikey, 'findSubscriber', find_subscriber, function(response) {
23      document.getElementById('show').innerHTML=response;
24  });
25
26  </script>
  

Success-Response

  HTTP/1.1
  {
    "code":"200",
    "status":"Success:",
    "Subscriber Details":
        "["SeqNo":"1","List Name":"Instant Test List", "Status":"ACTIVE",
          "SeqNo":"2","List Name":"ASIAClients", "Status":"ACTIVE",
          "SeqNo":"3","List Name":"USClients", "Status":"ACTIVE",
          "SeqNo":"4","List Name":"EUClients", "Status":"INACTIVE"]"
  }

Error-Response

  HTTP/1.1
  {
     "code":"441",
     "status":"Error:No email found"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:No email found
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getAccountSummary

Description

Get your account summary

This API allows you to get account level summary from your Juvlon Account. It does not expect any parameter to his API.

getAccountSummary( ) : String

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Call to Juvlon
14  //
15  call_juvlon_api(apikey, 'getAccountSummary', '', function(response) {
16     document.getElementById('show').innerHTML=response;
17  }); 
18  
19 </script>

Success-Response

HTTP/1.1
  {
    "code" : "200",
    "status":"Success", 
    "Account Details":",
         "Email":"john@doe.com",
         "Address":"Address1, Address2, Address3,State,
         "Expiry Date":"2028-01-21", "Mail Credit":"1490"",
         "User Details":"["SeqNo":"1","Email":"john@doe.com","CreatedOn":"2012-07-12",
                          "SeqNo":"2","Email":"johny@doe.com","CreatedOn":"2012-08-27" 
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Unable to get account details"
  }

Possible-Error-Codes

200    Success:Usage Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Unable to get account details
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getAvailableCredit

Description

Get your available credits

This API allows you to get available credits from your Juvlon account. It does not expect any parameter to be passed.

getAvailableCredit( ) : String

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04 <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05 <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Call to Juvlon
14  //
15  call_juvlon_api(apikey, 'getAvailableCredits', '', function(response) {
16     document.getElementById('show').innerHTML=response;
17  }); 
18
19
20 </script>

Success-Response

HTTP/1.1
  {
     "code":"200",
     "status":"Success:Mail Credit Details",
     "Total Credits":"1490"
  }

Error-Response

  HTTP/1.1
  {
     "code":"441",
     "status":"Error:Fetching credit details"
  }
  

Possible-Error-Codes

200    Success:Usage Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Fetching credit details
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
  

getCampaignMailers

Description

Get mailer details from specific campaign

This API allows you to get all mailer level details from specific campaign at your Juvlon Account. To this API, Campaign Name is only mandatory parameter. In return, this API will provide you details of all the mailer along with Mailer Name along with it's creation date.

getCampaignMailers( String $campaignName, ) : String

Arguments

NameTypeDescriptionDefault
$campaignName String

(Mandatory)campaign name created in Juvlon account.

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var campaign_detail = 
16      {
17         campaignname : 'MyTest Camp'
18      }
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'getCampaignMailers',campaign_detail, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
    "code":"200",
    "status":"Success:",
    "Campaign Details":
    "["SeqNo":"1","Mailer Subject":"For Europe clients","CreatedOn":"04-04-2013",
      "SeqNo":"2","Mailer Subject":"For US clients","CreatedOn":"04-04-2013",
      "SeqNo":"3","Mailer Subject":"To reach worldwide","CreatedOn":"04-04-2013"]"
 }

Error-Response

HTTP/1.1
  {
    "code":"441",
    "status":"Error:Campaign details not found"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Campaign details not found
442    Error:No Mailers
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getCampaigns

Description

Get Campaign level details

This API allows you to get Campaign level details from your Juvlon Account. It does not expect any parameter.

getCampaigns( ) : String

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Call to Juvlon
14  // 
15  call_juvlon_api(apikey, 'getCampaigns', '', function(response) {
16      document.getElementById('show').innerHTML=response;
17  }); 
18
19  </script>

Success-Response

HTTP/1.1
  { "code" : "200", 
    "status":"Success",
    "Campaign details":"["SeqNo":"1","Campaign Name":"Test1","CreatedOn":"28-07-2012",
                         "SeqNo":"2","Campaign Name":"Test2","CreatedOn":"19-07-2012"]"
  }

Error-Response

  HTTP/1.1
  {
     "code":"441",
     "status":"Error:Getting Campaign details"
  }

Possible-Error-Codes

200    Success:Campaign details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Getting Campaign details
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getLists

Description

Get Subscriber List detail(s)

This API allows you to get Subscriber List Name(s) and Count of Subscribers in that List from your Juvlon Account. It does not expect any parameter.

getLists( ) : String

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var list_details = {}
16
17  // Send your data to your Juvlon account
18  //
19
20  call_juvlon_api(apikey, 'getLists', list_details, function(response) {
21      document.getElementById('show').innerHTML=response;
22  });
23
24  </script>

Success-Response

HTTP/1.1
  {
     "code":"200",
     "status":"Success:List details",
     "list details": "[List one : 3, List two : 10, List three : 1000]"
  }

Error-Response

HTTP/1.1
  {
     "code":"503",
     "status":"Error:While fetching the list(s) details"
  }

Possible-Response-Codes

200    Success:List details.
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:While fetching the list(s) details

getMailerBounces

Description

Get Bounce details for sent mailer

This API allows you to get Bounce details for sent mailer from your Juvlon Account. To this API, MailerId, Senddate, Startpoint are mandatory parameters. In return this API will provide you Bounce details of that mailer which includes email Id, Bounce Date, Bounce Type (Hard/Soft) and Bounce Reason.

Start point is a number from where you want dataset and Number of records per request is default 1000, maximum is 10000.

e.g. If you have number of bounces are 25000, and if you want data of 15000 till 17000 records only, you request using Start Point as 15000 and Number of Records as 2000.

getMailerBounces( Int $mailerId, String $senddate, Int $startpoint, Int $numofrecords, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) ID of mailer that you created in Juvlon account.

 
$senddate String

(Mandatory) Send Date of mailer from your Juvlon account.

 
$startpoint Int

Startpoint from where you need data

1

 

 
$numofrecords Int

Number of records per request

1000

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var mailer_details = {
16      mailerid       : '82',
17      senddate       : '2014-01-01',
18      startpoint     : '1',
19      numofrecords   : '500'
20   }
21
22  // Send your data to your Juvlon account
23  //
24  call_juvlon_api(apikey, 'getMailerBounces', mailer_details, function(response) {
25     document.getElementById('show').innerHTML=response;
26  });
27
28  </script>

Success-Response

HTTP/1.1
  {
    "code":"200",
    "status":"Success",
    "Bounces Details":"[
    "SeqNo":"1","Email":"John@doe.com",
    "BounceDate":"2014-01-01 10:01:01",
    "BounceType":"HARD",
    "BounceReason":"smtp;550 5.1.1 The email account that you tried to reach does not exist. Please try double-checking the recipient's email address for typos or unnecessary spaces. Learn more at http://support.google.com/mail/bin/answer.py?answer=6596 f7si4431424vcs.42 - gsmtp"]"
  }

Error-Response

  HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer does not exist"
  }

Error-Response

  {
     "code":"442",
     "status":"Error:Invalid senddate format"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
201    Success:No bounces available
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer does not exist
442    Error:Invalid senddate format
443    Error:Invalid start point
444    Error:Invalid Number of records
445    Error:Number of records should be less than 1000
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:Mailer details not found.

getMailerClicks

Description

Get Link Clicks of a sent mailer

This API allows you to get Link Clicks details from any mail that you had send from your Juvlon Account. To this API, MailerId, Senddate are mandatory parameters and API rerurns you Clicks by subscribers with details for that mailer. The details include Email Id, Mail Sent Date, Operating System details, Click Count and a Extrafield information (if requested).

Start point is a number from where you want dataset and Number of records per request is default 1000, maximum is 10000.

e.g. If you have number of Clicks are 25000, and if you want data of 15000 till 17000 records only, you request using Start Point as 15000 and Number of Records as 2000.

The extra field can be one of the list : "Name Title", "First Name", "Middle Name", "Last Name", "Email", "Primary Telephone", "Company Name", "Designation", "Company Telephone 1", "Company Fax", "Company Address 1", "Company City", "Company State", "Company Pin", "Company Country", "Residence Address 1", "Residence City", "Residence City", "Residence State", "Residence Pin", "Residence Country", "Residence Country", "Residence Telephone 1", "Mobile", "Birthday", "Anniversary".

getMailerClicks( Int $mailerId, String $sendDate, Int $startPoint, Int $numOfRecords, String $extraField, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) ID of mailer that you created in Juvlon account.

 
$sendDate String

(Mandatory) Send Date of mailer from your Juvlon account.

 
$startPoint Int

Startpoint from where you need data

1

 

 
$numOfRecords Int

Number of records per request

1000

 

 
$extraField String

Name of Extra field you want to get data of (from above list)

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07  // Replace your API key at below line
08  //
09  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
10  
11  // Form your data object
12  //
13   var mailer_details = {
14      mailerid     : '91',
15      senddate     : '2014-01-01',
16      startpoint   : '1',
17      numofrecords : '500',
18      extrafield   : 'First Name'
19  }
20  
21  // Send your data to your Juvlon account
22  //
23  call_juvlon_api(apikey, 'getMailerClicks', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {   
      "code":"200",
      "status":"Success:",
      "Click Details":"
        ["SeqNo":"1",
         "Email":"john@doe.com",
         "sentDate ":"2014-01-01 12:33:02",
         "OS":"Windows",
         "OS version":"Windows XP",
         "Browser":"Chrome",
         "ClickCount":"3",
         "Device":"",
         "First Name":"John"]"
 }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer not Exist"
  }

Error-Response

{
     "code":"442",
     "status":"Error:Invalid send datetime."
  }

Possible-Response-Codes

200    Success:Mailer Report Details
201    Success:No clicks available
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer not Exist
442    Error:Invalid send date format
443    Error:Invalid start point
444    Error:Invalid Number of records
445    Error:Number of records should be less than 1000
446    Error:invalid extrafield
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:Mailer details not found.

getMailerOpens

Description

Get Mail Opens for sent mailer

This API allows you to get detailed mail-Opens for the mailer you had sent from your Juvlon Account. To this API, MailerId, SendDate, StartPoint, ExtraField are mandatory parameters and it will provide you Mail-Open details along with Email list along with details like Mail Sent Date, Open Count and extrafield (if requested).

Start point is a number from where you want dataset and Number of records per request is default 1000, maximum is 10000.

e.g. If you have number of Opens are 25000, and if you want data of 15000 till 17000 records only, you request using Start Point as 15000 and Number of Records as 2000.

The extra field can be one of the list : "Name Title", "First Name", "Middle Name", "Last Name", "Email", "Primary Telephone", "Company Name", "Designation", "Company Telephone 1", "Company Fax", "Company Address 1", "Company City", "Company State", "Company Pin", "Company Country", "Residence Address 1", "Residence City", "Residence City", "Residence State", "Residence Pin", "Residence Country", "Residence Country", "Residence Telephone 1", "Mobile", "Birthday", "Anniversary".

getMailerOpens( Int $mailerId, String $sendDate, Int $startPoint, Int $numOfRecords, String $extraField, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) ID of mailer that you created in Juvlon account.

 
$sendDate String

(Mandatory) Send Date of mailer from your Juvlon account.

 
$startPoint Int

Startpoint from where you need data

1

 

 
$numOfRecords Int

Num of records per request

1000

 

 
$extraField String

Name of Extra field you want to get data of (from above list)

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07  // Replace your API key at below line
08  //
09  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
10  
11  // Form your data object
12  //
13  var mailer_details = {
14    mailerid   : '81',
15    senddate   : '2013-04-03',
16    startpoint     : '1',
17    numofrecords   : '500',
18    extrafield     : 'First Name'
19    }
20  
21  // Send your data to your Juvlon account
22  //
23  call_juvlon_api(apikey, 'getMailerClicks', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {   "code":"200",
      "status":"Success:",
      "Open Details":"
      ["SeqNo":"1",
          "Email":"John@doe.com",
          "sentDate ":"2013-04-03 12:33:02",
          "OS":"Windows",
          "OS version":"Windows XP",
          "Browser":"Chrome",
          "OpenCount":"2",
          "Device":"",
          "First Name":"John"]"
 }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer does not exist"
  }

Error-Response

{
     "code":"442",
     "status":"Error:Invalid date format"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
201    Success:No opens available
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer does not exist
442    Error:Invalid date format
443    Error:Invalid start point
444    Error:Invalid Number of records
445    Error:Number of records must be less than 1000
446    Error:Invalid extrafield 
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getMailerOptOuts

Description

Get Optout details for sent mailer

This API allows you to get Optout details for the mailer you had sent from your Juvlon Account. To this API, MailerId, Senddate, Startpoint are mandatory parameters. In return it provides you Optout details for that mailer, it includes EmailId and Unsubscription Date.

Start point is a number from where you want dataset and Number of records per request is default 1000, maximum is 10000.

e.g. If you have number of Optouts are 25000, and if you want data of 15000 till 17000 records only, you request using Start Point as 15000 and Number of Records as 2000.

getMailerOptOuts( Int $mailerId, String $senddate, Int $startpoint, Int $numofrecords, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) ID of mailer that you created in Juvlon account.

 
$senddate String

(Mandatory) Send Date of mailer from your Juvlon account.

 
$startpoint Int

Startpoint from where you need data

1

 

 
$numofrecords Int

Num of records per request

1000

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12  //Form your data object
13  // 
14  var mailer_details = {
15      mailerid     : '81',
16      senddate     : '2013-04-03',
17      startpoint   : '1',
18      numofrecords : '500'
19  }
20  
21  // Send your data to your Juvlon account
22  //
23  call_juvlon_api(apikey, 'getMailerOptOuts', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
    "code":"200",
    "status":"Success",
    "OptOut Details":"[
          "SeqNo":"1","Email":"john@doe.com","UnscribeDate":"2014-01-01",
          "SeqNo":"2","Email":"abcd@yahoo.com","UnscribeDate":"2014-01-01",
          "SeqNo":"3","Email":"johny@doe.com","UnscribeDate":"2014-01-01"]" 
}

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer does not exist"
  }

Error-Response

{
     "code":"442",
     "status":"Error:Invalid senddate format"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
201    Success:No optouts available
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer does not exist
442    Error:Invalid senddate format
443    Error:Invalid start point
444    Error:Invalid Number of records
445    Error:Number of records should be less than 1000
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:Mailer details not found.

getMailerReport

Description

Get details of Mailer sent

This API allows you to get detailed Mailer report which you have sent from your Juvlon Account. To this API, MailerId is only mandatory parameter. In retrun it will provide you details of that Mailer which includes Mailer Subject along with list level details like Mail Sent Date, List Name, Unique Sent Count, Unique Open Count, Unique Click Count, Bounce Count and Optout Count.

getMailerReport( Int $mailerId, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory)ID of mailer you created in Juvlon account.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var mailer_details = {
16      mailerid : '1'
17  }
18
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'getMailerReport', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
     "code" => "200", 
     "status":"Success:Mailer Report Details", 
     "Mailer Subject":"Test mailer subject", 
     ["Sent Date":"2014-03-11 16:10", 
          "Report":"April_List", "984", "320", "210", "40", "3",
          "Report":"May_List", "7064", "1601", "901", "208", "49"],
     ["Sent Date":"2014-03-14 16:23", 
          "Report":"June_List", "2080", "1108", "703", "280", "55"] 
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer not sent"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer not sent
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getMailerSpamReport

Description

Get details of Spam reports at mailer

This API allows you to get detailed spam details of mailer which you have sent from your Juvlon Account. To this API, MailerId, Senddate, Startpoint is only mandatory parameter. In return it will provide you details of that mailer which includes email list along with details like spam report date date.

getMailerSpamReport( Int $mailerId, Int $senddate, Int $startpoint, Int $numofrecords, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) ID of mailer that you created in Juvlon account.

 
$senddate Int

(Mandatory) Send Date of mailer from your Juvlon account.

 
$startpoint Int

Startpoint from where you need data

1

 

 
$numofrecords Int

Number of records per request

1000

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13   var mailer_details = {
14       mailerid        : '81',
15       senddate        : '2013-04-03',
16       startpoint      : '1',
17       numofrecords    : '500'
18  }
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'getMailerOptOuts', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
     "code":"200",
     "status":"Success",
     "Spam Details":"[
          "SeqNo":"1","Email":"john@doe.com","spamReportDate":"2014-01-01",
          "SeqNo":"2","Email":"johny@doe.com","spamReportDate":"2014-01-01",
          "SeqNo":"3","Email":"jrjohn@doe.com","spamReportDate":"2014-01-01",
          "SeqNo":"4","Email":"srjohn@doe.com","spamReportDate":"2014-01-01"]"
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer does not exist"
  }

Error-Response

HTTP/1.1
  {
     "code":"442",
     "status":"Error:Invalid senddate format"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
201    Success:No Spams available
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer does not exist
442    Error:Invalid senddate format
443    Error:Invalid start point
444    Error:Invalid Number of records
445    Error:Number of records should be less than 1000
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

mailerComparativeReport

Description

Get Comparative details of two sent mailers

This API allows you to get detailed Comparative report between two already sent mailers from your Juvlon Account. To this API, all the four parameters MailerId1, Senddate1, MailerId2, Senddate2 are mandatory. As output, API will provide you details of those Mailers which includes Mailer Subject, Mail Sent Date and List level details like List Name, Unique Sent Count, Unique Open Count, Unique Click Count, Bounce Count and Optout Count.

mailerComparativeReport( Int $mailerId1, String $sendDate1, Int $mailerId2, String $sendDate2, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId1 Int

(Mandatory) First Mailer ID that you want to compare

 
$sendDate1 String

(Mandatory) Send date of first mailer with format: "YYYY-MM-DD"

 
$mailerId2 Int

(Mandatory) Second Mailer ID that you want to compare with

 
$sendDate2 String

(Mandatory) Send date of second mailer with format: "YYYY-MM-DD"

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var mailer_details = {
16      mailerid1 : '82', 
17      senddate1 : '2014-01-01', // "YYYY-MM-DD"
18      mailerid2 : '91',
19      senddate2 : '2014-02-05'  // "YYYY-MM-DD"
20   }
21  
22  // Send your data to your Juvlon account
23  //
24  call_juvlon_api(apikey, 'getMailerReport', mailer_details, function(response) {
25      document.getElementById('show').innerHTML=response;
26  });
27
28  </script>

Success-Response

HTTP/1.1
  {
    "code" => "200",
    "status":"Success:Mailer Comparative Report Details", 
    ["Sent Date":"2014-01-01 14:34",
               "Mailer Subject":"Mailer1", "Report":"List1", "100", "64", "28", "3", "2",
               "Mailer Subject":"Mailer1", "Report":"List2", "200", "127", "55", "21", "7"], 
    ["Sent Date":"2014-01-02 16:15",
               "Mailer Subject":"Mailer2", "Report":"List3", "1100", "432", "322", "183", "45",
               "Mailer Subject":"Mailer2", "Report":"List4", "3882", "2034", "1223", "232", "43"]
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:MailerID 1 not Exist"
  }

Error-Response

HTTP/1.1
  {
     "code":"442",
     "status":"Error:MailerID 2 not Exist"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer1 does not exist
442    Error:Mailer2 does not exist
443    Error:Invalid send date1 
444    Error:Invalid send date2
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

mailerDomainReport

Description

Get details of domain for sent mailer

This API allows you to get detailed of domain for any specific mailer at your Juvlon Account. To this API, MailerId is only mandatory parameter and it returns details of domain wise subscriber count

mailerDomainReport( Int $mailerId, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) MailerID of mailer you sent from your Juvlon account

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var mailer_details = 
16   {
17     mailerid : '1'
18   }
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'mailerDomainReport', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

    HTTP/1.1
  {
     "code":"200",
     "status":"Success:Domainwise Reporting details",
     "Domainwise Reporting details":
         "["SeqNo":"1", "Domain Name":"domain1.com", "Count":"10",
           "SeqNo":"2", "Domain Name":"domain2.com", "Count":"28"]"
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:While fetching domainwise report details"
  }

Possible-Response-Codes

200    Success:Mailer Report Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:While fetching domainwise report details
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

renameList

Description

Rename an existing Subscriber List

This API allows you to rename an existing Subscriber List Name in your Juvlon Account. This API, expects both OLD Subscriber list name and NEW Subscriber list name as mandatory parameters.

renameList( String $oldListName, String $newListName, ) : String

Arguments

NameTypeDescriptionDefault
$oldListName String

(Mandatory) Existing List Name in juvlon account

 
$newListName String

(Mandatory) New List Name which is to be replaced

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var rename_list_detail = {
16     oldlistname  : 'New_Website_List',
17     newlistname  : 'New_update_list'
18  }
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'renameList', rename_list_detail, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
     "Code":"200",
     "Status":"Success:List name changed"
  }

Error-Response

HTTP/1.1
   {
     "Code":"441",
     "Status":"Error:List name not Exist"
   }

Possible-Response-Codes

200    Success:List name changed
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:List name not Exist
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

scheduleMailer

Description

Schedule a mailer to specific date time

This API allows you to schedule an existing mailer to specific date time from your Juvlon Account. It expects all three parameters Mailer Id, List Name(s), Schedule Date Time (format YYYY-MM-DD HH:MI) as mandatory.

scheduleMailer( String $mailerId, String $listName, String $scheduleDataTime, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId String

(Mandatory) MailerId from your Juvlon account.

 
$listName String

(Mandatory) name of the mailer you want to send.

 
$scheduleDataTime String

(Mandatory) Date and time for scheduling your mailer

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var schedule_mailer_detail = {
16         mailerId         : '108',
17         listname         : 'USClients',
18         scheduleDateTime : '2014-01-01 10:00'  // "YYYY-MM-DD HH:MI"
19  }
20  
21  // Send your data to your Juvlon account
22  //
23  call_juvlon_api(apikey, 'scheduleMailer', schedule_mailer_detail, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
     "code":"200",
     "status":"Success:Mailer scheduled successfully"
   }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Mailer does not exists"
  }

Possible-Error-Codes

200    Success:Mailer scheduled successfully
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mailer does not exists
442    Error:List(s) does not exists
443    Error:Invalid datetime format
444    Error:Passed datetime not allowed
445    Error:Scheduling mailer
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

unsubscribe

Description

Unsubscribe a subscriber

This API allows you to unsubscribe an existing Subscriber from specific campaigns at your Juvlon Account. To this API, eMail Address is only mandatory parameter. If you specify the Campaign Name(s), it will unsubscribe that subscriber from those campaigns ONLY. If you want to deactivate the subscriber permanently, you can leave campaign name parameter blank. Please note that once you deactivate a subscriber, you will not be able to send mails to that subscriber.

If any of the campaign name does not exists, it returns that particular campaign name as "Error 442"./p>

unsubscribe( String $emailId, String $campaignNames, ) : String

Arguments

NameTypeDescriptionDefault
$emailId String

(Mandatory) Email Id of subscriber you want to unsubscribe in your Juvlon account.

 
$campaignNames String

Comma separated Name(s) of campaigns you want to unsubscribe.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var email_details = {
16      email : 'John.Doe@foo.com',
17      campaigns : 'Newsletter, Promotions'
18   }
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'unsubscribe', email_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
   {
     "code":"200",
     "status":"Success: Unsubscribed"
   }

Error-Response

HTTP/1.1
   {
     "code":"441",
     "status":"Error:Subscriber not Exist"
   }

Error-Response

HTTP/1.1
   {
     "code":"442",
     "status":"Error:Campaign not Exist: Newsletter"
   }

Possible-Response-Codes

200    Success: Unsubscribed
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Subscriber not Exist
442    Error:Campaign not Exist (comma separated list of campaigns)
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

sendByABTesting

Description

Send pre-created mailer by AB Testing

This API allows you to send existing mailer using AB Testing from your Juvlon Account. To this API, MailerId1, MailerId2, Criteria, List Name(s), SendDateTime are mandatory parameters and in return it will schedule mailer with details. add a link to AB test documentation Please note that the Criteria can be either "Open" Or "Click"

sendByABTesting( Int $mailerId1, Int $mailerId2, Int $criteria, Int $lists, Int $testQty, Int $scheduleDateTime, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId1 Int

(Mandatory) First MailerId at your Juvlon account

 
$mailerId2 Int

(Mandatory) Second MailerId at your Juvlon account

 
$criteria Int

(Mandatory) Criteria to decide for AB Test "Open" or "Click"

Open

 

 
$lists Int

(Mandatory) List Name(s) to which you want to send mailer

 
$testQty Int

Maximum number of mails for EACH A/B test (maximum 10000)

5000

 

 
$scheduleDateTime Int

Date and Time for scheduling the final mailer

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
04  <script language="javascript">
05  
06  // Replace your API key at below line
07  //
08  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
09  
10  // Form your data object
11  //
12   var mailer_details = {
13       mailerid1        : '87',
14       mailerid2        : '88',
15       criteria         : 'Open',
16       lists            : 'test1,test3',
17       testqty          : '10000',
18       scheduledatetime : '2014-10-30 16:00:00' 
19   }   
20     
21  // Send your data to your Juvlon account
22
23  call_juvlon_api(apikey, 'sendByABTesting', mailer_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
     "code":"200",
     "status":"Success:Mailer sent using AB Testing.",
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:MailerID 1 not Exist"
  }

Error-Response

HTTP/1.1
  {
     "code":"442",
     "status":"Error:MailerID 2 not Exist"
  }

Possible-Response-Codes

200    Success:Mailer sent using AB Testing
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:MailerID 1 not Exist.
442    Error:MailerID 2 not Exist.
443    Error:List(s) not Exist.
444    Error:Invalid test quantity.
445    Error:test quantity should be less than 20000.
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:Mailer details not found.

sendMailer

Description

Send a mailer to List(s)

This API allows you to send an existing mailer to existing list(s) from your Juvlon Account. It expects a Mailer ID and at least one (or more separated by comma) List Name as mandatory parameters.

sendMailer( Int $mailerId, String $listName, ) : String

Arguments

NameTypeDescriptionDefault
$mailerId Int

(Mandatory) ID of mailer created in juvlon account.

 
$listName String

(Mandatory) Name(s) of list(s) from Juvlon account, separated by comma.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var sending_details = {
16     mailerid  : '1',                   //ID of mailer in your Juvlon account
17     listnames : 'TestList1, TestList2' // comma separated multiple list names
18  }
19
20  // Send your data to your Juvlon account
21  //
22
23  call_juvlon_api(apikey, 'sendMailer', sending_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26
27  </script>

Success-Response

HTTP/1.1
  {
     "Code":"200",
     "status":"Success:Mail send request accepted"
  }

Error-Response

HTTP/1.1
  {
     "Code":"402",
     "Error":"Incorrect Mailer ID"
  }

Possible-Response-Codes

200    Success:Mail send request accepted
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Mail credit not available
442    Error:Sending blocked
443    Error:Incorrect Mailer ID
444    Error:Either of List Name not Exist
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:Severe server error. Request not processed

sendSMStoList

Description

Send an SMS to List(s)

This API allows you to send an existing SMS to existing list(s) from your Juvlon Account. It expects a Message ID and one List Name (or more separated by comma) as mandatory parameters.

sendSMStoList( Int $msgid, String $listName, ) : String

Arguments

NameTypeDescriptionDefault
$msgid Int

(Mandatory) ID of message created in juvlon account.

 
$listName String

(Mandatory) Name(s) of list(s) from Juvlon account, separated by comma.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  // 
03 
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06 
07 
08  // Replace your API key at below line
09  // 
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11  
12 
13  // Form your data object
14  //
15  var sending_details = {
16     msgid  : '1',                   //ID of SMS in your Juvlon account
17     listnames : 'TestList1, TestList2' // comma separated multiple list names
18  }
19 
20  // Send your data to your Juvlon account
21  // 
22 
23  call_juvlon_api(apikey, 'sendSMStoList', sending_details, function(response) {
24      document.getElementById('show').innerHTML=response;
25  });
26 
27  </script>

Success-Response

HTTP/1.1
  {
     "Code":"200",
     "status":"Success:SMS send request accepted"
  }

Error-Response

HTTP/1.1
  {
     "Code":"402",
     "Error":"Incorrect Message ID"
  }

Possible-Response-Codes

200    Success:SMS send request accepted
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
441    Error:SMS credits not available
442    Error:Sending blocked
443    Error:Incorrect Message ID
444    Error:Either of List Name not Exist
445    Error:SMS Service not enabled
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later
503    Error:Severe server error. Request not processed

sendSingleSMS

Description

Send an SMS to a single subscriber.

This API allows you to send an instant SMS (usually transactional) to a subscriber in your Juvlon account. You need to have an SMS message pre-created in your Juvlon account. "Mobile number" and "Message ID" of pre-created message are the two mandatory parameters required to use this APIs. In order to send a transaction SMS with your own Sender, the template of message and sender must be pre-approved. If you do NOT specify the List name, the mobile number will be added to a default List called RealTime_Via_API in your Juvlon account. All other parameters can be used to personalize your SMS.

sendSingleSMS( String $email, String $msgid, String $listName, String $prefix, String $firstName, String $middleName, String $lastName, String $telephone, String $address, String $city, String $state, String $pincode, String $country, String $mobile, String $designation, String $company, String $companyPhone, String $birthDate, String $anniversary, String $extra1, String $extra2, ) : String

Arguments

NameTypeDescriptionDefault
$email String

Email address

 
$msgid String

(Mandatory) Existing message id at your Juvlon account

 
$listName String

List name from your Juvlon account

RealTime_Via_API

 

 
$prefix String

Prefix

 
$firstName String

First name

 
$middleName String

Middle name

 
$lastName String

Last name

 
$telephone String

Telephone

 
$address String

Address

 
$city String

City

 
$state String

State

 
$pincode String

Pincode

 
$country String

Country

 
$mobile String

(Mandatory) Mobile

 
$designation String

Designation

 
$company String

Company

 
$companyPhone String

Company phone

 
$birthDate String

Birth date in format "YYYY-MM-DD"

 
$anniversary String

Anniversary date in format "YYYY-MM-DD"

 
$extra1 String

Extra Information 1

 
$extra2 String

Extra Information 2

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var mail_details = {
16      email        : 'John.Doe@foo.com',
17      msgid        : '82',
18      listname     : '',
19      prefix       : '',
20      firstname    : 'John',
21      middlename   : '',
22      lastname     : 'Doe',
23      telephone    : '',
24      address      : '',
25      city         : '',
26      state        : '',
27      pincode      : '',
28      country      : '',
29      mobile       : '9999999999',
30      designation  : '',
31      company      : '',
32      companyphone : '',
33      birthdate    : '',
34      anniversary  : '',
35      extra1       : '',
36      extra2       : ''
37    }
38   // Send your data to your Juvlon account
39   //
40
41   call_juvlon_api(apikey, 'sendSingleSMS', mail_details, function(response) {
42       document.getElementById('show').innerHTML=response;
43   });
44
45   </script>

Success-Response

HTTP/1.1
  {
     "code":200,
     "status":"Request accepted"
  }

Error-Response

HTTP/1.1
  {
     "code":446,
     "status":"Message ID not found"
  }

Possible-Response-Codes

200    Success:Request accepted
201    Subscriber Exists & Request accepted
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:SMS credits not available
442    Error:Invalid request
443    Error:INACTIVE Subscriber
444    Error:Not more than 10 in Test List
445    Error:Invalid List Name
446    Error:Message ID not found
447    Error:SMS Service not enabled
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later

getUsage

Description

Get Usage between dates

This API allows you to get Usage details within two dates from your Juvlon Account. It expects both Start Date and End Date as mandatory parameters. Note, both the dates are inclusive.

getUsage( String $from_date, String $to_date, ) : String

Arguments

NameTypeDescriptionDefault
$from_date String

(Mandatory) Date (format YYYY-MM-DD) from which you want to get usage details.

 
$to_date String

(Mandatory) Date (format YYYY-MM-DD) till which you want to get usage details.

 

Return value

TypeDescription
String Success or Error response in JSON.

Usage / Example(s)

example Code for Integration
01  // Include Juvlon provided Java Script
02  //
03
04  <script language="javascript" src="https://api.juvlon.com/includes/juvlon_api.js" type="text/javascript"> </script>
05  <script language="javascript">
06
07
08  // Replace your API key at below line
09  //
10  var apikey = 'ABCDEFGH1234567890abcdefghQWERTY123=';
11
12
13  // Form your data object
14  //
15  var get_usage_detail = {
16     from_date : '2013-03-14',  // "YYYY-MM-DD"
17     to_date   : '2014-04-21'   // "YYYY-MM-DD"
18  }   
19   
20  // Send your data to your Juvlon account
21  //
22  call_juvlon_api(apikey, 'getUsage', get_usage_detail, function(response) {
23      document.getElementById('show').innerHTML=response;
24  }); 
25
26  </script>

Success-Response

HTTP/1.1
  {
    "code":"200",
    "status":"Success",
    "Usage Details":"["1":"TestMailer1", "Sent Date":"2014-04-21", "Sent Count":"1000",
                      "2":"TestMailer2", "Sent Date":"2014-04-21", "Sent Count":"1900"]"
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Invalid From Date"
  }

Error-Response

HTTP/1.1
  {
     "code":"441",
     "status":"Error:Invalid To Date"
  }

Possible-Error-Codes

200    Success:Usage Details
401    Error:Invalid Method
402    Error:Unauthorized/Empty Key
403    Error:Unauthorized/Invalid Key
404    Error:API call limit exceeded
405    Error:Your Juvlon account is expired
406    Error:API Not Found
407    Error:API Version Not Found
408    Error:API Function not found
441    Error:Invalid From Date
441    Error:Invalid To Date
501    Error:Severe server error. Try later
502    Error:Severe server error. Try later