Introduction

Welcome to the JotUrl API Version i1! This is the right place to find information on how to programmatically interact with the JotUrl interface.

Authentication

Session token

Step 1: acquiring a token

Example

  {PUBLIC_KEY} = "ae7b4635320411fe"

 {PRIVATE_KEY} = "9283c835ef5e21d3"

{GMT_DATETIME} = "2018-11-30T20:04Z"

    {PASSWORD} = HMAC_SHA256({PRIVATE_KEY}, {PUBLIC_KEY} + ':' + {GMT_DATETIME}) =
               = HMAC_SHA256("9283c835ef5e21d3", "ae7b4635320411fe:2018-11-30T20:04Z") =
               = "e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa"

Request

https://joturl.com/a/i1/users/login?username=test@example.com&password=e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa

The above request returns a JSON structured like this:

{
    "status": {
        "code": 200,
        "text": "OK",
        "error": "",
        "rate": 0
    },
    "result": {
        "session_id": "93bed02bf74e191294e22da6272a18a8",
        "datetime": "2018-11-30T20:04Z"
    }
}

Session authentication needs the generation of a session token session_id that is used to sign all other request to the API endpoints.

To generate the session_id you have to make a request (GET or POST) to the API endpoint:

https://joturl.com/a/i1/users/login?username={EMAIL}&password={PASSWORD}

where {EMAIL} is the email you use to login the JotUrl dashaboard and {PASSWORD} is obtained by using an HMAC_SHA256 hash function:

{PASSWORD} = HMAC_SHA256({PRIVATE_KEY}, {PUBLIC_KEY} + ':' + {GMT_DATETIME})

{PUBLIC_KEY} and {PRIVATE_KEY} are your public and private API keys, respectively (API Keys).

Parameter {GMT_DATETIME} is the the GMT date/time in the format YYYY-MM-ddThh:mmZ where:

YYYY is the full numeric representation of the year (4 digits)
MM is the month with leading zeros (01-12)
dd is the day with leading zeros (01-31)
T is the uppercase letter T
hh is the hour with leading zeros (00-23)
mm are the minutes with leading zeros (00-59)
Z is the uppercase letter Z

Parameter {GMT_DATETIME} must be generated on a device as synchronized as possible with the GMT date/time (each request requires a new {GMT_DATETIME}).

The examples in this section return the expected values for the HMAC_SHA256 hash, these values can be used to test the implementation of the HMAC_SHA256 hash you are using.

Step 2: sign API calls

Example

_sid = {session_id} =
     = "93bed02bf74e191294e22da6272a18a8"

  _h = HMAC_SHA256({PRIVATE_KEY}, {session_id} + ':' + {GMT_DATETIME}) =
     = HMAC_SHA256("9283c835ef5e21d3", "93bed02bf74e191294e22da6272a18a8:2018-11-30T20:04Z") =
     = "c9afd295a66bdfd68b2ee5a6c1031ff343d17691d56af17504127cf22d5a9d5b"

Request

https://joturl.com/a/i1/users/info?_sid=93bed02bf74e191294e22da6272a18a8&_h=c9afd295a66bdfd68b2ee5a6c1031ff343d17691d56af17504127cf22d5a9d5b

Response

{
    "status": {
        "code": 500,
        "text": "INVALID session",
        "error": "",
        "rate": 0
    },
    "result": []
}

Every request to API endpoints have to be signed with the parameters _sid and _h. Where _sid is the session token {session_id} obtained in step 1 and _h is generated with the same method used for the {PASSWORD} parameter in step 1:

_h = HMAC_SHA256({PRIVATE_KEY}, {session_id} + ':' + {GMT_DATETIME})

Parameter {GMT_DATETIME} is obtained in the same way and follows the same rules as in step 1.

The examples in this section return the expected values for the HMAC_SHA256 hash, these values can be used to test the implementation of the HMAC_SHA256 hash you are using.

You can also send parameters _sid and _h in the request headers BUT they become sid and h respectively.

The session token

The session token session_id expires approximately every 30 days, but may expire sooner due to various factors and if you call the API method users/logout.

As a best practice, we suggest you to continue to use it until you get an "INVALID session" error response from the API endpoint. In this case, you have to restart the authentication procedure from the beginning.

Examples

The examples in this section return the expected values for the HMAC_SHA256 hash, these values can be used to test the implementation of the HMAC_SHA256 hash you are using. You can find SDKs and examples here.

PHP

PHP example.

<?php

function HMAC_SHA256( $private_key, $message, $time = null ) {
    return hash_hmac(
        'sha256',
        $message . ':' . ( $time ?: gmdate( "Y-m-d\TH:i\Z", time() ) ), 
        $private_key 
    );
}

$public_key = "ae7b4635320411fe";
$private_key = "9283c835ef5e21d3";
$gmt_datetime = "2018-11-30T20:04Z";

// e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
echo HMAC_SHA256( $private_key, $public_key, $gmt_datetime );

Python

Python example.

# coding: utf8
import sys
import hmac
import hashlib

try:
    def HMAC_SHA256(private_key="", message="", time=""):
        message += ":"

        if time:
            message += str(time)
        else:
            message += str(datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%MZ'))

        return hmac.new(str.encode(private_key), str.encode(message), hashlib.sha256).hexdigest()

    public_key = "ae7b4635320411fe"
    private_key = "9283c835ef5e21d3"
    gmt_datetime = "2018-11-30T20:04Z"

    # e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
    print(HMAC_SHA256(private_key, public_key, gmt_datetime))

except Exception as t:
    print(t)
    sys.exit(0)
# end try

NodeJS

NodeJS example.

const crypto = require('crypto');

try {
    function gmdate() {
        var iso = (new Date()).toISOString();

        return iso.substr(0, iso.length - 8) + 'Z';
    }

    function create_sha256(key, message) {
        var hmac = crypto.createHmac('sha256', key);
        hmac.update(message);

        return hmac.digest('hex');
    }

    function HMAC_SHA256(private_key, message, time) {
        var msg = message + ":" + (time ? time : gmdate());

        return create_sha256(private_key, msg);
    }

    var public_key = "ae7b4635320411fe";
    var private_key = "9283c835ef5e21d3";
    var gmt_datetime = "2018-11-30T20:04Z";

    // e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
    console.log(HMAC_SHA256(private_key, public_key, gmt_datetime));

} catch (e) {
    console.log(e.message);
}

Java

Java example.

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.security.NoSuchAlgorithmException;
import java.security.InvalidKeyException;
import java.text.SimpleDateFormat;
import java.util.Locale;
import java.util.Date;
import java.util.TimeZone;

public class HMAC_SHA256_EXAMPLE {

  public static String gmdate() {
    String pattern = "yyy-MM-dd'T'HH:mm'Z'";
    SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
    simpleDateFormat.setTimeZone(TimeZone.getTimeZone("UTC"));

    return simpleDateFormat.format(new Date());
  }

  public static String hex(byte[] bytes) {
    StringBuilder result = new StringBuilder();
    for (byte aByte: bytes) {
      result.append(String.format("%02x", aByte));
    }

    return result.toString();
  }

  public static String HMAC_SHA256(String private_key, String message, String date_time)
        throws NoSuchAlgorithmException, InvalidKeyException {
    Mac sha256_HMAC = Mac.getInstanceNumber("HmacSHA256");
    SecretKeySpec secret_key = new SecretKeySpec(private_key.getBytes(), "HmacSHA256");
    sha256_HMAC.initClient(secret_key);

    return hex(sha256_HMAC.doFinal((message + ":" + date_time).getBytes()));
  }

  public static String HMAC_SHA256(String private_key, String message)
        throws NoSuchAlgorithmException, InvalidKeyException {
    return HMAC_SHA256(private_key, message, gmdate());
  }

  public static void main(String[] args) {
    try {
      String public_key = "ae7b4635320411fe";
      String private_key = "9283c835ef5e21d3";
      String date_time = "2018-11-30T20:04Z";

      // e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
      System.out.println(HMAC_SHA256(private_key, public_key, date_time));
    }
    catch(Exception e) {
      System.out.println("Error");
    }
  }
}

C

C# example.

using System;
using System.Security.Cryptography;
using System.Text;

namespace HMAC_SHA256_EXAMPLE
{
    class Program
    {
        public static string gmdate()
        {
            return DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mmZ");
        }

        public static string hex(byte[] ba)
        {
            StringBuilder hex = new StringBuilder(ba.Length * 2);

            foreach (byte b in ba)
            {
                hex.AppendFormat("{0:x2}", b);
            }

            return hex.ToString();
        }

        private static string HMAC_SHA256(string private_key, string message, string time = "")
        {
            var hash = new HMACSHA256(Encoding.ASCII.GetBytes(private_key));

            return hex(hash.ComputeHash(Encoding.ASCII.GetBytes(message + ":" + (time ?? gmdate()))));
        }

        static void Main(string[] args)
        {
            var public_key = "ae7b4635320411fe";
            var private_key = "9283c835ef5e21d3";
            var gmt_datetime = "2018-11-30T20:04Z";

            // e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
            Console.WriteLine(HMAC_SHA256(private_key, public_key, gmt_datetime));
        }
    }
}

Flutter (Dart)

Flutter (Dart) example.

import 'dart:convert';
import 'package:crypto/crypto.dart';

void main() {
  String public_key = 'ae7b4635320411fe';
  String private_key = '9283c835ef5e21d3';
  String gmt_datetime = '2018-11-30T20:04Z';

  // e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
  print(HMAC_SHA256(private_key, public_key, gmt_datetime));
}

String gmdate() {
  String iso = DateTime.now().toUtc().toIso8601String();

  return iso.substring(0, 16) + 'Z';
}

String create_sha256(String key, String message) {
  var hmacSha256 = new Hmac(sha256, utf8.encode(key));
  var digest = hmacSha256.convert(utf8.encode(message));

  return digest.toString();
}

String HMAC_SHA256(String private_key, String message, [String time = '']) {
  String msg = message + ":" + (!time.isEmpty ? time : gmdate());

  return create_sha256(private_key, msg);
}

Token authentication

Token authentication (also called bearer authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens.

Step 1: acquiring a token

Request

https://joturl.com/a/i1/apis/tokens

The above request returns a JSON structured like this:

{
    "status": {
        "code": 200,
        "text": "OK",
        "error": "",
        "rate": 0
    },
    "result": {
        "read_write_token": "tok_RWxtd74zqlcv18d6qiau75kr1bwpagqbq5",
        "read_only_token": "tok_RO064cmpvzcsxc5ufg0xzx58ms3q15bn10"
    }
}

API tokens authentication needs a read-only or read/write token that is used to sign all other request to the API endpoints. API tokens do not expire and can be reset using the endpoint apis/tokens.

To get API tokens you have to make a request (GET or POST) to the endpoint:

https://joturl.com/a/i1/users/tokens

you must already be logged in using the session token.

Step 2: sign API calls

Every request to API endpoints have to be signed with the Authorization HTTP header:

Authorization: Bearer {token}

where {token} is one of the API tokens obtained in step 1.

With the read-only token you can only call endpoints with access [read].

You can find the required access of each endpoint immediately below the endpoint itself in this documentation.

Input requests

Example

https://joturl.com/a/i1/urls/shorten?long_url=https%3A%2F%2Fwww.joturl.com%2F&alias=jot

Parameters to each JotUrl API can be passed both with the GET and POST methods.

Output formats

Query

format=json

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 87
  },
  "result": {DATA}
}

Query

format=jsonp&callback=clbfunc

Response

clbfunc({
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 87
  },
  "result": {DATA}
})

Query

format=jsonp

Response

{
  "status": {
    "code": 500,
    "text": "MISSING callback",
    "error": "",
    "rate": 21
  },
  "result": []
}

Query

format=xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>87</rate>  
  </status>  
  <result>{DATA}</result>  
</response>

Query

format=txt

Response

status_code=200
status_text=OK
status_error=
status_rate=87
result={DATA}

Query

format=plain

Response

{DATA}

The JotUrl API supports Cross Origin Resource Sharing (CORS) requests from any domain.

All JotUrl APIs support five return formats: json, jsonp, xml, txt, plain. Note that the formats txt and plain may return only limited information.

The default output format is format = json that is also used when the parameter format is invalid (e.g., format = jsonp but no callback parameter is specified).

When format = plain, check the HTTP response status for problems with the request, rate limiting, or other errors.

Rate limits

If the rate limits are exceeded, the call fails and returns a 403 status code, with a LIMIT EXCEEDED status text (see Output formats for details).

Typical response

{
    "status": {
        "code": <STATUS CODE>,
        "text": "<STATUS TEXT>",
        "error": "<STATUS ERROR>",
        "rate": <REQUESTS PER SECOND>
    },
    "result": <DATA>
}

If you send requests too quickly, make sure that the rate parameter in the status response is below the rate limits set for your account. The rate parameter is always expressed in requests per second. If you exceed the limits set for your account, our engine may block your requests for a time directly proportional to the speed with which you are sending the requests: the greater the gap with your rate limits, the greater the blocking time. Finally, if you do not fall within your rate limits for a long time, our engine could permanently block any further requests.

QR-Codes

A QR-Code is provided for each shorten URL. To generate it append .qrcode or .qr to the end of any shortened link. For example: http://jo.my/jotvideo.qrcode, http://jo.my/jotvideo.qr

Errors

For each request the status code is equal to the HTTP response status that can be:

code	text	error	explanation
200	OK		successful request
403	LIMIT EXCEEDED	details on the error if available	rate limit exceeded
404	NOT FOUND	details on the error if available	the query is well-formed but there is no available response
405	METHOD NOT ALLOWED	details on the error if available	the endpoint is not available to the calling user
414	Request-URI Too Large	details on the error if available	GET request contains long query information, use a POST request instead
500	INVALID [PARAMETER]	details on the error if available	invalid parameter [PARAMETER] in the request
	INVALID METHOD [METHOD]	details on the error if available	invalid method [METHOD]
	MISSING [ARGUMENT]	details on the error if available	the required argument [ARGUMENT] is missing in the request
503	GENERIC ERROR	details on the error if available	a generic error occurred and/or the service is temporarily unavailable ¹

¹ A GENERIC ERROR (503) is also issued in all those cases where a parameter has passed all validation checks, but for some reason our engine cannot use it to complete the request. For example, if you try to create a tracking link with the alias $alias you will see the error INVALID alias (500), since the alias $alias contains the forbidden character $, but if you try to create a tracking link with the alias alias and it is already have been used, you will see the error GENERIC ERROR (503) and the error field of the output status will be "The chosen alias is not available".

Parameters types

API endpoints require some parameters to be sent as part of the request. Most parameters are simple strings, but some endpoints require other types to be provided.

type	description	example
string	sequence of alphanumeric text or other symbols	hamburger
id	variable length string obtained as a result of an API call	62613864764b3762725a343966673d3d
array	comma separated list of type string, a maximum of 100 items are allowed	hamburger, test
array_of_ids	comma separated list of type id, a maximum of 100 items are allowed	62613864764b375a343966673d3d, 86590152f1891e680, 5952b26623c9b47ad9e
integer	integer	12
float	float with . (point) as a decimal separator	12.34
boolean	boolean parameter, accepted values are true, false, on, off, 1, 0	1
date	date in the format yyyy-mm-dd (UTC)	2019-06-04
datetime	date/time in the format yyyy-mm-dd hh:mm:ss (UTC)	2019-06-04 19:21:34
json	stringified JSON object or associative array	{"test":"check"}, param[test]=check
enum	is a string with a value chosen from a list of allowed values	remarketing

JotUrl SDKs

JotUrl SDKs help you develop apps, websites and plugins that relies on all the functionality of our APIs. We currently support PHP, Python, Java and NodeJS, but you can easily integrate our APIs with all development technologies.

PHP SDK

Click here to download the SDK for PHP with an example included.

PHP example

<?php

// replace [your login] with the email you use to login into JotUrl
define( 'SDK_USER_NAME', '[your login]' );
// replace [public key] with your public key: https://www.joturl.com/reserved/settings.html#tools-api
define( 'SDK_PUBLIC_API_KEY', '[public key]' );
// replace [private key] with your private key: https://www.joturl.com/reserved/settings.html#tools-api
define( 'SDK_PRIVATE_API_KEY', '[private key]' );

require_once 'sdk/JotUrlSDK.php';

try {
    // create an instance of JotUrlSDK
    $joturl = new JotUrlSDK( SDK_USER_NAME, SDK_PUBLIC_API_KEY, SDK_PRIVATE_API_KEY );

    $joturl->wrapper( function ( $sdk ) {
        // get logged user information
        $url = $sdk->buildURL( 'users/info' );
        echo "Getting user info" . PHP_EOL;
        $result = $sdk->call( $url );
        echo "====== USER INFO ======" . PHP_EOL;
        print_r( $result );
    } );

    $joturl->wrapper( function ( $sdk ) {
        // get first 5 projects
        $url = $sdk->buildURL( 'projects/list', array( "fields" => "id,name", "length" => 5 ) );
        echo "Getting first 5 projects (if available)" . PHP_EOL;
        $result = $sdk->call( $url );
        echo "====== PROJECTS ======" . PHP_EOL;
        print_r( $result );
    } );
} catch ( Throwable $t ) {
    die( $t->getMessage() );
}

Documentation

<?php

/**
 * Creates an instance of the JotUrl SDK.
 *
 * @param string $username    the username used to login into JotURL dashboard
 * @param string $public_key  public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 * @param string $private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 */
new JotUrlSDK( $username, $public_key, $private_key );

/**
 * Automatically try to access the JotURL API, the callback is called if the access is successful.
 *
 * @param mixed $callback callback to be called on success
 *
 * @return mixed value returned by the $callback function, an exception is thrown on error
 */
function wrapper( $callback );

/**
 * Given an endpoint and parameters (optional) returns the URL to be called.
 *
 * @param string $endpoint   endpoint to be called
 * @param array  $parameters associative array [param => value]
 *
 * @return string the URL to be called
 */
function buildURL( $endpoint, $parameters = array() );

/**
 * Call and get results from the API endpoint.
 *
 * @param string $url            URL to be called
 * @param array  $postParameters [OPTIONAL] array containing post parameters
 *
 * @return bool|array associative array containing the result of the call
 */
function call( $url, $postParameters = array() );

Python SDK

Click here to download the SDK for Python 3+ with an example included.

Python example

# coding: utf8
import sys
from sdk.JotUrlSDK import JotUrlSDK

# replace [your login] with the email you use to login into JotUrl
SDK_USER_NAME = "[your login]"
# replace [public key] with your public key: https://www.joturl.com/reserved/settings.html#tools-api
SDK_PUBLIC_API_KEY = "[public key]"
# replace [private key] with your private key: https://www.joturl.com/reserved/settings.html#tools-api
SDK_PRIVATE_API_KEY = "[private key]"

try:
    # create an instance of JotUrlSDK
    joturl = JotUrlSDK(SDK_USER_NAME, SDK_PUBLIC_API_KEY, SDK_PRIVATE_API_KEY)

    def getUserInfo(sdk):
        # get logged user information
        url = sdk.buildURL("users/info")
        print("Getting user info")
        result = sdk.call(url)
        print("====== USER INFO ======")
        print(result)

    joturl.wrapper(getUserInfo)

    def getProjectsList(sdk):
        # get first 5 projects
        url = sdk.buildURL("projects/list", {"fields": "id,name", "length": 5})
        print("Getting first 5 projects (if available)")
        result = sdk.call(url)
        print("====== PROJECTS ======")
        print(result)

    joturl.wrapper(getProjectsList)

    def getProjectsListWithPOSTRequest(sdk):
        # get first 5 projects
        url = sdk.buildURL("projects/list")
        print("Getting first 5 projects (if available) with a POST request")
        result = sdk.call(url, {"fields": "id,name", "length": 5})
        print("====== PROJECTS ======")
        print(result)

    joturl.wrapper(getProjectsListWithPOSTRequest)
except Exception as t:
    print(t)
    sys.exit(0)
# end try

Documentation

""" 
Creates an instance of the JotUrl SDK.

@param username    the username used to login into JotURL dashboard
@param public_key  public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
@param private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
"""
def __init__(self, username="", public_key="", private_key=""):

"""
Automatically try to access the JotURL API, the callback is called if the access is successful.

@param callback callback to be called on success

returns True on success, raises an exception on error
"""
def wrapper(self, callback=None):

"""
Given an endpoint and parameters (optional) returns the URL to be called.

@param endpoint   endpoint to be called
@param parameters associative array [param => value]

returns the URL to be called
"""
def buildURL(self, endpoint="", parameters={}):

"""
Call and get results from the API endpoint.

@param url            URL to be called
@param postParameters [OPTIONAL] array containing post parameters

returns bool|array JSON containing the result of the call, false on failure, raises an exception on error 
"""
def call(self, url="", postParameters={}):

NodeJS SDK

Click here to download the SDK for NodeJS with an example included.

NodeJS example

// replace [your login] with the email you use to login into JotUrl
const SDK_USER_NAME = '[your login]';

// replace [public key] with your public key: https://www.joturl.com/reserved/settings.html#tools-api
const SDK_PUBLIC_API_KEY = '[public key]';

// replace [private key] with your private key: https://www.joturl.com/reserved/settings.html#tools-api
const SDK_PRIVATE_API_KEY = '[private key]';

try {
    // create an instance of JotUrlSDK
    let joturl = require('./sdk/JotUrlSDK.js')(SDK_USER_NAME, SDK_PUBLIC_API_KEY, SDK_PRIVATE_API_KEY);

    // get logged user information
    console.log("Getting user info");
    joturl.call('users/info').then(result => {
        console.log(result);

        /* get first 5 projects */
        console.log("Getting first 5 projects (if available)");
        joturl.call('projects/list', {"fields": "id,name", "length": 5}).then(result => {
            console.log(result);
        }).catch(e => {
            console.log(e.message);
        });
    }).catch(e => {
        console.log(e.message);
    });
} catch (e) {
    console.log(e.message);
}

Documentation

/**
 * Creates an instance of the JotUrl SDK.
 *
 * @param _username the username used to login into JotURL dashboard
 * @param _public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 * @param _private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 * @param base_url the base URL to be use to call API endpoints, defaults to https://joturl.com/a/i1/
 *
 * @returns {JotUrlSDK}
 */
require('JotUrlSDK')(_username, _public_key, _private_key, base_url);

/**
 * Call and get results from the API endpoint.
 *
 * @param endpoint API endpoint to be called
 * @param parameters [OPTIONAL] parameters to be passed to the call
 * @param postParameters [OPTIONAL] post parameters to be passed to the call
 *
 * @returns {Promise}
 */
function call(endpoint, parameters = {}, postParameters = {});

Java SDK

Click here to download the SDK for Java with an example included.

Java example

import joturlsdk.JotUrlRunnable;
import joturlsdk.JotUrlSDK;

public class JotUrlExample {

    public static void main(String[] args) {
        try {
            JotUrlSDK sdk = new JotUrlSDK("[username]", "[public_key]", "[private_key]");

            sdk.call("users/info", new JotUrlRunnable() {
                public void run() {
                    System.out.println(this.result);
                }
            });
        } catch (Exception e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

Documentation

/**
 * Creates an instance of the JotUrl SDK.
 *
 * @param _username the username used to login into JotURL dashboard
 * @param _public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 * @param _private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 *
 * @returns {JotUrlSDK}
 */
JotUrlSDK sdk = new JotUrlSDK(_username, _public_key, _private_key);

/**
 * Call and get results from the API endpoint.
 *
 * @param endpoint API endpoint to be called
 * @param parameters parameters to be passed to the call (null to ignore)
 * @param postParameters post parametersto be passed to the call (null to ignore)
 *
 */
JotUrlSDK.call(String endpoint, JotUrlRunnable callback, Map<String, String> parameters, Map<String, String> postParameters);
JotUrlSDK.call(String endpoint, JotUrlRunnable callback);
JotUrlSDK.callGET(String endpoint, Map<String, String> parameters, JotUrlRunnable callback);
JotUrlSDK.callPOST(String endpoint, Map<String, String> postParameters, JotUrlRunnable callback);

Flutter SDK

Click here to download the SDK for Flutter with an example included.

Dart example

import 'package:joturlsdk/joturlsdk.dart';

void main() async {
  final String username = '[username]';
  final String public_key = '[public_key]';
  final String private_key = '[private_key]';

  try {
    JotUrlSDK sdk = new JotUrlSDK(username, public_key, private_key);

    dynamic result = await sdk.call("users/info");

    print('result: ' + result.toString());
  } catch (e) {
    print("Error: " + e.toString());
  }
}

Documentation

/**
 * Creates an instance of the JotUrl SDK.
 *
 * @param _username the username used to login into JotURL dashboard
 * @param _public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 * @param _private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
 * @param base_url the base URL to be use to call API endpoints, defaults to https://joturl.com/a/i1/
 *
 * @returns JotUrlSDK
 * @constructor
 */
JotUrlSDK sdk = new JotUrlSDK(_username, _public_key, _private_key);

/**
 * Call and get results from the API endpoint.
 *
 * @param endpoint API endpoint to be called
 * @param getParameters query parameters to be passed to the call (null to ignore)
 * @param postParameters post parametersto be passed to the call (null to ignore)
 *
 */
sdk.call(endpoint, {Map<String, dynamic> getParameters = null, Map<String, dynamic> postParameters = null});

API reference

/decode

access: [READ]

This method converts API error codes into a friendly text message (in the current user language).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/decode?code=10

Query parameters

code = 10

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "message": "An error occurred while deleting the QR codes of a URL"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/decode?code=10&format=xml

Query parameters

  code = 10
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <message>An error occurred while deleting the QR codes of a URL</message>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/decode?code=10&format=txt

Query parameters

  code = 10
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_message=An error occurred while deleting the QR codes of a URL

Example 4 (plain)

Request

https://joturl.com/a/i1/decode?code=10&format=plain

Query parameters

  code = 10
format = plain

Response

An error occurred while deleting the QR codes of a URL

Required parameters

parameter	description
codeSTRING	numeric code representing the error message

Return values

parameter	description
lang	language in which the message is
message	decoded text message

/timestamp

access: [READ]

This method returns the current server timestamp (UTC) with microseconds as float.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/timestamp

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "timestamp": 1779804032.4097
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/timestamp?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <timestamp>1779804032.4097</timestamp>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/timestamp?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_timestamp=1779804032.4097

Example 4 (plain)

Request

https://joturl.com/a/i1/timestamp?format=plain

Query parameters

format = plain

Response

1779804032.4097

Return values

parameter	description
timestamp	the current Unix timestamp with microseconds

/translate

access: [READ]

This method translates an error codes into a friendly text message.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/translate?code=sample_message&lang=en

Query parameters

code = sample_message
lang = en

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "text": "This is a sample error message",
    "lang": "en"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/translate?code=sample_message&lang=en&format=xml

Query parameters

  code = sample_message
  lang = en
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <text>This is a sample error message</text>  
    <lang>en</lang>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/translate?code=sample_message&lang=en&format=txt

Query parameters

  code = sample_message
  lang = en
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_text=This is a sample error message
result_lang=en

Example 4 (plain)

Request

https://joturl.com/a/i1/translate?code=sample_message&lang=en&format=plain

Query parameters

  code = sample_message
  lang = en
format = plain

Response

This is a sample error message
en

Required parameters

parameter	description
codeSTRING	string code representing the error message

Optional parameters

parameter	description
langSTRING	language in which you want to translate the message

Return values

parameter	description
lang	language in which the message is
text	text message corresponding to code

/apis

/apis/accepted

access: [WRITE]

This method returns the actual result from an accepted (202) API endpoint.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/accepted

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": []
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/accepted?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>

  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/accepted?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result=

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/accepted?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/apis/accepted?_accepted_id=17f9e499ea127daa9030be7bad582897

Query parameters

_accepted_id = 17f9e499ea127daa9030be7bad582897

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "_accepted_id": "17f9e499ea127daa9030be7bad582897",
    "_accepted_key": "method_id",
    "_accepted_perc": 0,
    "_accepted_count": 0,
    "_accepted_total": 0,
    "_accepted_errors": 0,
    "_accepted_dt": "2026-05-26 14:00:30"
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/apis/accepted?_accepted_id=17f9e499ea127daa9030be7bad582897&format=xml

Query parameters

_accepted_id = 17f9e499ea127daa9030be7bad582897
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <_accepted_id>17f9e499ea127daa9030be7bad582897</_accepted_id>  
    <_accepted_key>method_id</_accepted_key>  
    <_accepted_perc>0</_accepted_perc>  
    <_accepted_count>0</_accepted_count>  
    <_accepted_total>0</_accepted_total>  
    <_accepted_errors>0</_accepted_errors>  
    <_accepted_dt>2026-05-26 14:00:30</_accepted_dt>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/apis/accepted?_accepted_id=17f9e499ea127daa9030be7bad582897&format=txt

Query parameters

_accepted_id = 17f9e499ea127daa9030be7bad582897
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result__accepted_id=17f9e499ea127daa9030be7bad582897
result__accepted_key=method_id
result__accepted_perc=0
result__accepted_count=0
result__accepted_total=0
result__accepted_errors=0
result__accepted_dt=2026-05-26 14:00:30

Example 8 (plain)

Request

https://joturl.com/a/i1/apis/accepted?_accepted_id=17f9e499ea127daa9030be7bad582897&format=plain

Query parameters

_accepted_id = 17f9e499ea127daa9030be7bad582897
      format = plain

Response

17f9e499ea127daa9030be7bad582897
method_id
0
0
0
0
2026-05-26 14:00:30

Optional parameters

parameter	description
_accepted_idID	ID returned by the accepted (202) API endpoint
stop_taskBOOLEAN	1 to stop the background task, _accepted_id is mandatory if stop_task is 1

Return values

parameter	description
_accepted_count	[OPTIONAL] completed subtasks (e.g., the number of imported tracking links)
_accepted_dt	[OPTIONAL] starting date/time of the task
_accepted_errors	[OPTIONAL] total number of subtasks not completed correctly (e.g., the number of tracking links for which the import has failed)
_accepted_id	[OPTIONAL] ID of the task started by the accepted (202) API endpoint
_accepted_key	[OPTIONAL] key that uniquely identifies the accepted (202) API endpoint that started the task
_accepted_perc	[OPTIONAL] percentage of completition of the task
_accepted_total	[OPTIONAL] total number of subtasks (e.g., the total number of tracking links to be imported)
data	[OPTIONAL] data returned at the end of the task from the accepted (202) API endpoint
stopped	[OPTIONAL] 1 if the task has been stopped, 0 otherwise, returned only if stop_task is 1

Returned fields depend on input parameters and the status of background tasks:

without passing _accepted_id and stop_task, this method returns an empty result if no background task is active, otherwise it returns information on current background task (_accepted_count, _accepted_dt, _accepted_errors, _accepted_id, _accepted_key, _accepted_perc, _accepted_total),
if stop_task = 1, _accepted_id is mandatory and this method returns stopped = 1 if the current background task was interrupted, 0 if there is no background task or if an error occurred during its interruption,
if _accepted_id is passed and the current background task has not been completed, an empty result is returned if the current background task has reached the timeout (24 hours), otherwise it returns information on the current background task (_accepted_count, _accepted_dt, _accepted_errors, _accepted_id, _accepted_key, _accepted_perc, _accepted_total),
data is returned if _accepted_id is passed and the current background task has been completed; the data returned depends on the method that started the background task, please refer to its documentation for more details.

/apis/has_access

access: [READ]

User permissions can remove access to this version of the API. This method returns 1 only if the user has access to this version of the API.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/has_access

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "has_access": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/has_access?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <has_access>0</has_access>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/has_access?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_has_access=0

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/has_access?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
has_access	1 if the user has access to this API version, 0 otherwise

/apis/keys

access: [WRITE]

This method returns the API keys associated to the logged in user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/keys

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "public": "f81881953038f06355f388a710940c29",
    "private": "90f4581d317836c85ca6301f82165f22"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/keys?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <public>f81881953038f06355f388a710940c29</public>  
    <private>90f4581d317836c85ca6301f82165f22</private>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/keys?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_public=f81881953038f06355f388a710940c29
result_private=90f4581d317836c85ca6301f82165f22

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/keys?format=plain

Query parameters

format = plain

Response

f81881953038f06355f388a710940c29
90f4581d317836c85ca6301f82165f22

Example 5 (json)

Request

https://joturl.com/a/i1/apis/keys?password=p9pd33opoc&reset=1

Query parameters

password = p9pd33opoc
   reset = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "public": "5ece2fec53a45c2ae2a99d32b75541d6",
    "private": "96def8b75993b0698192a6f88cf2cc37"
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/apis/keys?password=p9pd33opoc&reset=1&format=xml

Query parameters

password = p9pd33opoc
   reset = 1
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <public>5ece2fec53a45c2ae2a99d32b75541d6</public>  
    <private>96def8b75993b0698192a6f88cf2cc37</private>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/apis/keys?password=p9pd33opoc&reset=1&format=txt

Query parameters

password = p9pd33opoc
   reset = 1
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_public=5ece2fec53a45c2ae2a99d32b75541d6
result_private=96def8b75993b0698192a6f88cf2cc37

Example 8 (plain)

Request

https://joturl.com/a/i1/apis/keys?password=p9pd33opoc&reset=1&format=plain

Query parameters

password = p9pd33opoc
   reset = 1
  format = plain

Response

5ece2fec53a45c2ae2a99d32b75541d6
96def8b75993b0698192a6f88cf2cc37

Optional parameters

parameter	description
passwordSTRING	current account password, to be sent if `reset = 1`
resetBOOLEAN	1 to reset API keys, if this parameter is 1 the POST method is required (because the password is sent)

Return values

parameter	description
private	the user private API key
public	the user public API key

/apis/lab

/apis/lab/add

access: [WRITE]

This method adds a new LAB script.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B

Query parameters

  name = test script
script = LogManager.log('script');

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "test script",
    "script": "LogManager.log('script');",
    "id": "b4a1d35e02edba8beac1223acd7a41a3",
    "creation": "2026-05-26 14:00:30"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B&format=xml

Query parameters

  name = test script
script = LogManager.log('script');
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>test script</name>  
    <script>LogManager.log('script');</script>  
    <id>b4a1d35e02edba8beac1223acd7a41a3</id>  
    <creation>2026-05-26 14:00:30</creation>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B&format=txt

Query parameters

  name = test script
script = LogManager.log('script');
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=test script
result_script=LogManager.log('script');
result_id=b4a1d35e02edba8beac1223acd7a41a3
result_creation=2026-05-26 14:00:30

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B&format=plain

Query parameters

  name = test script
script = LogManager.log('script');
format = plain

Response

test script
LogManager.log('script');
b4a1d35e02edba8beac1223acd7a41a3
2026-05-26 14:00:30

Required parameters

parameter	description
nameSTRING	LAB script name
scriptHTML	LAB script content

Return values

parameter	description
creation	creation date/time of the LAB script
id	ID of the LAB script
name	LAB script name (max length: 100000 bytes)

/apis/lab/count

access: [READ]

This method returns the number of LAB scripts.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/lab/count?search=a

Query parameters

search = a

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/lab/count?search=a&format=xml

Query parameters

search = a
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/lab/count?search=a&format=txt

Query parameters

search = a
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/lab/count?search=a&format=plain

Query parameters

search = a
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/apis/lab/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 67
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/apis/lab/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>67</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/apis/lab/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=67

Example 8 (plain)

Request

https://joturl.com/a/i1/apis/lab/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	filter LAB scripts by searching them

Return values

parameter	description
count	total number of LAB scripts, filtered by search: if passed

/apis/lab/delete

access: [WRITE]

This method deletes LAB scripts by using the parameter ids.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f

Query parameters

ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f&format=xml

Query parameters

   ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>2</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f&format=txt

Query parameters

   ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=2

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f&format=plain

Query parameters

   ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df

Query parameters

ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df&format=xml

Query parameters

   ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df&format=txt

Query parameters

   ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df&format=plain

Query parameters

   ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
format = plain

Response

18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of LAB script IDs to be deleted, max number of IDs in the list: 100

Return values

parameter	description
deleted	number of deleted scripts

/apis/lab/edit

access: [WRITE]

This method edits a LAB script.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/lab/edit?id=e5fcc8ab20c789cf57a4ad576702e1f3&name=test+script

Query parameters

  id = e5fcc8ab20c789cf57a4ad576702e1f3
name = test script

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "e5fcc8ab20c789cf57a4ad576702e1f3",
    "name": "test script",
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/lab/edit?id=e5fcc8ab20c789cf57a4ad576702e1f3&name=test+script&format=xml

Query parameters

    id = e5fcc8ab20c789cf57a4ad576702e1f3
  name = test script
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>e5fcc8ab20c789cf57a4ad576702e1f3</id>  
    <name>test script</name>  
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/lab/edit?id=e5fcc8ab20c789cf57a4ad576702e1f3&name=test+script&format=txt

Query parameters

    id = e5fcc8ab20c789cf57a4ad576702e1f3
  name = test script
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=e5fcc8ab20c789cf57a4ad576702e1f3
result_name=test script
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/lab/edit?id=e5fcc8ab20c789cf57a4ad576702e1f3&name=test+script&format=plain

Query parameters

    id = e5fcc8ab20c789cf57a4ad576702e1f3
  name = test script
format = plain

Response

e5fcc8ab20c789cf57a4ad576702e1f3
test script
1

Required parameters

parameter	description
idID	ID of the LAB script to edit

Optional parameters

parameter	description
nameSTRING	LAB script name
scriptHTML	content of the LAB script

Return values

parameter	description
updated	1 on success, 0 otherwise

/apis/lab/info

access: [READ]

This method returns info about a LAB script.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/lab/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    {
      "id": "9f930731d05c1f4c00ae68d100dc90fa",
      "name": "script name 0",
      "creation": "2026-05-26 14:11:31",
      "script": "LogManager.log('script 0');"
    },
    {
      "id": "5458d5d57d1d7c02772e7e2b77b3adce",
      "name": "script name 1",
      "creation": "2026-05-26 14:21:05",
      "script": "LogManager.log('script 1');"
    },
    {
      "id": "3b35b131314101d0c07129f0e916854c",
      "name": "script name 2",
      "creation": "2026-05-26 14:30:35",
      "script": "LogManager.log('script 2');"
    },
    {
      "id": "144bbf19ad2afc11b2c6a23c959df46c",
      "name": "script name 3",
      "creation": "2026-05-26 15:42:20",
      "script": "LogManager.log('script 3');"
    },
    {
      "id": "60d7c747074b26cf7665a8ec6dfdfc27",
      "name": "script name 4",
      "creation": "2026-05-26 19:12:48",
      "script": "LogManager.log('script 4');"
    }
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/lab/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>
      <id>9f930731d05c1f4c00ae68d100dc90fa</id>  
      <name>script name 0</name>  
      <creation>2026-05-26 14:11:31</creation>  
      <script>LogManager.log('script 0');</script>  
    </i0>  
    <i1>
      <id>5458d5d57d1d7c02772e7e2b77b3adce</id>  
      <name>script name 1</name>  
      <creation>2026-05-26 14:21:05</creation>  
      <script>LogManager.log('script 1');</script>  
    </i1>  
    <i2>
      <id>3b35b131314101d0c07129f0e916854c</id>  
      <name>script name 2</name>  
      <creation>2026-05-26 14:30:35</creation>  
      <script>LogManager.log('script 2');</script>  
    </i2>  
    <i3>
      <id>144bbf19ad2afc11b2c6a23c959df46c</id>  
      <name>script name 3</name>  
      <creation>2026-05-26 15:42:20</creation>  
      <script>LogManager.log('script 3');</script>  
    </i3>  
    <i4>
      <id>60d7c747074b26cf7665a8ec6dfdfc27</id>  
      <name>script name 4</name>  
      <creation>2026-05-26 19:12:48</creation>  
      <script>LogManager.log('script 4');</script>  
    </i4>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/lab/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=9f930731d05c1f4c00ae68d100dc90fa
result_0_name=script name 0
result_0_creation=2026-05-26 14:11:31
result_0_script=LogManager.log('script 0');
result_1_id=5458d5d57d1d7c02772e7e2b77b3adce
result_1_name=script name 1
result_1_creation=2026-05-26 14:21:05
result_1_script=LogManager.log('script 1');
result_2_id=3b35b131314101d0c07129f0e916854c
result_2_name=script name 2
result_2_creation=2026-05-26 14:30:35
result_2_script=LogManager.log('script 2');
result_3_id=144bbf19ad2afc11b2c6a23c959df46c
result_3_name=script name 3
result_3_creation=2026-05-26 15:42:20
result_3_script=LogManager.log('script 3');
result_4_id=60d7c747074b26cf7665a8ec6dfdfc27
result_4_name=script name 4
result_4_creation=2026-05-26 19:12:48
result_4_script=LogManager.log('script 4');

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/lab/info?format=plain

Query parameters

format = plain

Response

9f930731d05c1f4c00ae68d100dc90fa
script name 0
2026-05-26 14:11:31
LogManager.log('script 0');
5458d5d57d1d7c02772e7e2b77b3adce
script name 1
2026-05-26 14:21:05
LogManager.log('script 1');
3b35b131314101d0c07129f0e916854c
script name 2
2026-05-26 14:30:35
LogManager.log('script 2');
144bbf19ad2afc11b2c6a23c959df46c
script name 3
2026-05-26 15:42:20
LogManager.log('script 3');
60d7c747074b26cf7665a8ec6dfdfc27
script name 4
2026-05-26 19:12:48
LogManager.log('script 4');

Required parameters

parameter	description
idID	ID of the LAB script

Return values

parameter	description
creation	creation date/time of the LAB script
id	ID of the LAB script
name	name of the LAB script
script	content of the LAB script

/apis/lab/list

access: [READ]

This method returns a list of available custom scripts for the current user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/lab/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    {
      "id": "aa6740ccb78f77b67b344bdadec2f8f1",
      "name": "script name 0",
      "creation": "2026-05-26 14:11:48"
    },
    {
      "id": "48b7bca64be82453a8fee4f4b0756727",
      "name": "script name 1",
      "creation": "2026-05-26 14:47:41"
    },
    {
      "id": "465ce80b6209a5d80ff3ae6f923f0d6c",
      "name": "script name 2",
      "creation": "2026-05-26 15:33:29"
    },
    {
      "id": "ab43a8c9790128a7bbaa9f8ad04d40b7",
      "name": "script name 3",
      "creation": "2026-05-26 16:03:02"
    },
    {
      "id": "a7f4a411fe0036cb9df20629e5d4ffb7",
      "name": "script name 4",
      "creation": "2026-05-26 19:49:14"
    }
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/lab/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>
      <id>aa6740ccb78f77b67b344bdadec2f8f1</id>  
      <name>script name 0</name>  
      <creation>2026-05-26 14:11:48</creation>  
    </i0>  
    <i1>
      <id>48b7bca64be82453a8fee4f4b0756727</id>  
      <name>script name 1</name>  
      <creation>2026-05-26 14:47:41</creation>  
    </i1>  
    <i2>
      <id>465ce80b6209a5d80ff3ae6f923f0d6c</id>  
      <name>script name 2</name>  
      <creation>2026-05-26 15:33:29</creation>  
    </i2>  
    <i3>
      <id>ab43a8c9790128a7bbaa9f8ad04d40b7</id>  
      <name>script name 3</name>  
      <creation>2026-05-26 16:03:02</creation>  
    </i3>  
    <i4>
      <id>a7f4a411fe0036cb9df20629e5d4ffb7</id>  
      <name>script name 4</name>  
      <creation>2026-05-26 19:49:14</creation>  
    </i4>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/lab/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=aa6740ccb78f77b67b344bdadec2f8f1
result_0_name=script name 0
result_0_creation=2026-05-26 14:11:48
result_1_id=48b7bca64be82453a8fee4f4b0756727
result_1_name=script name 1
result_1_creation=2026-05-26 14:47:41
result_2_id=465ce80b6209a5d80ff3ae6f923f0d6c
result_2_name=script name 2
result_2_creation=2026-05-26 15:33:29
result_3_id=ab43a8c9790128a7bbaa9f8ad04d40b7
result_3_name=script name 3
result_3_creation=2026-05-26 16:03:02
result_4_id=a7f4a411fe0036cb9df20629e5d4ffb7
result_4_name=script name 4
result_4_creation=2026-05-26 19:49:14

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/lab/list?format=plain

Query parameters

format = plain

Response

aa6740ccb78f77b67b344bdadec2f8f1
script name 0
2026-05-26 14:11:48
48b7bca64be82453a8fee4f4b0756727
script name 1
2026-05-26 14:47:41
465ce80b6209a5d80ff3ae6f923f0d6c
script name 2
2026-05-26 15:33:29
ab43a8c9790128a7bbaa9f8ad04d40b7
script name 3
2026-05-26 16:03:02
a7f4a411fe0036cb9df20629e5d4ffb7
script name 4
2026-05-26 19:49:14

Optional parameters

parameter	description
searchSTRING	filters items to be extracted by searching them

Return values

parameter	description
count	total number of LAB scripts
data	list of available/filtered LAB scripts for the current user

/apis/limits

access: [READ]

This method returns the API limits for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/limits

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "primary": {
      "limit": 500,
      "unit": "HOUR"
    },
    "secondary": {
      "limit": 50000,
      "unit": "DAY"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/limits?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <primary>
      <limit>500</limit>  
      <unit>HOUR</unit>  
    </primary>  
    <secondary>
      <limit>50000</limit>  
      <unit>DAY</unit>  
    </secondary>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/limits?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_primary_limit=500
result_primary_unit=HOUR
result_secondary_limit=50000
result_secondary_unit=DAY

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/limits?format=plain

Query parameters

format = plain

Response

500
HOUR
50000
DAY

Return values

parameter	description
primary	object containing the primary rate limit: an integer limit and the unit in which the limit is expressed. unit is one of the following [MINUTE,HOUR,DAY,3_DAY]. 3_DAY is equivalent to 3 days
secondary	object containing the secondary rate limit: an integer limit and the unit in which the limit is expressed. unit is one of the following [MINUTE,HOUR,DAY,3_DAY]. 3_DAY is equivalent to 3 days

/apis/list

access: [READ]

This method returns the list of available versions of the API.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "id": "v1",
        "name": "Version v1"
      },
      {
        "id": "i1",
        "name": "Version i1"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <id>v1</id>  
        <name>Version v1</name>  
      </i0>  
      <i1>
        <id>i1</id>  
        <name>Version i1</name>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=v1
result_data_0_name=Version v1
result_data_1_id=i1
result_data_1_name=Version i1

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/list?format=plain

Query parameters

format = plain

Response

2
v1
Version v1
i1
Version i1

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	total number of versions
data	array containing required information on API versions the user has access to

/apis/tokens

access: [WRITE]

This method returns the API tokens associated to the logged in user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/apis/tokens

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "read_write_token": "tok_RW597a6843d62ebf0b145194702318332d",
    "read_only_token": "tok_RO044a4daaa87bef2606e76a67afc483a3"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/apis/tokens?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <read_write_token>tok_RW597a6843d62ebf0b145194702318332d</read_write_token>  
    <read_only_token>tok_RO044a4daaa87bef2606e76a67afc483a3</read_only_token>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/apis/tokens?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_read_write_token=tok_RW597a6843d62ebf0b145194702318332d
result_read_only_token=tok_RO044a4daaa87bef2606e76a67afc483a3

Example 4 (plain)

Request

https://joturl.com/a/i1/apis/tokens?format=plain

Query parameters

format = plain

Response

tok_RW597a6843d62ebf0b145194702318332d
tok_RO044a4daaa87bef2606e76a67afc483a3

Example 5 (json)

Request

https://joturl.com/a/i1/apis/tokens?password=oj2p1mohoo&reset=1

Query parameters

password = oj2p1mohoo
   reset = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "read_write_token": "tok_RWd81907677b388e3a8e7327d1b1891406",
    "read_only_token": "tok_RO2a5b0219f992b7c061f5eb9c0c679d06"
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/apis/tokens?password=oj2p1mohoo&reset=1&format=xml

Query parameters

password = oj2p1mohoo
   reset = 1
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <read_write_token>tok_RWd81907677b388e3a8e7327d1b1891406</read_write_token>  
    <read_only_token>tok_RO2a5b0219f992b7c061f5eb9c0c679d06</read_only_token>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/apis/tokens?password=oj2p1mohoo&reset=1&format=txt

Query parameters

password = oj2p1mohoo
   reset = 1
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_read_write_token=tok_RWd81907677b388e3a8e7327d1b1891406
result_read_only_token=tok_RO2a5b0219f992b7c061f5eb9c0c679d06

Example 8 (plain)

Request

https://joturl.com/a/i1/apis/tokens?password=oj2p1mohoo&reset=1&format=plain

Query parameters

password = oj2p1mohoo
   reset = 1
  format = plain

Response

tok_RWd81907677b388e3a8e7327d1b1891406
tok_RO2a5b0219f992b7c061f5eb9c0c679d06

Optional parameters

parameter	description
passwordSTRING	current account password, to be sent if `reset = 1`
resetBOOLEAN	1 to reset the API tokens, if this parameter is 1 the POST method is required (because the password is sent)

Return values

parameter	description
read_only_token	the read-only API access token
read_write_token	the read/write API access token

/cdns

/cdns/add

access: [WRITE]

This method allows to upload a resource to the CDN.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D

Query parameters

type = image
info = {"name":"this is my resource"}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "94686bf29d0bff43508740abd3c5b822",
    "name": "this is my resource",
    "creation": "2026-05-26 14:00:30",
    "url": "https:\/\/cdn.endpoint\/path\/to\/resource",
    "width": 533,
    "height": 400,
    "size": 20903,
    "mime_type": "image\/png"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&format=xml

Query parameters

  type = image
  info = {"name":"this is my resource"}
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>94686bf29d0bff43508740abd3c5b822</id>  
    <name>this is my resource</name>  
    <creation>2026-05-26 14:00:30</creation>  
    <url>https://cdn.endpoint/path/to/resource</url>  
    <width>533</width>  
    <height>400</height>  
    <size>20903</size>  
    <mime_type>image/png</mime_type>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&format=txt

Query parameters

  type = image
  info = {"name":"this is my resource"}
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=94686bf29d0bff43508740abd3c5b822
result_name=this is my resource
result_creation=2026-05-26 14:00:30
result_url=https://cdn.endpoint/path/to/resource
result_width=533
result_height=400
result_size=20903
result_mime_type=image/png

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&format=plain

Query parameters

  type = image
  info = {"name":"this is my resource"}
format = plain

Response

94686bf29d0bff43508740abd3c5b822
this is my resource
2026-05-26 14:00:30
https://cdn.endpoint/path/to/resource
533
400
20903
image/png

Required parameters

parameter	description
typeSTRING	CDN type, see i1/cdns/property for details

Optional parameters

parameter	description	max length
external_urlURL	URL to an external resource (not managed by the CDN), this URL must be with HTTPS	4000
infoJSON	JSON containing additional info on the resource
inputSTRING	name of the HTML form field that contains data for the resource, if not passed the default value input will be used (i.e., `input = input`)

NOTES: The parameter input contains the name of the field of the HTML form that is used to send resource data to this method. Form must have enctype = "multipart/form-data" and method = "post".

<form 
    action="/a/i1/cdns/add" 
    method="post" 
    enctype="multipart/form-data">

    <input name="input" value="resource_field" type="hidden"/>

    [other form fields]

    <input name="resource_field" type="file"/>    

</form>

Return values

parameter	description
creation	date/time when the CDN resource was created
height	height in pixels of the CDN resource, if available
id	ID of the CDN resource
mime_type	MIME type of the resource, or 'external_url' for external URLs
name	name of the CDN resource
size	size in bytes of the CDN resource, if available
url	URL of the CDN resource
width	width in pixels of the CDN resource, if available

/cdns/count

access: [READ]

This method returns the number of resources on the CDN.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/count?format=plain

Query parameters

format = plain

Response

Required parameters

parameter	description
typeSTRING	CDN resource type, for available types see i1/cdns/list

Optional parameters

parameter	description
filtersJSON	filters to be used to count media, for available filters see i1/cdns/list
searchSTRING	filters CDN resources to be extracted by searching them

Return values

parameter	description
count	number of (filtered) CDN resources

/cdns/delete

access: [WRITE]

This method deletes a resource from the CDN.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/delete?id=f519ee061feeeafd444b4b37bf902098

Query parameters

id = f519ee061feeeafd444b4b37bf902098

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "f519ee061feeeafd444b4b37bf902098",
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/delete?id=f519ee061feeeafd444b4b37bf902098&format=xml

Query parameters

    id = f519ee061feeeafd444b4b37bf902098
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>f519ee061feeeafd444b4b37bf902098</id>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/delete?id=f519ee061feeeafd444b4b37bf902098&format=txt

Query parameters

    id = f519ee061feeeafd444b4b37bf902098
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=f519ee061feeeafd444b4b37bf902098
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/delete?id=f519ee061feeeafd444b4b37bf902098&format=plain

Query parameters

    id = f519ee061feeeafd444b4b37bf902098
format = plain

Response

f519ee061feeeafd444b4b37bf902098
1

Required parameters

parameter	description
idID	ID of the CDN resource to delete

Optional parameters

parameter	description
confirmBOOLEAN	If 1 this method deletes the CDN resource even if it is linked to a tracking link

Return values

parameter	description
deleted	1 if successful, otherwise a generic error message is issued
id	echo back of the id input parameter

/cdns/edit

access: [WRITE]

This method allows to modify a CDN resource.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=8ef565360481299a79e757a7e9b9e5be

Query parameters

type = image
info = {"name":"this is my resource"}
  id = 8ef565360481299a79e757a7e9b9e5be

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "8ef565360481299a79e757a7e9b9e5be",
    "name": "this is my resource",
    "creation": "2026-05-26 14:00:30",
    "url": "https:\/\/cdn.endpoint\/path\/to\/resource",
    "width": 533,
    "height": 400,
    "size": 20903,
    "mime_type": "image\/png"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=8ef565360481299a79e757a7e9b9e5be&format=xml

Query parameters

  type = image
  info = {"name":"this is my resource"}
    id = 8ef565360481299a79e757a7e9b9e5be
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>8ef565360481299a79e757a7e9b9e5be</id>  
    <name>this is my resource</name>  
    <creation>2026-05-26 14:00:30</creation>  
    <url>https://cdn.endpoint/path/to/resource</url>  
    <width>533</width>  
    <height>400</height>  
    <size>20903</size>  
    <mime_type>image/png</mime_type>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=8ef565360481299a79e757a7e9b9e5be&format=txt

Query parameters

  type = image
  info = {"name":"this is my resource"}
    id = 8ef565360481299a79e757a7e9b9e5be
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=8ef565360481299a79e757a7e9b9e5be
result_name=this is my resource
result_creation=2026-05-26 14:00:30
result_url=https://cdn.endpoint/path/to/resource
result_width=533
result_height=400
result_size=20903
result_mime_type=image/png

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=8ef565360481299a79e757a7e9b9e5be&format=plain

Query parameters

  type = image
  info = {"name":"this is my resource"}
    id = 8ef565360481299a79e757a7e9b9e5be
format = plain

Response

8ef565360481299a79e757a7e9b9e5be
this is my resource
2026-05-26 14:00:30
https://cdn.endpoint/path/to/resource
533
400
20903
image/png

Required parameters

parameter	description
idID	ID of the CDN resource
typeSTRING	CDN type, see i1/cdns/property for details

Optional parameters

parameter	description	max length
external_urlURL	URL to an external resource (not managed by the CDN), this URL must be with HTTPS	4000
infoJSON	JSON containing additional info on the resource
inputSTRING	name of the HTML form field that contains data for the resource, if not passed the default value input will be used (i.e., `input = input`)

NOTES: The parameter input contains the name of the field of the HTML form that is used to send resource data to this method. Form must have enctype = "multipart/form-data" and method = "post".

<form 
    action="/a/i1/cdns/edit" 
    method="post" 
    enctype="multipart/form-data">

    <input name="input" value="resource_field" type="hidden"/>

    [other form fields]

    <input name="resource_field" type="file"/>    

</form>

Return values

parameter	description
creation	date/time when the CDN resource was created
height	height in pixels of the CDN resource, if available
id	ID of the CDN resource
mime_type	MIME type of the resource, or 'external_url' for external URLs
name	name of the CDN resource
size	size in bytes of the CDN resource, if available
url	URL of the CDN resource
width	width in pixels of the CDN resource, if available

/cdns/info

access: [READ]

This method returns information about a resource on the CDN.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/info?id=bfd8aad3546ed3e64ab36f02cf731bf8

Query parameters

id = bfd8aad3546ed3e64ab36f02cf731bf8

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "id": "bfd8aad3546ed3e64ab36f02cf731bf8",
      "name": "this is my resource",
      "creation": "2019-06-25 13:01:23",
      "url": "https:\/\/cdn.endpoint\/path\/to\/resource",
      "width": 533,
      "height": 400,
      "size": 20903,
      "mime_type": "image\/png"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/info?id=bfd8aad3546ed3e64ab36f02cf731bf8&format=xml

Query parameters

    id = bfd8aad3546ed3e64ab36f02cf731bf8
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <id>bfd8aad3546ed3e64ab36f02cf731bf8</id>  
      <name>this is my resource</name>  
      <creation>2019-06-25 13:01:23</creation>  
      <url>https://cdn.endpoint/path/to/resource</url>  
      <width>533</width>  
      <height>400</height>  
      <size>20903</size>  
      <mime_type>image/png</mime_type>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/info?id=bfd8aad3546ed3e64ab36f02cf731bf8&format=txt

Query parameters

    id = bfd8aad3546ed3e64ab36f02cf731bf8
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=bfd8aad3546ed3e64ab36f02cf731bf8
result_data_name=this is my resource
result_data_creation=2019-06-25 13:01:23
result_data_url=https://cdn.endpoint/path/to/resource
result_data_width=533
result_data_height=400
result_data_size=20903
result_data_mime_type=image/png

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/info?id=bfd8aad3546ed3e64ab36f02cf731bf8&format=plain

Query parameters

    id = bfd8aad3546ed3e64ab36f02cf731bf8
format = plain

Response

bfd8aad3546ed3e64ab36f02cf731bf8
this is my resource
2019-06-25 13:01:23
https://cdn.endpoint/path/to/resource
533
400
20903
image/png

Required parameters

parameter	description
idID	ID of the CDN resource

Return values

parameter	description
data	array containing required information on CDN resources

/cdns/links

/cdns/links/add

access: [WRITE]

This method allows to add an association between a CDN resource and a key and/or a tracking link. This method allows multiple instances for the combination (CDN resource,key).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=129c5da1ea9c1b2c89472ae8267fcc32&value=%7B%22position%22%3A%22top_left%22%7D

Query parameters

   key = my_custom_config_key
cdn_id = 129c5da1ea9c1b2c89472ae8267fcc32
 value = {"position":"top_left"}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=129c5da1ea9c1b2c89472ae8267fcc32&value=%7B%22position%22%3A%22top_left%22%7D&format=xml

Query parameters

   key = my_custom_config_key
cdn_id = 129c5da1ea9c1b2c89472ae8267fcc32
 value = {"position":"top_left"}
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=129c5da1ea9c1b2c89472ae8267fcc32&value=%7B%22position%22%3A%22top_left%22%7D&format=txt

Query parameters

   key = my_custom_config_key
cdn_id = 129c5da1ea9c1b2c89472ae8267fcc32
 value = {"position":"top_left"}
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=129c5da1ea9c1b2c89472ae8267fcc32&value=%7B%22position%22%3A%22top_left%22%7D&format=plain

Query parameters

   key = my_custom_config_key
cdn_id = 129c5da1ea9c1b2c89472ae8267fcc32
 value = {"position":"top_left"}
format = plain

Response

Required parameters

parameter	description	max length
cdn_idID	ID of the CDN resource
keySTRING	key that identifies the CDN resource/tracking link association, available values: `reports_config`, `instaurl`, `instaurl_bg`, `instaurl_images`, `preview_image`	50

Optional parameters

parameter	description
url_idID	ID of the tracking link
valueJSON	value for the association, it must be a stringified JSON

Return values

parameter	description
added	1 on success, 0 otherwise

/cdns/links/delete

access: [WRITE]

This method deletes all the associations between a CDN resource and a key and/or a tracking link. If the resource ID is not passed, it deletes all associations by using the key.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=824c51d37a35d68b1f56807294479d1f

Query parameters

   key = my_custom_config_key
cdn_id = 824c51d37a35d68b1f56807294479d1f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 9
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=824c51d37a35d68b1f56807294479d1f&format=xml

Query parameters

   key = my_custom_config_key
cdn_id = 824c51d37a35d68b1f56807294479d1f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>9</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=824c51d37a35d68b1f56807294479d1f&format=txt

Query parameters

   key = my_custom_config_key
cdn_id = 824c51d37a35d68b1f56807294479d1f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=9

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=824c51d37a35d68b1f56807294479d1f&format=plain

Query parameters

   key = my_custom_config_key
cdn_id = 824c51d37a35d68b1f56807294479d1f
format = plain

Response

Required parameters

parameter	description	max length
keySTRING	key that identifies the CDN resource/tracking link association, available values: `reports_config`, `instaurl`, `instaurl_bg`, `instaurl_images`, `preview_image`	50

Optional parameters

parameter	description
cdn_idID	if passed, only the associations with the CDN resource identified by this ID will be deleted
url_idID	if passed, only the associations with the tracking link identified by this ID will be deleted

Return values

parameter	description
deleted	number of deleted associations

/cdns/links/get

access: [READ]

This method returns all the associations between a CDN resource and a key and/or a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=7c102e6f1b205467082a85e77201ddd2

Query parameters

   key = my_custom_config_key
cdn_id = 7c102e6f1b205467082a85e77201ddd2

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "id": "97655b41f7402c6a0d2fab86610e8471",
      "key": "my_custom_config_key",
      "value": {
        "position": "top_left"
      },
      "cdn_id": "7c102e6f1b205467082a85e77201ddd2",
      "url_id": "b22a2cb0d1fc1d712bfb9f427545eac9",
      "name": "this is my resource",
      "creation": "2019-06-25 13:01:23",
      "url": "https:\/\/cdn.endpoint\/path\/to\/resource",
      "width": 533,
      "height": 400,
      "size": 20903,
      "mime_type": "image\/png"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=7c102e6f1b205467082a85e77201ddd2&format=xml

Query parameters

   key = my_custom_config_key
cdn_id = 7c102e6f1b205467082a85e77201ddd2
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <id>97655b41f7402c6a0d2fab86610e8471</id>  
      <key>my_custom_config_key</key>  
      <value>
        <position>top_left</position>  
      </value>  
      <cdn_id>7c102e6f1b205467082a85e77201ddd2</cdn_id>  
      <url_id>b22a2cb0d1fc1d712bfb9f427545eac9</url_id>  
      <name>this is my resource</name>  
      <creation>2019-06-25 13:01:23</creation>  
      <url>https://cdn.endpoint/path/to/resource</url>  
      <width>533</width>  
      <height>400</height>  
      <size>20903</size>  
      <mime_type>image/png</mime_type>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=7c102e6f1b205467082a85e77201ddd2&format=txt

Query parameters

   key = my_custom_config_key
cdn_id = 7c102e6f1b205467082a85e77201ddd2
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=97655b41f7402c6a0d2fab86610e8471
result_data_key=my_custom_config_key
result_data_value_position=top_left
result_data_cdn_id=7c102e6f1b205467082a85e77201ddd2
result_data_url_id=b22a2cb0d1fc1d712bfb9f427545eac9
result_data_name=this is my resource
result_data_creation=2019-06-25 13:01:23
result_data_url=https://cdn.endpoint/path/to/resource
result_data_width=533
result_data_height=400
result_data_size=20903
result_data_mime_type=image/png

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=7c102e6f1b205467082a85e77201ddd2&format=plain

Query parameters

   key = my_custom_config_key
cdn_id = 7c102e6f1b205467082a85e77201ddd2
format = plain

Response

97655b41f7402c6a0d2fab86610e8471
my_custom_config_key
top_left
7c102e6f1b205467082a85e77201ddd2
b22a2cb0d1fc1d712bfb9f427545eac9
this is my resource
2019-06-25 13:01:23
https://cdn.endpoint/path/to/resource
533
400
20903
image/png

Required parameters

parameter	description	max length
keySTRING	key that identifies the CDN resource/tracking link association, available values: `reports_config`, `instaurl`, `instaurl_bg`, `instaurl_images`, `preview_image`	50

Optional parameters

parameter	description
cdn_idID	if passed, only the associations with the CDN resource identified by this ID will be returned
url_idID	if passed, only the associations with the tracking link identified by this ID will be returned

Return values

parameter	description
data	array containing information on the association and the linked CDN resource

/cdns/links/set

access: [WRITE]

This method allows to set the association between a CDN resource and a key and/or a tracking link. This method allows only one instance for the combination (CDN resource,key).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=2fd5519c0672adfda1f0fe1de43e1f33&value=%7B%22position%22%3A%22top_left%22%7D

Query parameters

   key = my_custom_config_key
cdn_id = 2fd5519c0672adfda1f0fe1de43e1f33
 value = {"position":"top_left"}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "set": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=2fd5519c0672adfda1f0fe1de43e1f33&value=%7B%22position%22%3A%22top_left%22%7D&format=xml

Query parameters

   key = my_custom_config_key
cdn_id = 2fd5519c0672adfda1f0fe1de43e1f33
 value = {"position":"top_left"}
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <set>1</set>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=2fd5519c0672adfda1f0fe1de43e1f33&value=%7B%22position%22%3A%22top_left%22%7D&format=txt

Query parameters

   key = my_custom_config_key
cdn_id = 2fd5519c0672adfda1f0fe1de43e1f33
 value = {"position":"top_left"}
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_set=1

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=2fd5519c0672adfda1f0fe1de43e1f33&value=%7B%22position%22%3A%22top_left%22%7D&format=plain

Query parameters

   key = my_custom_config_key
cdn_id = 2fd5519c0672adfda1f0fe1de43e1f33
 value = {"position":"top_left"}
format = plain

Response

Required parameters

parameter	description	max length
cdn_idID	ID of the CDN resource
keySTRING	key that identifies the CDN resource/tracking link association, available values: `reports_config`, `instaurl`, `instaurl_bg`, `instaurl_images`, `preview_image`	50

Optional parameters

parameter	description
url_idID	ID of the tracking link
valueJSON	value for the association, it must be a stringified JSON

Return values

parameter	description
set	1 on success, 0 otherwise

/cdns/list

access: [READ]

This method returns a list of resource on the CDN linked with the current user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/list?type=image

Query parameters

type = image

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": {
      "id": "1234567890abcdef",
      "name": "this is my resource",
      "creation": "2019-06-25 13:01:23",
      "url": "https:\/\/cdn.endpoint\/path\/to\/resource",
      "width": 533,
      "height": 400,
      "size": 20903,
      "mime_type": "image\/png"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/list?type=image&format=xml

Query parameters

  type = image
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <id>1234567890abcdef</id>  
      <name>this is my resource</name>  
      <creation>2019-06-25 13:01:23</creation>  
      <url>https://cdn.endpoint/path/to/resource</url>  
      <width>533</width>  
      <height>400</height>  
      <size>20903</size>  
      <mime_type>image/png</mime_type>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/list?type=image&format=txt

Query parameters

  type = image
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_id=1234567890abcdef
result_data_name=this is my resource
result_data_creation=2019-06-25 13:01:23
result_data_url=https://cdn.endpoint/path/to/resource
result_data_width=533
result_data_height=400
result_data_size=20903
result_data_mime_type=image/png

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/list?type=image&format=plain

Query parameters

  type = image
format = plain

Response

1
1234567890abcdef
this is my resource
2019-06-25 13:01:23
https://cdn.endpoint/path/to/resource
533
400
20903
image/png

Required parameters

parameter	description
typeSTRING	CDN type, see i1/cdns/property for details

Optional parameters

parameter	description
filtersJSON	filters to be used extracing media
lengthINTEGER	extracts this number of CDN resources (maxmimum allowed: 100)
searchSTRING	filters CDN resources to be extracted by searching them
startINTEGER	starts to extract CDN resources from this position

Return values

parameter	description
count	total number of (filtered) CDN resources
data	array containing required information on CDN resources

/cdns/property

access: [READ]

This method return limits for uploading a resource on the CDN.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/cdns/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "image": {
      "max_size": 5242880,
      "allowed_types": [
        "gif",
        "jpg",
        "png",
        "svg",
        "webp"
      ],
      "allowed_mimes": [
        "image\/gif",
        "image\/jpeg",
        "image\/jpg",
        "image\/pjpeg",
        "image\/x-png",
        "image\/png",
        "image\/svg+xml",
        "application\/svg+xml",
        "image\/webp"
      ]
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/cdns/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <image>
      <max_size>5242880</max_size>  
      <allowed_types>
        <i0>gif</i0>  
        <i1>jpg</i1>  
        <i2>png</i2>  
        <i3>svg</i3>  
        <i4>webp</i4>  
      </allowed_types>  
      <allowed_mimes>
        <i0>image/gif</i0>  
        <i1>image/jpeg</i1>  
        <i2>image/jpg</i2>  
        <i3>image/pjpeg</i3>  
        <i4>image/x-png</i4>  
        <i5>image/png</i5>  
        <i6>image/svg+xml</i6>  
        <i7>application/svg+xml</i7>  
        <i8>image/webp</i8>  
      </allowed_mimes>  
    </image>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/cdns/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_image_max_size=5242880
result_image_allowed_types_0=gif
result_image_allowed_types_1=jpg
result_image_allowed_types_2=png
result_image_allowed_types_3=svg
result_image_allowed_types_4=webp
result_image_allowed_mimes_0=image/gif
result_image_allowed_mimes_1=image/jpeg
result_image_allowed_mimes_2=image/jpg
result_image_allowed_mimes_3=image/pjpeg
result_image_allowed_mimes_4=image/x-png
result_image_allowed_mimes_5=image/png
result_image_allowed_mimes_6=image/svg+xml
result_image_allowed_mimes_7=application/svg+xml
result_image_allowed_mimes_8=image/webp

Example 4 (plain)

Request

https://joturl.com/a/i1/cdns/property?format=plain

Query parameters

format = plain

Response

5242880
gif
jpg
png
svg
webp
image/gif
image/jpeg
image/jpg
image/pjpeg
image/x-png
image/png
image/svg+xml
application/svg+xml
image/webp

Example 5 (json)

Request

https://joturl.com/a/i1/cdns/property?type=image

Query parameters

type = image

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "max_size": 5242880,
    "allowed_types": [
      "gif",
      "jpg",
      "png",
      "svg",
      "webp"
    ],
    "allowed_mimes": [
      "image\/gif",
      "image\/jpeg",
      "image\/jpg",
      "image\/pjpeg",
      "image\/x-png",
      "image\/png",
      "image\/svg+xml",
      "application\/svg+xml",
      "image\/webp"
    ]
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/cdns/property?type=image&format=xml

Query parameters

  type = image
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <max_size>5242880</max_size>  
    <allowed_types>
      <i0>gif</i0>  
      <i1>jpg</i1>  
      <i2>png</i2>  
      <i3>svg</i3>  
      <i4>webp</i4>  
    </allowed_types>  
    <allowed_mimes>
      <i0>image/gif</i0>  
      <i1>image/jpeg</i1>  
      <i2>image/jpg</i2>  
      <i3>image/pjpeg</i3>  
      <i4>image/x-png</i4>  
      <i5>image/png</i5>  
      <i6>image/svg+xml</i6>  
      <i7>application/svg+xml</i7>  
      <i8>image/webp</i8>  
    </allowed_mimes>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/cdns/property?type=image&format=txt

Query parameters

  type = image
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_max_size=5242880
result_allowed_types_0=gif
result_allowed_types_1=jpg
result_allowed_types_2=png
result_allowed_types_3=svg
result_allowed_types_4=webp
result_allowed_mimes_0=image/gif
result_allowed_mimes_1=image/jpeg
result_allowed_mimes_2=image/jpg
result_allowed_mimes_3=image/pjpeg
result_allowed_mimes_4=image/x-png
result_allowed_mimes_5=image/png
result_allowed_mimes_6=image/svg+xml
result_allowed_mimes_7=application/svg+xml
result_allowed_mimes_8=image/webp

Example 8 (plain)

Request

https://joturl.com/a/i1/cdns/property?type=image&format=plain

Query parameters

  type = image
format = plain

Response

5242880
gif
jpg
png
svg
webp
image/gif
image/jpeg
image/jpg
image/pjpeg
image/x-png
image/png
image/svg+xml
application/svg+xml
image/webp

Optional parameters

parameter	description
typeSTRING	CDN resource type, available types: image

Return values

parameter	description
[ARRAY]	it is an object (type,(max_size,allowed_types,allowed_mimes)), see parameters max_size, allowed_types, allowed_mimes for details
allowed_mimes	array containing the allowed mimes for the resource
allowed_types	array containing the allowed types for the resource
max_size	it is the maximum size in bytes the resource can have

/conversions

/conversions/affiliates

/conversions/affiliates/count

access: [READ]

This method returns the number of affiliates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/affiliates/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 10
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/affiliates/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>10</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/affiliates/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=10

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/affiliates/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
idID	ID of the affiliate network

Return values

parameter	description
count	number of affiliate networks

/conversions/affiliates/list

access: [READ]

This method lists all affiliates network.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/affiliates/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "id": "644a4b356f74446f62613864764b3762725a343966673d3d",
      "name": "Network name",
      "actual_url_params": "id={:CLICK_ID:}",
      "postback_url_params": "clickid={id}&comm={comm}",
      "integration_link": ""
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/affiliates/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <id>644a4b356f74446f62613864764b3762725a343966673d3d</id>  
      <name>Network name</name>  
      <actual_url_params>id={:CLICK_ID:}</actual_url_params>  
      <postback_url_params><[CDATA[clickid={id}&amp;comm={comm}]]></postback_url_params>  
      <integration_link></integration_link>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/affiliates/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=644a4b356f74446f62613864764b3762725a343966673d3d
result_data_name=Network name
result_data_actual_url_params=id={:CLICK_ID:}
result_data_postback_url_params=clickid={id}&amp;comm={comm}
result_data_integration_link=

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/affiliates/list?format=plain

Query parameters

format = plain

Response

644a4b356f74446f62613864764b3762725a343966673d3d
Network name
id={:CLICK_ID:}
clickid={id}&amp;comm={comm}

Optional parameters

parameter	description
idID	ID of the affiliate network
lengthINTEGER	number of items to return (default: 1000, max value: 1000)
searchSTRING	filter items by searching them
startINTEGER	index of the starting item to retrieve (default: 0)

Return values

parameter	description
count	number of affiliate networks
data	array containing affiliate networks

/conversions/codes

/conversions/codes/add

access: [WRITE]

Create a conversion code for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code&notes=this+is+a+note+for+the+conversion+code

Query parameters

 name = name of the new conversion code
notes = this is a note for the conversion code

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "name of the new conversion code",
    "notes": "this is a note for the conversion code",
    "id": "885547b9b5747e0e6d1d925ff1d8643b",
    "enable_postback_url": 0,
    "affiliate_network_id": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code&notes=this+is+a+note+for+the+conversion+code&format=xml

Query parameters

  name = name of the new conversion code
 notes = this is a note for the conversion code
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>name of the new conversion code</name>  
    <notes>this is a note for the conversion code</notes>  
    <id>885547b9b5747e0e6d1d925ff1d8643b</id>  
    <enable_postback_url>0</enable_postback_url>  
    <affiliate_network_id></affiliate_network_id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code&notes=this+is+a+note+for+the+conversion+code&format=txt

Query parameters

  name = name of the new conversion code
 notes = this is a note for the conversion code
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=name of the new conversion code
result_notes=this is a note for the conversion code
result_id=885547b9b5747e0e6d1d925ff1d8643b
result_enable_postback_url=0
result_affiliate_network_id=

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code&notes=this+is+a+note+for+the+conversion+code&format=plain

Query parameters

  name = name of the new conversion code
 notes = this is a note for the conversion code
format = plain

Response

name of the new conversion code
this is a note for the conversion code
885547b9b5747e0e6d1d925ff1d8643b
0

Required parameters

parameter	description	max length
nameSTRING	conversion name	100

Optional parameters

parameter	description	max length
affiliate_network_idID	ID of the linked affiliate network, see i1/conversions/affliates/list for details
enable_postback_urlBOOLEAN	1 to enable postback URLs for the conversion
notesSTRING	notes for the conversion	255

Return values

parameter	description
affiliate_network_id	echo back of the affiliate_network_id input parameter
enable_postback_url	echo back of the enable_postback_url input parameter
id	ID of the conversion code
name	echo back of the name input parameter
notes	echo back of the notes input parameter

/conversions/codes/count

access: [READ]

This method returns the number of defined conversion codes.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 4321
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>4321</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4321

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/conversions/codes/count?search=text+to+search

Query parameters

search = text to search

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1234
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/conversions/codes/count?search=text+to+search&format=xml

Query parameters

search = text to search
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1234</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/conversions/codes/count?search=text+to+search&format=txt

Query parameters

search = text to search
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1234

Example 8 (plain)

Request

https://joturl.com/a/i1/conversions/codes/count?search=text+to+search&format=plain

Query parameters

search = text to search
format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters conversion codes to be extracted by searching them

Return values

parameter	description
count	number of (filtered) conversion codes

/conversions/codes/delete

access: [WRITE]

This method deletes a set of conversion codes using their IDs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247

Query parameters

ids = 025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247&format=xml

Query parameters

   ids = 025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247&format=txt

Query parameters

   ids = 025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247&format=plain

Query parameters

   ids = 025f19ae7b7e04df50169b7f72c77a87,b40ebad3cdbd48b1259cf3f8062bea34,78ed7fdcafd9057488d1447c2f5ed247
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae

Query parameters

ids = 1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": [
      "1d7faab5b4a3082cd38878ee54c94ce6"
    ],
    "deleted": 2
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae&format=xml

Query parameters

   ids = 1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>
      <i0>1d7faab5b4a3082cd38878ee54c94ce6</i0>  
    </ids>  
    <deleted>2</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae&format=txt

Query parameters

   ids = 1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=1d7faab5b4a3082cd38878ee54c94ce6
result_deleted=2

Example 8 (plain)

Request

https://joturl.com/a/i1/conversions/codes/delete?ids=1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae&format=plain

Query parameters

   ids = 1d7faab5b4a3082cd38878ee54c94ce6,022de0d1ea3a49066d4f88f205607699,dd9e595cd1da42f029744ac5aa1dc0ae
format = plain

Response

1d7faab5b4a3082cd38878ee54c94ce6
2

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of conversion code IDs to be deleted

Return values

parameter	description
deleted	number of deleted conversion codes
ids	[OPTIONAL] list of conversion code IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/conversions/codes/edit

access: [WRITE]

Edit fields of a conversion.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/edit?id=7ad0ef26f7fbabeb99a8f7d759d3717b&notes=new+notes+for+the+conversion+code

Query parameters

   id = 7ad0ef26f7fbabeb99a8f7d759d3717b
notes = new notes for the conversion code

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "7ad0ef26f7fbabeb99a8f7d759d3717b",
    "notes": "new notes for the conversion code"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/edit?id=7ad0ef26f7fbabeb99a8f7d759d3717b&notes=new+notes+for+the+conversion+code&format=xml

Query parameters

    id = 7ad0ef26f7fbabeb99a8f7d759d3717b
 notes = new notes for the conversion code
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>7ad0ef26f7fbabeb99a8f7d759d3717b</id>  
    <notes>new notes for the conversion code</notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/edit?id=7ad0ef26f7fbabeb99a8f7d759d3717b&notes=new+notes+for+the+conversion+code&format=txt

Query parameters

    id = 7ad0ef26f7fbabeb99a8f7d759d3717b
 notes = new notes for the conversion code
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=7ad0ef26f7fbabeb99a8f7d759d3717b
result_notes=new notes for the conversion code

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/edit?id=7ad0ef26f7fbabeb99a8f7d759d3717b&notes=new+notes+for+the+conversion+code&format=plain

Query parameters

    id = 7ad0ef26f7fbabeb99a8f7d759d3717b
 notes = new notes for the conversion code
format = plain

Response

7ad0ef26f7fbabeb99a8f7d759d3717b
new notes for the conversion code

Required parameters

parameter	description
idID	ID of the conversion code

Optional parameters

parameter	description	max length
affiliate_network_idID	ID of the affiliate network linked to the conversion code, it is ignored if `enable_postback_url = 0`
enable_postback_urlBOOLEAN	1 to enabled postback URLs for the conversion code, 0 to disable it
nameSTRING	name of the conversion code	100
notesSTRING	notes for the conversion code	255

Return values

parameter	description
affiliate_network_id	[OPTIONAL] echo back of the affiliate_network_id input parameter
enable_postback_url	[OPTIONAL] echo back of the enable_postback_url input parameter
id	echo back of the id input parameter
name	[OPTIONAL] echo back of the name input parameter
notes	[OPTIONAL] echo back of the notes input parameter

/conversions/codes/info

access: [READ]

This method returns information about conversion code.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/info?id=d939a72751dc3826f550abd6e03ce762&fields=id,name,notes

Query parameters

    id = d939a72751dc3826f550abd6e03ce762
fields = id,name,notes

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "d939a72751dc3826f550abd6e03ce762",
    "name": "name",
    "notes": "notes"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/info?id=d939a72751dc3826f550abd6e03ce762&fields=id,name,notes&format=xml

Query parameters

    id = d939a72751dc3826f550abd6e03ce762
fields = id,name,notes
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>d939a72751dc3826f550abd6e03ce762</id>  
    <name>name</name>  
    <notes>notes</notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/info?id=d939a72751dc3826f550abd6e03ce762&fields=id,name,notes&format=txt

Query parameters

    id = d939a72751dc3826f550abd6e03ce762
fields = id,name,notes
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=d939a72751dc3826f550abd6e03ce762
result_name=name
result_notes=notes

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/info?id=d939a72751dc3826f550abd6e03ce762&fields=id,name,notes&format=plain

Query parameters

    id = d939a72751dc3826f550abd6e03ce762
fields = id,name,notes
format = plain

Response

d939a72751dc3826f550abd6e03ce762
name
notes

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: id, ext_id, ext_postback_id, name, notes, enable_postback_url, affiliate_network_id, creation, clicks, last_click, value, performance
idID	conversion ID

Return values

parameter	description
[ARRAY]	see i1/conversions/codes/list for details on returned fields

/conversions/codes/list

access: [READ]

This method returns a list of user's conversions, specified in a comma separated input called fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name

Query parameters

fields = count,id,name

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "id": "932977b7f76303b9ce0baa4b5d152892",
        "name": "conversion code 1"
      },
      {
        "id": "8e2f969756b091beef4d53e9dc598a50",
        "name": "conversion code 2"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name&format=xml

Query parameters

fields = count,id,name
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <id>932977b7f76303b9ce0baa4b5d152892</id>  
        <name>conversion code 1</name>  
      </i0>  
      <i1>
        <id>8e2f969756b091beef4d53e9dc598a50</id>  
        <name>conversion code 2</name>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name&format=txt

Query parameters

fields = count,id,name
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=932977b7f76303b9ce0baa4b5d152892
result_data_0_name=conversion code 1
result_data_1_id=8e2f969756b091beef4d53e9dc598a50
result_data_1_name=conversion code 2

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name&format=plain

Query parameters

fields = count,id,name
format = plain

Response

2
932977b7f76303b9ce0baa4b5d152892
conversion code 1
8e2f969756b091beef4d53e9dc598a50
conversion code 2

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: count, id, ext_id, ext_postback_id, name, notes, enable_postback_url, affiliate_network_id, creation, clicks, last_click, value, performance

Optional parameters

parameter	description
lengthINTEGER	extracts this number of coversion codes (maxmimum allowed: 100)
orderbyARRAY	orders coversion codes by field, available fields: count, id, ext_id, ext_postback_id, name, notes, enable_postback_url, affiliate_network_id, creation, clicks, last_click, value, performance
searchSTRING	filters coversion codes to be extracted by searching them
sortSTRING	sorts coversion codes in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract coversion codes from this position

Return values

parameter	description
count	[OPTIONAL] total number of (filtered) coversion codes, returned only if count is passed in fields
data	array containing required information on coversion codes

Available fields in the data array:

id: ID of the conversion code
ext_id: identifier of the conversion code that can be used outside the dashboard, id is only valid within the dashboard
ext_postback_id: identifier of the associated postback URL, it can be used outside the dashboard
name: name of the conversion code
notes: notes for the conversion code
enable_postback_url: 1 if postback URLs are enabled for the conversion code, 0 otherwise
affiliate_network_id: ID of the affiliate network, to be ignored if enable_postback_url = 0
creation: creation date time
clicks: number of occurred conversions
last_click: date/time of the last click
value: total value for the occurred conversions
performance: performance meter of this conversion code, 0 if the conversion pixel has 0 clicks or if is was created by less than 3 hours, otherwise it is the average number of clicks per hour

Parameters ext_id and ext_postback_id are always returned regardless they are passed in fields.

/conversions/codes/params

/conversions/codes/params/count

access: [READ]

This method returns the number of parameters linked to a conversion code.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/params/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 4
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/params/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>4</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/params/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/params/count?format=plain

Query parameters

format = plain

Response

Required parameters

parameter	description
idID	ID of the conversion code

Optional parameters

parameter	description
param_numSTRING	filter conversion parameters by parameter number, see i1/conversions/codes/params/list for details
searchSTRING	filters conversion parameters to be extracted by searching them

Return values

parameter	description
count	number of (filtered) conversion parameters

/conversions/codes/params/has_params

access: [READ]

This method returns the number of parameters related to a conversion code.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/params/has_params?id=b953e5928d07c60b0a46927c8bb46f1e

Query parameters

id = b953e5928d07c60b0a46927c8bb46f1e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "has_params": 1,
    "param": 1,
    "ep00": 1,
    "ep01": 0,
    "ep02": 0,
    "ep03": 0,
    "ep04": 0,
    "ep05": 0,
    "ep06": 0,
    "ep07": 0,
    "ep08": 0,
    "ep09": 0,
    "ep10": 0,
    "ep11": 0,
    "ep12": 0,
    "ep13": 0,
    "ep14": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/params/has_params?id=b953e5928d07c60b0a46927c8bb46f1e&format=xml

Query parameters

    id = b953e5928d07c60b0a46927c8bb46f1e
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <has_params>1</has_params>  
    <param>1</param>  
    <ep00>1</ep00>  
    <ep01>0</ep01>  
    <ep02>0</ep02>  
    <ep03>0</ep03>  
    <ep04>0</ep04>  
    <ep05>0</ep05>  
    <ep06>0</ep06>  
    <ep07>0</ep07>  
    <ep08>0</ep08>  
    <ep09>0</ep09>  
    <ep10>0</ep10>  
    <ep11>0</ep11>  
    <ep12>0</ep12>  
    <ep13>0</ep13>  
    <ep14>0</ep14>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/params/has_params?id=b953e5928d07c60b0a46927c8bb46f1e&format=txt

Query parameters

    id = b953e5928d07c60b0a46927c8bb46f1e
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_has_params=1
result_param=1
result_ep00=1
result_ep01=0
result_ep02=0
result_ep03=0
result_ep04=0
result_ep05=0
result_ep06=0
result_ep07=0
result_ep08=0
result_ep09=0
result_ep10=0
result_ep11=0
result_ep12=0
result_ep13=0
result_ep14=0

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/params/has_params?id=b953e5928d07c60b0a46927c8bb46f1e&format=plain

Query parameters

    id = b953e5928d07c60b0a46927c8bb46f1e
format = plain

Response

Required parameters

parameter	description
idID	ID of the conversion code

Return values

parameter	description
ep00	1 if the extended parameter ep00 is associated to the conversion code
ep01	1 if the extended parameter ep01 is associated to the conversion code
ep02	1 if the extended parameter ep02 is associated to the conversion code
ep03	1 if the extended parameter ep03 is associated to the conversion code
ep04	1 if the extended parameter ep04 is associated to the conversion code
ep05	1 if the extended parameter ep05 is associated to the conversion code
ep06	1 if the extended parameter ep06 is associated to the conversion code
ep07	1 if the extended parameter ep07 is associated to the conversion code
ep08	1 if the extended parameter ep08 is associated to the conversion code
ep09	1 if the extended parameter ep09 is associated to the conversion code
ep10	1 if the extended parameter ep10 is associated to the conversion code
ep11	1 if the extended parameter ep11 is associated to the conversion code
ep12	1 if the extended parameter ep12 is associated to the conversion code
ep13	1 if the extended parameter ep13 is associated to the conversion code
ep14	1 if the extended parameter ep14 is associated to the conversion code
has_params	1 if at least one extended parameter is associated to the conversion code
param	1 if param is associated to the conversion code

/conversions/codes/params/list

access: [READ]

This method returns a list of parameters related to a conversion code.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=85eeff479e3d532b0cc539d5044c3633

Query parameters

id = 85eeff479e3d532b0cc539d5044c3633

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "param_id": "7411e93e5385d556607cb7b462ef89b8",
        "param": "this is the value #1 of parameter 'param'"
      },
      {
        "param_id": "d7b133b2969d9027dd02e08286ab3ca2",
        "param": "this is the value #2 of parameter 'param'"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=85eeff479e3d532b0cc539d5044c3633&format=xml

Query parameters

    id = 85eeff479e3d532b0cc539d5044c3633
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <param_id>7411e93e5385d556607cb7b462ef89b8</param_id>  
        <param>this is the value #1 of parameter 'param'</param>  
      </i0>  
      <i1>
        <param_id>d7b133b2969d9027dd02e08286ab3ca2</param_id>  
        <param>this is the value #2 of parameter 'param'</param>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=85eeff479e3d532b0cc539d5044c3633&format=txt

Query parameters

    id = 85eeff479e3d532b0cc539d5044c3633
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_param_id=7411e93e5385d556607cb7b462ef89b8
result_data_0_param=this is the value #1 of parameter 'param'
result_data_1_param_id=d7b133b2969d9027dd02e08286ab3ca2
result_data_1_param=this is the value #2 of parameter 'param'

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=85eeff479e3d532b0cc539d5044c3633&format=plain

Query parameters

    id = 85eeff479e3d532b0cc539d5044c3633
format = plain

Response

2
7411e93e5385d556607cb7b462ef89b8
this is the value #1 of parameter 'param'
d7b133b2969d9027dd02e08286ab3ca2
this is the value #2 of parameter 'param'

Example 5 (json)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=e0ceb517089ad0da07f7953373eef052&param_num=0

Query parameters

       id = e0ceb517089ad0da07f7953373eef052
param_num = 0

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "param_id": "3603154b3178ead8608895df7818413c",
        "param": "this is the value of extended parameter 'ep00'"
      }
    ]
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=e0ceb517089ad0da07f7953373eef052&param_num=0&format=xml

Query parameters

       id = e0ceb517089ad0da07f7953373eef052
param_num = 0
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <param_id>3603154b3178ead8608895df7818413c</param_id>  
        <param>this is the value of extended parameter 'ep00'</param>  
      </i0>  
    </data>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=e0ceb517089ad0da07f7953373eef052&param_num=0&format=txt

Query parameters

       id = e0ceb517089ad0da07f7953373eef052
param_num = 0
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_param_id=3603154b3178ead8608895df7818413c
result_data_0_param=this is the value of extended parameter 'ep00'

Example 8 (plain)

Request

https://joturl.com/a/i1/conversions/codes/params/list?id=e0ceb517089ad0da07f7953373eef052&param_num=0&format=plain

Query parameters

       id = e0ceb517089ad0da07f7953373eef052
param_num = 0
   format = plain

Response

1
3603154b3178ead8608895df7818413c
this is the value of extended parameter 'ep00'

Required parameters

parameter	description
idID	ID of the conversion code

Optional parameters

parameter	description
lengthINTEGER	extracts this number of coversion parameters (maxmimum allowed: 100)
param_numSTRING	if not passed or `param_num = 255` it returns the parameter `param`, if `param_num = 0` it returns the extended paarameter `ep00`, ..., if `param_num = 7` it returns the extended paarameter `ep07`, ..., if `param_num = 14` it returns the extended paarameter `ep14`,
searchSTRING	filters coversion parameters to be extracted by searching them
startINTEGER	starts to extract coversion parameters from this position

Return values

parameter	description
count	number of available parameter with the specified _paramnum
data	array containing required information on coversion code parameters

/conversions/codes/urls

/conversions/codes/urls/count

access: [READ]

This method returns the number of tracking links liked to a conversion code.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/urls/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/urls/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/urls/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/urls/count?format=plain

Query parameters

format = plain

Response

Required parameters

parameter	description
idID	ID of the conversion code

Optional parameters

parameter	description
searchSTRING	filters tracking pixels to be extracted by searching them

Return values

parameter	description
count	number of (filtered) tracking pixels

/conversions/codes/urls/list

access: [READ]

This method returns a list of tracking links related to a conversion code.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/codes/urls/list?id=8a37ba410f6ff269219415f1381b4409&fields=count,url_id,alias

Query parameters

    id = 8a37ba410f6ff269219415f1381b4409
fields = count,url_id,alias

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "url_id": "2c8cedb576fc45d56daaa7bcc32462ce",
        "alias": "c5457d7b"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/codes/urls/list?id=8a37ba410f6ff269219415f1381b4409&fields=count,url_id,alias&format=xml

Query parameters

    id = 8a37ba410f6ff269219415f1381b4409
fields = count,url_id,alias
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <url_id>2c8cedb576fc45d56daaa7bcc32462ce</url_id>  
        <alias>c5457d7b</alias>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/codes/urls/list?id=8a37ba410f6ff269219415f1381b4409&fields=count,url_id,alias&format=txt

Query parameters

    id = 8a37ba410f6ff269219415f1381b4409
fields = count,url_id,alias
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_url_id=2c8cedb576fc45d56daaa7bcc32462ce
result_data_0_alias=c5457d7b

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/codes/urls/list?id=8a37ba410f6ff269219415f1381b4409&fields=count,url_id,alias&format=plain

Query parameters

    id = 8a37ba410f6ff269219415f1381b4409
fields = count,url_id,alias
format = plain

Response

1
2c8cedb576fc45d56daaa7bcc32462ce
c5457d7b

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, url_id, alias, short_url, creation, long_url, domain_host, domain_id, project_name, project_id
idID	ID of the conversion code

Optional parameters

parameter	description
lengthINTEGER	extracts this number of tracking links (maxmimum allowed: 100)
orderbyARRAY	orders tracking links by field, available fields: url_id, alias, short_url, creation, long_url, domain_host, domain_id, project_name, project_id
searchSTRING	filters tracking links to be extracted by searching them
sortSTRING	sorts tracking links in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract tracking links from this position

Return values

parameter	description
count	[OPTIONAL] total number of tracking links, returned only if count is passed in fields
data	array containing information on the tracking links, the returned information depends on the fields parameter.

/conversions/count

access: [READ]

This method is actually an interface to i1/conversions/codes/count and/or to i1/conversions/pixels/count according to types.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/count?types=code,pixel

Query parameters

types = code,pixel

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 368
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/count?types=code,pixel&format=xml

Query parameters

 types = code,pixel
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>368</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/count?types=code,pixel&format=txt

Query parameters

 types = code,pixel
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=368

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/count?types=code,pixel&format=plain

Query parameters

 types = code,pixel
format = plain

Response

Required parameters

parameter	description
typesARRAY	comma separated list of types; available types are [code, pixel]

Return values

parameter	description
count	number of conversion, if both types are passed, it contains the sum of number of conversion codes and conversion pixels

/conversions/list

access: [READ]

This method is actually an interface to i1/conversions/codes/list and/or to i1/conversions/pixels/list according to types.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url

Query parameters

 types = code,pixel
fields = name,id,short_url

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "name": "conversion code 1 (postback enabled)",
        "id": "e6ba6a845618e8f8136b693ce3303542",
        "ext_id": "1f68289b0c40dfd6885f7f0a0e73dbfa",
        "ext_postback_id": "8589ee72216d7dafe31b7b99f74d8ffa",
        "type": "code"
      },
      {
        "name": "conversion code 2",
        "id": "af092d370c452216657774c9642fecce",
        "ext_id": "0777792c4994222c3ae83185c2a672e4",
        "type": "code"
      },
      {
        "id": "2abf5efdb4e4f93ce67a6faf4e33f9e8",
        "short_url": "https:\/\/domain.ext\/tracking_pixel_alias",
        "type": "pixel"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url&format=xml

Query parameters

 types = code,pixel
fields = name,id,short_url
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <name>conversion code 1 (postback enabled)</name>  
        <id>e6ba6a845618e8f8136b693ce3303542</id>  
        <ext_id>1f68289b0c40dfd6885f7f0a0e73dbfa</ext_id>  
        <ext_postback_id>8589ee72216d7dafe31b7b99f74d8ffa</ext_postback_id>  
        <type>code</type>  
      </i0>  
      <i1>
        <name>conversion code 2</name>  
        <id>af092d370c452216657774c9642fecce</id>  
        <ext_id>0777792c4994222c3ae83185c2a672e4</ext_id>  
        <type>code</type>  
      </i1>  
      <i2>
        <id>2abf5efdb4e4f93ce67a6faf4e33f9e8</id>  
        <short_url>https://domain.ext/tracking_pixel_alias</short_url>  
        <type>pixel</type>  
      </i2>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url&format=txt

Query parameters

 types = code,pixel
fields = name,id,short_url
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_name=conversion code 1 (postback enabled)
result_data_0_id=e6ba6a845618e8f8136b693ce3303542
result_data_0_ext_id=1f68289b0c40dfd6885f7f0a0e73dbfa
result_data_0_ext_postback_id=8589ee72216d7dafe31b7b99f74d8ffa
result_data_0_type=code
result_data_1_name=conversion code 2
result_data_1_id=af092d370c452216657774c9642fecce
result_data_1_ext_id=0777792c4994222c3ae83185c2a672e4
result_data_1_type=code
result_data_2_id=2abf5efdb4e4f93ce67a6faf4e33f9e8
result_data_2_short_url=https://domain.ext/tracking_pixel_alias
result_data_2_type=pixel

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url&format=plain

Query parameters

 types = code,pixel
fields = name,id,short_url
format = plain

Response

conversion code 1 (postback enabled)
e6ba6a845618e8f8136b693ce3303542
1f68289b0c40dfd6885f7f0a0e73dbfa
8589ee72216d7dafe31b7b99f74d8ffa
code
conversion code 2
af092d370c452216657774c9642fecce
0777792c4994222c3ae83185c2a672e4
code
https://domain.ext/tracking_pixel_alias

Required parameters

parameter	description
typesARRAY	comma separated list of types; available types are [code, pixel]

Return values

parameter	description
count	[OPTIONAL] number of conversion, if both types are passed, it contains the sum of number of conversion codes and conversion pixels
data	array containing information on conversions

/conversions/pixels

/conversions/pixels/add

access: [WRITE]

Add a tracking pixel for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=c8ec05f9de252c5e308a8449ba674d25&url_project_id=ae42eb47cabdca8e4cfefba360a8f719&notes=

Query parameters

         alias = jot
     domain_id = c8ec05f9de252c5e308a8449ba674d25
url_project_id = ae42eb47cabdca8e4cfefba360a8f719
         notes =

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "15be17ab0a8196eddf9edb12eacf3408",
    "alias": "jot",
    "domain_id": "c8ec05f9de252c5e308a8449ba674d25",
    "domain_host": "jo.my",
    "domain_nickname": "",
    "url_project_id": "ae42eb47cabdca8e4cfefba360a8f719",
    "project_name": "project name",
    "short_url": "\/\/jo.my\/jot",
    "template_type": 2,
    "notes": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=c8ec05f9de252c5e308a8449ba674d25&url_project_id=ae42eb47cabdca8e4cfefba360a8f719&notes=&format=xml

Query parameters

         alias = jot
     domain_id = c8ec05f9de252c5e308a8449ba674d25
url_project_id = ae42eb47cabdca8e4cfefba360a8f719
         notes = 
        format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>15be17ab0a8196eddf9edb12eacf3408</id>  
    <alias>jot</alias>  
    <domain_id>c8ec05f9de252c5e308a8449ba674d25</domain_id>  
    <domain_host>jo.my</domain_host>  
    <domain_nickname></domain_nickname>  
    <url_project_id>ae42eb47cabdca8e4cfefba360a8f719</url_project_id>  
    <project_name>project name</project_name>  
    <short_url>//jo.my/jot</short_url>  
    <template_type>2</template_type>  
    <notes></notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=c8ec05f9de252c5e308a8449ba674d25&url_project_id=ae42eb47cabdca8e4cfefba360a8f719&notes=&format=txt

Query parameters

         alias = jot
     domain_id = c8ec05f9de252c5e308a8449ba674d25
url_project_id = ae42eb47cabdca8e4cfefba360a8f719
         notes = 
        format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=15be17ab0a8196eddf9edb12eacf3408
result_alias=jot
result_domain_id=c8ec05f9de252c5e308a8449ba674d25
result_domain_host=jo.my
result_domain_nickname=
result_url_project_id=ae42eb47cabdca8e4cfefba360a8f719
result_project_name=project name
result_short_url=//jo.my/jot
result_template_type=2
result_notes=

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=c8ec05f9de252c5e308a8449ba674d25&url_project_id=ae42eb47cabdca8e4cfefba360a8f719&notes=&format=plain

Query parameters

         alias = jot
     domain_id = c8ec05f9de252c5e308a8449ba674d25
url_project_id = ae42eb47cabdca8e4cfefba360a8f719
         notes = 
        format = plain

Response

//jo.my/jot

Required parameters

parameter	description	max length
aliasSTRING	alias for the tracking pixel, see i1/urls/shorten for details of available characters in alias	510

Optional parameters

parameter	description
conversion_idsARRAY_OF_IDS	ID of the associated conversion codes
domain_idID	ID of the domain for the tracking pixel, if not set the default domain for the user will be used
notesSTRING	notes for the tracking pixel
tagsARRAY_STRING	comma-separated list of tags for the tracking pixel
url_project_idID	ID of the project where the tracking pixel will be put in, if not specified the default: project is used

Return values

parameter	description
alias	see i1/urls/shorten for details on returnd fields
domain_host	see i1/urls/shorten for details on returnd fields
domain_id	see i1/urls/shorten for details on returnd fields
domain_nickname	see i1/urls/shorten for details on returnd fields
id	ID of the created tracking pixel
notes	see i1/urls/shorten for details on returnd fields
project_id	see i1/urls/shorten for details on returnd fields
project_name	see i1/urls/shorten for details on returnd fields
short_url	see i1/urls/shorten for details on returnd fields
tags	see i1/urls/shorten for details on returnd fields
tags	see i1/urls/shorten for details on returnd fields
url_conversions_number	number of associated conversion codes

/conversions/pixels/count

access: [READ]

This method returns the number of defined conversion pixels.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/pixels/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters conversion pixels to be extracted by searching them

Return values

parameter	description
count	number of (filtered) conversion pixels

/conversions/pixels/delete

access: [WRITE]

This method deletes a set of conversion pixel using their IDs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874

Query parameters

ids = ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874&format=xml

Query parameters

   ids = ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874&format=txt

Query parameters

   ids = ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874&format=plain

Query parameters

   ids = ca293a81a8692a20b4d50fd9a1d0d1b7,3620f68f8f2382745f54f8610affa853,5d5df7278aa4d0b73237fa7ed5683874
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b

Query parameters

ids = 7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": [
      "7d26129fc4aecd5eb2abb23244bf5ec9"
    ],
    "deleted": 2
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b&format=xml

Query parameters

   ids = 7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>
      <i0>7d26129fc4aecd5eb2abb23244bf5ec9</i0>  
    </ids>  
    <deleted>2</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b&format=txt

Query parameters

   ids = 7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=7d26129fc4aecd5eb2abb23244bf5ec9
result_deleted=2

Example 8 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/delete?ids=7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b&format=plain

Query parameters

   ids = 7d26129fc4aecd5eb2abb23244bf5ec9,67e8f0996eb9f697c004f630bd9993a2,a66d18cf755ec22f22dbded698d1231b
format = plain

Response

7d26129fc4aecd5eb2abb23244bf5ec9
2

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of tracking pixel IDs to be deleted

Return values

parameter	description
deleted	number of deleted tracking pixels
tracking_pixel_ids	[OPTIONAL] list of tracking pixel IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/conversions/pixels/edit

access: [WRITE]

Edit fields of a Tracking Pixel.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/pixels/edit?id=4e297259e7284914d92430a76a11c00a&alias=jot&domain_id=3d6f01880543281eabd51360aa9c5417&url_project_id=2ece43ae64a6d8da7b88b71be40f7b13&notes=new+notes

Query parameters

            id = 4e297259e7284914d92430a76a11c00a
         alias = jot
     domain_id = 3d6f01880543281eabd51360aa9c5417
url_project_id = 2ece43ae64a6d8da7b88b71be40f7b13
         notes = new notes

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "4e297259e7284914d92430a76a11c00a",
    "alias": "jot",
    "domain_id": "3d6f01880543281eabd51360aa9c5417",
    "domain_host": "jo.my",
    "domain_nickname": "",
    "url_project_id": "2ece43ae64a6d8da7b88b71be40f7b13",
    "project_name": "project name",
    "short_url": "\/\/jo.my\/jot",
    "template_type": 2,
    "notes": "new notes"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/edit?id=4e297259e7284914d92430a76a11c00a&alias=jot&domain_id=3d6f01880543281eabd51360aa9c5417&url_project_id=2ece43ae64a6d8da7b88b71be40f7b13&notes=new+notes&format=xml

Query parameters

            id = 4e297259e7284914d92430a76a11c00a
         alias = jot
     domain_id = 3d6f01880543281eabd51360aa9c5417
url_project_id = 2ece43ae64a6d8da7b88b71be40f7b13
         notes = new notes
        format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>4e297259e7284914d92430a76a11c00a</id>  
    <alias>jot</alias>  
    <domain_id>3d6f01880543281eabd51360aa9c5417</domain_id>  
    <domain_host>jo.my</domain_host>  
    <domain_nickname></domain_nickname>  
    <url_project_id>2ece43ae64a6d8da7b88b71be40f7b13</url_project_id>  
    <project_name>project name</project_name>  
    <short_url>//jo.my/jot</short_url>  
    <template_type>2</template_type>  
    <notes>new notes</notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/edit?id=4e297259e7284914d92430a76a11c00a&alias=jot&domain_id=3d6f01880543281eabd51360aa9c5417&url_project_id=2ece43ae64a6d8da7b88b71be40f7b13&notes=new+notes&format=txt

Query parameters

            id = 4e297259e7284914d92430a76a11c00a
         alias = jot
     domain_id = 3d6f01880543281eabd51360aa9c5417
url_project_id = 2ece43ae64a6d8da7b88b71be40f7b13
         notes = new notes
        format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=4e297259e7284914d92430a76a11c00a
result_alias=jot
result_domain_id=3d6f01880543281eabd51360aa9c5417
result_domain_host=jo.my
result_domain_nickname=
result_url_project_id=2ece43ae64a6d8da7b88b71be40f7b13
result_project_name=project name
result_short_url=//jo.my/jot
result_template_type=2
result_notes=new notes

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/edit?id=4e297259e7284914d92430a76a11c00a&alias=jot&domain_id=3d6f01880543281eabd51360aa9c5417&url_project_id=2ece43ae64a6d8da7b88b71be40f7b13&notes=new+notes&format=plain

Query parameters

            id = 4e297259e7284914d92430a76a11c00a
         alias = jot
     domain_id = 3d6f01880543281eabd51360aa9c5417
url_project_id = 2ece43ae64a6d8da7b88b71be40f7b13
         notes = new notes
        format = plain

Response

//jo.my/jot

Required parameters

parameter	description
idID	ID of the tracking pixel

Optional parameters

parameter	description
conversion_idsARRAY_OF_IDS	ID of the associated conversion codes
notesSTRING	notes for the tracking pixel
tagsARRAY_STRING	comma-separated list of tags for the tracking pixel

Return values

parameter	description
alias	see i1/urls/shorten for details on returnd fields
domain_host	see i1/urls/shorten for details on returnd fields
domain_id	see i1/urls/shorten for details on returnd fields
id	ID of the created tracking pixel
long_url	see i1/urls/shorten for details on returnd fields
notes	see i1/urls/shorten for details on returnd fields
project_id	see i1/urls/shorten for details on returnd fields
project_name	see i1/urls/shorten for details on returnd fields
short_url	see i1/urls/shorten for details on returnd fields
tags	see i1/urls/shorten for details on returnd fields
url_conversions_number	number of associated conversion codes

/conversions/pixels/info

access: [READ]

This method returns information specified in a comma separated input called fields about a conversion.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=c1cfe4fa00774deaae6de813dd3c0f32

Query parameters

fields = id,short_url
    id = c1cfe4fa00774deaae6de813dd3c0f32

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "c1cfe4fa00774deaae6de813dd3c0f32",
        "short_url": "http:\/\/jo.my\/6fa6d176"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=c1cfe4fa00774deaae6de813dd3c0f32&format=xml

Query parameters

fields = id,short_url
    id = c1cfe4fa00774deaae6de813dd3c0f32
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>c1cfe4fa00774deaae6de813dd3c0f32</id>  
        <short_url>http://jo.my/6fa6d176</short_url>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=c1cfe4fa00774deaae6de813dd3c0f32&format=txt

Query parameters

fields = id,short_url
    id = c1cfe4fa00774deaae6de813dd3c0f32
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=c1cfe4fa00774deaae6de813dd3c0f32
result_data_0_short_url=http://jo.my/6fa6d176

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=c1cfe4fa00774deaae6de813dd3c0f32&format=plain

Query parameters

fields = id,short_url
    id = c1cfe4fa00774deaae6de813dd3c0f32
format = plain

Response

http://jo.my/6fa6d176

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, see method i1/conversions/pixels/list for reference
idID	ID of the tracking pixel whose information is required

Return values

parameter	description
data	array containing 1 item on success, the returned information depends on the fields parameter.

/conversions/pixels/list

access: [READ]

This method returns a list of tracking pixels.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=904d7525d8cef8676ba46e5c11aab636

Query parameters

        fields = id,short_url
url_project_id = 904d7525d8cef8676ba46e5c11aab636

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "c45512e000de45ffa78b3cfff34a4365",
        "short_url": "http:\/\/jo.my\/d588a1b8"
      },
      {
        "id": "16c3bf2eda56dd7b30d732d9a16c7cf4",
        "short_url": "http:\/\/jo.my\/8bc40634"
      },
      {
        "id": "c7ffb387a1c0e781d7537a23b716369e",
        "short_url": "http:\/\/jo.my\/28e7d3e9"
      },
      {
        "id": "63575a94135b2105162c83bf6c711d95",
        "short_url": "http:\/\/jo.my\/2a26fb77"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=904d7525d8cef8676ba46e5c11aab636&format=xml

Query parameters

        fields = id,short_url
url_project_id = 904d7525d8cef8676ba46e5c11aab636
        format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>c45512e000de45ffa78b3cfff34a4365</id>  
        <short_url>http://jo.my/d588a1b8</short_url>  
      </i0>  
      <i1>
        <id>16c3bf2eda56dd7b30d732d9a16c7cf4</id>  
        <short_url>http://jo.my/8bc40634</short_url>  
      </i1>  
      <i2>
        <id>c7ffb387a1c0e781d7537a23b716369e</id>  
        <short_url>http://jo.my/28e7d3e9</short_url>  
      </i2>  
      <i3>
        <id>63575a94135b2105162c83bf6c711d95</id>  
        <short_url>http://jo.my/2a26fb77</short_url>  
      </i3>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=904d7525d8cef8676ba46e5c11aab636&format=txt

Query parameters

        fields = id,short_url
url_project_id = 904d7525d8cef8676ba46e5c11aab636
        format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=c45512e000de45ffa78b3cfff34a4365
result_data_0_short_url=http://jo.my/d588a1b8
result_data_1_id=16c3bf2eda56dd7b30d732d9a16c7cf4
result_data_1_short_url=http://jo.my/8bc40634
result_data_2_id=c7ffb387a1c0e781d7537a23b716369e
result_data_2_short_url=http://jo.my/28e7d3e9
result_data_3_id=63575a94135b2105162c83bf6c711d95
result_data_3_short_url=http://jo.my/2a26fb77

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=904d7525d8cef8676ba46e5c11aab636&format=plain

Query parameters

        fields = id,short_url
url_project_id = 904d7525d8cef8676ba46e5c11aab636
        format = plain

Response

http://jo.my/d588a1b8
http://jo.my/8bc40634
http://jo.my/28e7d3e9
http://jo.my/2a26fb77

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: count, id, short_url, creation, url_tags, clicks, unique_visits, qrcodes_visits, conversions_visits, notes, alias

Optional parameters

parameter	description
idID	ID of the tracking pixel
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: count, id, short_url, creation, url_tags, clicks, unique_visits, qrcodes_visits, conversions_visits, notes, alias
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
data	array containing information on the tracking pixels, the returned information depends on the fields parameter.

Available fields in the data array:

id: ID of the tracking pixel
alias: alias of the tracking pixel
short_url: short URL for the tracking pixel
creation: date/time of creation of the tracking pixel
tags: space separated list of tags associated with the tracking pixel
clicks: number of visits on the tracking pixel
unique_visits: number of unique visits on the tracking pixel
qrcodes_visits: number of visits on the tracking pixel coming from QR codes
conversions_visits: number of conversions clicks on the tracking pixel
notes: notes for tracking pixel
options: list of enabled options on the tracking pixel, see i1/urls/options/list for a list of available options
project_id: ID of the project of the tracking pixel
project_name: name of the project of the tracking pixel
domain_host: domain of the tracking pixel
domain_id: ID of the domain of the tracking pixel

/conversions/settings

/conversions/settings/get

access: [READ]

This method returns global setting for conversions.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/settings/get

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "last_or_first_click": "last",
    "expiration_cookie": "30",
    "currency_id": "1f40db5aa54b642ebe42c3212a499eef"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/settings/get?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <last_or_first_click>last</last_or_first_click>  
    <expiration_cookie>30</expiration_cookie>  
    <currency_id>1f40db5aa54b642ebe42c3212a499eef</currency_id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/settings/get?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_last_or_first_click=last
result_expiration_cookie=30
result_currency_id=1f40db5aa54b642ebe42c3212a499eef

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/settings/get?format=plain

Query parameters

format = plain

Response

last
30
1f40db5aa54b642ebe42c3212a499eef

Return values

parameter	description
currency_id	ID of the currency to apply to conversions, see i1/currencies/list for details
expiration_cookie	expiration period (in days) for conversion cookies
last_or_first_click	the click is assigned to the `first` or `last` click

/conversions/settings/property

access: [READ]

This method returns default values and properties for conversion settings.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/settings/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "default_last_or_first_click": "last",
    "default_expiration_cookie": "30",
    "default_currency_id": "644a4b356f74446f62613864764b3762725a343966673d3d",
    "default_clickbank_secret_key": "",
    "expiration_cookie_days": [
      1,
      7,
      30,
      60,
      90
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/settings/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <default_last_or_first_click>last</default_last_or_first_click>  
    <default_expiration_cookie>30</default_expiration_cookie>  
    <default_currency_id>644a4b356f74446f62613864764b3762725a343966673d3d</default_currency_id>  
    <default_clickbank_secret_key></default_clickbank_secret_key>  
    <expiration_cookie_days>
      <i0>1</i0>  
      <i1>7</i1>  
      <i2>30</i2>  
      <i3>60</i3>  
      <i4>90</i4>  
    </expiration_cookie_days>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/settings/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_default_last_or_first_click=last
result_default_expiration_cookie=30
result_default_currency_id=644a4b356f74446f62613864764b3762725a343966673d3d
result_default_clickbank_secret_key=
result_expiration_cookie_days_0=1
result_expiration_cookie_days_1=7
result_expiration_cookie_days_2=30
result_expiration_cookie_days_3=60
result_expiration_cookie_days_4=90

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/settings/property?format=plain

Query parameters

format = plain

Response

last
30
644a4b356f74446f62613864764b3762725a343966673d3d

1
7
30
60
90

Return values

parameter	description
default_clickbank_secret_key	default ClickBank secret key
default_currency_id	default currency ID for the conversion, see i1/currencies/list for details
default_expiration_cookie	default expiration (in days) for the conversion cookie
default_last_or_first_click	default behavior for the click assignment
expiration_cookie_days	list of allowed expiration days

/conversions/settings/set

access: [WRITE]

This method sets global setting for conversions.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30&currency_id=09c171c4566eececc1d4d2fe13c256c8&clickbank_secret_key=663F023404732E5C

Query parameters

 last_or_first_click = last
   expiration_cookie = 30
         currency_id = 09c171c4566eececc1d4d2fe13c256c8
clickbank_secret_key = 663F023404732E5C

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30&currency_id=09c171c4566eececc1d4d2fe13c256c8&clickbank_secret_key=663F023404732E5C&format=xml

Query parameters

 last_or_first_click = last
   expiration_cookie = 30
         currency_id = 09c171c4566eececc1d4d2fe13c256c8
clickbank_secret_key = 663F023404732E5C
              format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30&currency_id=09c171c4566eececc1d4d2fe13c256c8&clickbank_secret_key=663F023404732E5C&format=txt

Query parameters

 last_or_first_click = last
   expiration_cookie = 30
         currency_id = 09c171c4566eececc1d4d2fe13c256c8
clickbank_secret_key = 663F023404732E5C
              format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30&currency_id=09c171c4566eececc1d4d2fe13c256c8&clickbank_secret_key=663F023404732E5C&format=plain

Query parameters

 last_or_first_click = last
   expiration_cookie = 30
         currency_id = 09c171c4566eececc1d4d2fe13c256c8
clickbank_secret_key = 663F023404732E5C
              format = plain

Response

Required parameters

parameter	description
clickbank_secret_keySTRING	ClickBank secret key
currency_idID	ID of the currency to apply to conversions, see i1/currencies/list for details
expiration_cookieINTEGER	expiration period (in days) for conversion cookies, available values: 1, 7, 30, 60, 90
last_or_first_clickSTRING	assign a conversion to the `first` or `last` click made by the user on the tracking link/pixel

Return values

parameter	description
updated	1 on success, 0 otherwise

/ctas

/ctas/count

access: [READ]

This method returns the number of defined call to actions.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters CTAs to be extracted by searching them
typesSTRING	comma-separated list of types to filter CTAs, for available types see i1/ctas/property

Return values

parameter	description
count	number of (filtered) CTAs

/ctas/delete

access: [WRITE]

This method deletes a set of CTAs by using their IDs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/delete?ids=48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050

Query parameters

ids = 48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/delete?ids=48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050&format=xml

Query parameters

   ids = 48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/delete?ids=48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050&format=txt

Query parameters

   ids = 48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/delete?ids=48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050&format=plain

Query parameters

   ids = 48be7f376cf03cd530abf28751b5165d,c6cf2d2127d84158ccb9f3d0a9e7f41c,f99aeb227a0bc90c3f28f6347aec3050
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/ctas/delete?ids=ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7

Query parameters

ids = ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/ctas/delete?ids=ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7&format=xml

Query parameters

   ids = ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/ctas/delete?ids=ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7&format=txt

Query parameters

   ids = ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/ctas/delete?ids=ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7&format=plain

Query parameters

   ids = ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227,ea7268d8d93926ec5a8cd0eb619c27c7
format = plain

Response

ce1087fd3b085935aaa6bb14714a40a8,b7a6d77c04f8fa58a013c6c9699ce227
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of CTA IDs to be deleted

Return values

parameter	description
deleted	number of deleted CTAs
ids	[OPTIONAL] list of CTA IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/ctas/download

access: [READ]

This method returns data that is collected for a specific CTA. Only data collected in the last 90 days can be returned.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f

Query parameters

id = 392ad74138024f80d9e11c327c8b4e3f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "headers": [
      "name",
      "age",
      "email"
    ],
    "lines": [
      [
        "John",
        "27",
        "john@example.com"
      ],
      [
        "Doo",
        "31",
        "doo@example.com"
      ]
    ],
    "extracted": 2,
    "skipped": 3,
    "count": 5,
    "next": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&format=xml

Query parameters

    id = 392ad74138024f80d9e11c327c8b4e3f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <headers>
      <i0>name</i0>  
      <i1>age</i1>  
      <i2>email</i2>  
    </headers>  
    <lines>
      <i0>
        <i0>John</i0>  
        <i1>27</i1>  
        <i2>john@example.com</i2>  
      </i0>  
      <i1>
        <i0>Doo</i0>  
        <i1>31</i1>  
        <i2>doo@example.com</i2>  
      </i1>  
    </lines>  
    <extracted>2</extracted>  
    <skipped>3</skipped>  
    <count>5</count>  
    <next></next>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&format=txt

Query parameters

    id = 392ad74138024f80d9e11c327c8b4e3f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_headers_0=name
result_headers_1=age
result_headers_2=email
result_lines_0_0=John
result_lines_0_1=27
result_lines_0_2=john@example.com
result_lines_1_0=Doo
result_lines_1_1=31
result_lines_1_2=doo@example.com
result_extracted=2
result_skipped=3
result_count=5
result_next=

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&format=plain

Query parameters

    id = 392ad74138024f80d9e11c327c8b4e3f
format = plain

Response

name
age
email
John
27
john@example.com
Doo
31
doo@example.com
2
3
5

Example 5 (json)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&return_json=1

Query parameters

         id = 392ad74138024f80d9e11c327c8b4e3f
return_json = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "name": "John",
        "age": "27",
        "email": "john@example.com"
      },
      {
        "name": "Doo",
        "age": "31",
        "email": "doo@example.com"
      }
    ],
    "extracted": 2,
    "skipped": 3,
    "count": 5,
    "next": ""
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&return_json=1&format=xml

Query parameters

         id = 392ad74138024f80d9e11c327c8b4e3f
return_json = 1
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <name>John</name>  
        <age>27</age>  
        <email>john@example.com</email>  
      </i0>  
      <i1>
        <name>Doo</name>  
        <age>31</age>  
        <email>doo@example.com</email>  
      </i1>  
    </data>  
    <extracted>2</extracted>  
    <skipped>3</skipped>  
    <count>5</count>  
    <next></next>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&return_json=1&format=txt

Query parameters

         id = 392ad74138024f80d9e11c327c8b4e3f
return_json = 1
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_name=John
result_data_0_age=27
result_data_0_email=john@example.com
result_data_1_name=Doo
result_data_1_age=31
result_data_1_email=doo@example.com
result_extracted=2
result_skipped=3
result_count=5
result_next=

Example 8 (plain)

Request

https://joturl.com/a/i1/ctas/download?id=392ad74138024f80d9e11c327c8b4e3f&return_json=1&format=plain

Query parameters

         id = 392ad74138024f80d9e11c327c8b4e3f
return_json = 1
     format = plain

Response

John
27
john@example.com
Doo
31
doo@example.com
2
3
5

Required parameters

parameter	description
idID	ID of the call to action

Optional parameters

parameter	description
from_dateDATE	date (inclusive) from which to start the export (default: 90 days before today)
lengthINTEGER	number of items to return (default: 1000, max value: 1000)
return_jsonBOOLEAN	if 1 this method returns a JSON `data` fields instead of `headers` and `lines` fields (default: 0)
sampleBOOLEAN	1 to return sample data, 0 otherwise (default: 0)
startINTEGER	index of the starting item to retrieve (default: 0)
to_dateDATE	date (inclusive) to finish the export (default: today)

Return values

parameter	description
count	maximum number of items
data	[OPTIONAL] alternative to `headers` and `lines`, returned if return_json=1
extracted	number of extracted items
headers	[OPTIONAL] names of the corresponding information returned in lines, returned if return_json=0
lines	[OPTIONAL] array containing information of the CTA data, returned if return_json=0
next	URL to be called in order to fetch the next page of the list
skipped	number of skipped items

/ctas/socialapps

/ctas/socialapps/add

access: [WRITE]

Add a new social app.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=0ed36ed55884c8952c3035f40907d5ad&secret=ff97c1c3a3a744855cb4ad55f08a2271

Query parameters

provider = facebook
    name = my custom social app
   appid = 0ed36ed55884c8952c3035f40907d5ad
  secret = ff97c1c3a3a744855cb4ad55f08a2271

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "provider": "facebook",
    "id": "23de77659187364f7d0f06cc341a418e",
    "name": "my custom social app",
    "appid": "0ed36ed55884c8952c3035f40907d5ad"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=0ed36ed55884c8952c3035f40907d5ad&secret=ff97c1c3a3a744855cb4ad55f08a2271&format=xml

Query parameters

provider = facebook
    name = my custom social app
   appid = 0ed36ed55884c8952c3035f40907d5ad
  secret = ff97c1c3a3a744855cb4ad55f08a2271
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <provider>facebook</provider>  
    <id>23de77659187364f7d0f06cc341a418e</id>  
    <name>my custom social app</name>  
    <appid>0ed36ed55884c8952c3035f40907d5ad</appid>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=0ed36ed55884c8952c3035f40907d5ad&secret=ff97c1c3a3a744855cb4ad55f08a2271&format=txt

Query parameters

provider = facebook
    name = my custom social app
   appid = 0ed36ed55884c8952c3035f40907d5ad
  secret = ff97c1c3a3a744855cb4ad55f08a2271
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_provider=facebook
result_id=23de77659187364f7d0f06cc341a418e
result_name=my custom social app
result_appid=0ed36ed55884c8952c3035f40907d5ad

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=0ed36ed55884c8952c3035f40907d5ad&secret=ff97c1c3a3a744855cb4ad55f08a2271&format=plain

Query parameters

provider = facebook
    name = my custom social app
   appid = 0ed36ed55884c8952c3035f40907d5ad
  secret = ff97c1c3a3a744855cb4ad55f08a2271
  format = plain

Response

facebook
23de77659187364f7d0f06cc341a418e
my custom social app
0ed36ed55884c8952c3035f40907d5ad

Required parameters

parameter	description	max length
appidSTRING	social app ID/Key/Client ID	255
nameSTRING	name of the social app	255
providerSTRING	name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph	50
secretSTRING	social app secret	255

Return values

parameter	description
appid	social app ID/Key/Client ID
id	ID of the social app
name	name of the social app
provider	name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph

/ctas/socialapps/count

access: [READ]

This method returns the number of defined social apps.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description	max length
providerSTRING	name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph	50
searchSTRING	count items by searching them

Return values

parameter	description
count	number of social apps the user has access to (filtered by search if passed)

/ctas/socialapps/delete

access: [WRITE]

Delete a social app.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed

Query parameters

ids = 1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed&format=xml

Query parameters

   ids = 1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>2</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed&format=txt

Query parameters

   ids = 1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=2

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed&format=plain

Query parameters

   ids = 1761dc2f81ee9c64b8429c25a26217f4,0e7e96c6e40920fb000e33f96ff599ed
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232

Query parameters

ids = 0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232&format=xml

Query parameters

   ids = 0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232&format=txt

Query parameters

   ids = 0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/delete?ids=0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232&format=plain

Query parameters

   ids = 0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b,0bb3db730ed89d13c55428477d82e232
format = plain

Response

0ef9639abc52f459140e6a578ba7fbaf,9df14c52eb3536d5224ba20b6c90419b
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of social app IDs to be deleted

Optional parameters

parameter	description
confirmBOOLEAN	1 to force the cancellation of social apps even if in use (default: 0)

Return values

parameter	description
deleted	number of deleted social apps
ids	[OPTIONAL] list of social app IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/ctas/socialapps/edit

access: [WRITE]

Edit a social app.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=8a377e04e2d96b9e4bdd1dadfd59fccf

Query parameters

provider = facebook
    name = social app name
   appid = 8a377e04e2d96b9e4bdd1dadfd59fccf

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "2c6e05406a39b5f48e13d282b36f3f8c",
    "provider": "facebook",
    "name": "social app name",
    "appid": "8a377e04e2d96b9e4bdd1dadfd59fccf"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=8a377e04e2d96b9e4bdd1dadfd59fccf&format=xml

Query parameters

provider = facebook
    name = social app name
   appid = 8a377e04e2d96b9e4bdd1dadfd59fccf
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>2c6e05406a39b5f48e13d282b36f3f8c</id>  
    <provider>facebook</provider>  
    <name>social app name</name>  
    <appid>8a377e04e2d96b9e4bdd1dadfd59fccf</appid>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=8a377e04e2d96b9e4bdd1dadfd59fccf&format=txt

Query parameters

provider = facebook
    name = social app name
   appid = 8a377e04e2d96b9e4bdd1dadfd59fccf
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=2c6e05406a39b5f48e13d282b36f3f8c
result_provider=facebook
result_name=social app name
result_appid=8a377e04e2d96b9e4bdd1dadfd59fccf

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=8a377e04e2d96b9e4bdd1dadfd59fccf&format=plain

Query parameters

provider = facebook
    name = social app name
   appid = 8a377e04e2d96b9e4bdd1dadfd59fccf
  format = plain

Response

2c6e05406a39b5f48e13d282b36f3f8c
facebook
social app name
8a377e04e2d96b9e4bdd1dadfd59fccf

Required parameters

parameter	description
idID	ID of the social app

Optional parameters

parameter	description	max length
appidSTRING	social app ID/Key/Client ID	255
nameSTRING	name of the social app	255
providerSTRING	name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph	50
secretSTRING	social app secret	255

Return values

parameter	description
appid	social app ID/Key/Client ID
id	ID of the social app
name	name of the social app
provider	name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph

/ctas/socialapps/info

access: [READ]

This method returns information on a social app.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/info?id=34f9f9577aba08c212b2ba182af30981

Query parameters

id = 34f9f9577aba08c212b2ba182af30981

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "34f9f9577aba08c212b2ba182af30981",
    "provider": "facebook",
    "name": "this is my app name",
    "appid": "187edc8123c80f2a9c78c0a32cbb55d5"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/info?id=34f9f9577aba08c212b2ba182af30981&format=xml

Query parameters

    id = 34f9f9577aba08c212b2ba182af30981
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>34f9f9577aba08c212b2ba182af30981</id>  
    <provider>facebook</provider>  
    <name>this is my app name</name>  
    <appid>187edc8123c80f2a9c78c0a32cbb55d5</appid>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/info?id=34f9f9577aba08c212b2ba182af30981&format=txt

Query parameters

    id = 34f9f9577aba08c212b2ba182af30981
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=34f9f9577aba08c212b2ba182af30981
result_provider=facebook
result_name=this is my app name
result_appid=187edc8123c80f2a9c78c0a32cbb55d5

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/info?id=34f9f9577aba08c212b2ba182af30981&format=plain

Query parameters

    id = 34f9f9577aba08c212b2ba182af30981
format = plain

Response

34f9f9577aba08c212b2ba182af30981
facebook
this is my app name
187edc8123c80f2a9c78c0a32cbb55d5

Required parameters

parameter	description
idID	ID of the social app

Return values

parameter	description
appid	social app ID/Key/Client ID
id	ID of the social app
name	name of the social app
provider	name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph

/ctas/socialapps/list

access: [READ]

This method returns a list of social apps.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": {
      "id": "72bfa2d1c58a92a00f6ecbd15c87b404",
      "provider": "facebook",
      "name": "this is my app name",
      "appid": "035970dd2ff50901ca1e08bcf341a8ef"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <id>72bfa2d1c58a92a00f6ecbd15c87b404</id>  
      <provider>facebook</provider>  
      <name>this is my app name</name>  
      <appid>035970dd2ff50901ca1e08bcf341a8ef</appid>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_id=72bfa2d1c58a92a00f6ecbd15c87b404
result_data_provider=facebook
result_data_name=this is my app name
result_data_appid=035970dd2ff50901ca1e08bcf341a8ef

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/list?format=plain

Query parameters

format = plain

Response

1
72bfa2d1c58a92a00f6ecbd15c87b404
facebook
this is my app name
035970dd2ff50901ca1e08bcf341a8ef

Optional parameters

parameter	description	max length
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: start, length, search, orderby, sort, provider, format, callback
providerSTRING	filter social apps by provider, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph	50
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	total number of social apps
data	array containing information on social apps the user has access to

/ctas/socialapps/property

access: [READ]

Returns the supported social app providers.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/socialapps/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "providers": [
        "amazon",
        "facebook",
        "google",
        "linkedin",
        "microsoftgraph",
        "twitter"
      ]
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/socialapps/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <providers>
        <i0>amazon</i0>  
        <i1>facebook</i1>  
        <i2>google</i2>  
        <i3>linkedin</i3>  
        <i4>microsoftgraph</i4>  
        <i5>twitter</i5>  
      </providers>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/socialapps/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_providers_0=amazon
result_data_providers_1=facebook
result_data_providers_2=google
result_data_providers_3=linkedin
result_data_providers_4=microsoftgraph
result_data_providers_5=twitter

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/socialapps/property?format=plain

Query parameters

format = plain

Response

amazon
facebook
google
linkedin
microsoftgraph
twitter

Return values

parameter	description
data	list of supported social apps

/ctas/urls

/ctas/urls/count

access: [READ]

This method returns the number of user's urls related to a call to action.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/urls/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/urls/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/urls/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/urls/count?format=plain

Query parameters

format = plain

Response

Required parameters

parameter	description
cta_idID	ID of the CTA

Optional parameters

parameter	description
searchSTRING	filters tracking pixels to be extracted by searching them

Return values

parameter	description
count	number of (filtered) tracking pixels

/ctas/urls/list

access: [READ]

This method returns a list of user's urls data related to a call to action.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/urls/list?id=60518795b401888e5d1504d2be935707&fields=count,id,url_url

Query parameters

    id = 60518795b401888e5d1504d2be935707
fields = count,id,url_url

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "id": "d7b1292effa7f8feef20a7a5f9db9be5",
        "url_url": "2352ade2"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/urls/list?id=60518795b401888e5d1504d2be935707&fields=count,id,url_url&format=xml

Query parameters

    id = 60518795b401888e5d1504d2be935707
fields = count,id,url_url
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <id>d7b1292effa7f8feef20a7a5f9db9be5</id>  
        <url_url>2352ade2</url_url>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/urls/list?id=60518795b401888e5d1504d2be935707&fields=count,id,url_url&format=txt

Query parameters

    id = 60518795b401888e5d1504d2be935707
fields = count,id,url_url
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=d7b1292effa7f8feef20a7a5f9db9be5
result_data_0_url_url=2352ade2

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/urls/list?id=60518795b401888e5d1504d2be935707&fields=count,id,url_url&format=plain

Query parameters

    id = 60518795b401888e5d1504d2be935707
fields = count,id,url_url
format = plain

Response

1
d7b1292effa7f8feef20a7a5f9db9be5
2352ade2

Required parameters

parameter	description
cta_idID	ID of the CTA
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, url_url, short_url, url_creation, url, has_preview, domain_extended_name, domain_id, project_name, project_is_default, project_id

Optional parameters

parameter	description
lengthINTEGER	extracts this number of tracking links (maxmimum allowed: 100)
orderbyARRAY	orders tracking links by field, available fields: id, url_url, short_url, url_creation, url, has_preview, domain_extended_name, domain_id, project_name, project_is_default, project_id
searchSTRING	filters tracking links to be extracted by searching them
sortSTRING	sorts tracking links in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract tracking links from this position

Return values

parameter	description
count	[OPTIONAL] total number of tracking links, returned only if count is passed in fields
data	array containing information on the tracking links, the returned information depends on the fields parameter.

/ctas/webhooks

/ctas/webhooks/info

access: [READ]

This method return information on a webhook.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/webhooks/info?id=32dc0d9add0a92dd0cc49c38bf9b0a9f

Query parameters

id = 32dc0d9add0a92dd0cc49c38bf9b0a9f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "32dc0d9add0a92dd0cc49c38bf9b0a9f",
    "url": "https:\/\/my.custom.webhook\/",
    "type": "custom",
    "info": [],
    "notes": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/webhooks/info?id=32dc0d9add0a92dd0cc49c38bf9b0a9f&format=xml

Query parameters

    id = 32dc0d9add0a92dd0cc49c38bf9b0a9f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>32dc0d9add0a92dd0cc49c38bf9b0a9f</id>  
    <url>https://my.custom.webhook/</url>  
    <type>custom</type>  
    <info>

    </info>  
    <notes></notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/webhooks/info?id=32dc0d9add0a92dd0cc49c38bf9b0a9f&format=txt

Query parameters

    id = 32dc0d9add0a92dd0cc49c38bf9b0a9f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=32dc0d9add0a92dd0cc49c38bf9b0a9f
result_url=https://my.custom.webhook/
result_type=custom
result_info=
result_notes=

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/webhooks/info?id=32dc0d9add0a92dd0cc49c38bf9b0a9f&format=plain

Query parameters

    id = 32dc0d9add0a92dd0cc49c38bf9b0a9f
format = plain

Response

32dc0d9add0a92dd0cc49c38bf9b0a9f
https://my.custom.webhook/
custom

Required parameters

parameter	description
idID	ID of the CTA from which to remove the webhook

Return values

parameter	description
id	echo back of the `id` input parameter
info	extended info of the webhook
notes	notes for the webhook
type	webhook type, see i1/ctas/webhooks/property for details
url	URL of the webhook

/ctas/webhooks/property

access: [READ]

Return available webhook types and their parameters.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite

Query parameters

types = custom,zapier,mailerlite

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "custom": {
        "name": "Custom webhook",
        "private": 0,
        "url_required": 1,
        "info": {
          "home": "https:\/\/joturl.zendesk.com\/hc\/en-us\/articles\/360012882199",
          "logo": "data:image\/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg=="
        },
        "parameters": [
          {
            "name": "fields",
            "type": "json",
            "maxlength": 2000,
            "description": "couples key\/values",
            "mandatory": 0,
            "example": "{\"source\":\"joturl\",\"test\":1}"
          }
        ]
      },
      "mailerlite": {
        "name": "MailerLite",
        "private": 0,
        "url_required": 0,
        "info": {
          "home": "https:\/\/www.mailerlite.com\/",
          "logo": "https:\/\/www.mailerlite.com\/assets\/logo-color.png"
        },
        "parameters": [
          {
            "name": "apikey",
            "type": "string",
            "maxlength": 500,
            "description": "MailerLite API key",
            "documentation": "https:\/\/help.mailerlite.com\/article\/show\/35040-where-can-i-find-the-api-key",
            "mandatory": 1,
            "example": "e048310c95a6e2621176a3c3d212a871"
          },
          {
            "name": "group",
            "type": "string",
            "maxlength": 500,
            "description": "GroupID of the MailerLite group",
            "documentation": "https:\/\/app.mailerlite.com\/subscribe\/api",
            "mandatory": 1,
            "example": "350624272"
          },
          {
            "name": "fields",
            "type": "json",
            "maxlength": 2000,
            "description": "couples key\/values",
            "mandatory": 0,
            "example": "{\"source\":\"joturl\",\"test\":1}"
          }
        ]
      },
      "zapier": {
        "name": "Zapier",
        "private": 1,
        "url_required": 0,
        "info": {
          "home": "https:\/\/zapier.com\/",
          "logo": "https:\/\/cdn.zapier.com\/zapier\/images\/logos\/zapier-logo.png"
        },
        "parameters": []
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite&format=xml

Query parameters

 types = custom,zapier,mailerlite
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <custom>
        <name>Custom webhook</name>  
        <private>0</private>  
        <url_required>1</url_required>  
        <info>
          <home>https://joturl.zendesk.com/hc/en-us/articles/360012882199</home>  
          <logo>data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==</logo>  
        </info>  
        <parameters>
          <i0>
            <name>fields</name>  
            <type>json</type>  
            <maxlength>2000</maxlength>  
            <description>couples key/values</description>  
            <mandatory>0</mandatory>  
            <example>{"source":"joturl","test":1}</example>  
          </i0>  
        </parameters>  
      </custom>  
      <mailerlite>
        <name>MailerLite</name>  
        <private>0</private>  
        <url_required>0</url_required>  
        <info>
          <home>https://www.mailerlite.com/</home>  
          <logo>https://www.mailerlite.com/assets/logo-color.png</logo>  
        </info>  
        <parameters>
          <i0>
            <name>apikey</name>  
            <type>string</type>  
            <maxlength>500</maxlength>  
            <description>MailerLite API key</description>  
            <documentation>https://help.mailerlite.com/article/show/35040-where-can-i-find-the-api-key</documentation>  
            <mandatory>1</mandatory>  
            <example>e048310c95a6e2621176a3c3d212a871</example>  
          </i0>  
          <i1>
            <name>group</name>  
            <type>string</type>  
            <maxlength>500</maxlength>  
            <description>GroupID of the MailerLite group</description>  
            <documentation>https://app.mailerlite.com/subscribe/api</documentation>  
            <mandatory>1</mandatory>  
            <example>350624272</example>  
          </i1>  
          <i2>
            <name>fields</name>  
            <type>json</type>  
            <maxlength>2000</maxlength>  
            <description>couples key/values</description>  
            <mandatory>0</mandatory>  
            <example>{"source":"joturl","test":1}</example>  
          </i2>  
        </parameters>  
      </mailerlite>  
      <zapier>
        <name>Zapier</name>  
        <private>1</private>  
        <url_required>0</url_required>  
        <info>
          <home>https://zapier.com/</home>  
          <logo>https://cdn.zapier.com/zapier/images/logos/zapier-logo.png</logo>  
        </info>  
        <parameters>

        </parameters>  
      </zapier>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite&format=txt

Query parameters

 types = custom,zapier,mailerlite
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_custom_name=Custom webhook
result_data_custom_private=0
result_data_custom_url_required=1
result_data_custom_info_home=https://joturl.zendesk.com/hc/en-us/articles/360012882199
result_data_custom_info_logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
result_data_custom_parameters_0_name=fields
result_data_custom_parameters_0_type=json
result_data_custom_parameters_0_maxlength=2000
result_data_custom_parameters_0_description=couples key/values
result_data_custom_parameters_0_mandatory=0
result_data_custom_parameters_0_example={"source":"joturl","test":1}
result_data_mailerlite_name=MailerLite
result_data_mailerlite_private=0
result_data_mailerlite_url_required=0
result_data_mailerlite_info_home=https://www.mailerlite.com/
result_data_mailerlite_info_logo=https://www.mailerlite.com/assets/logo-color.png
result_data_mailerlite_parameters_0_name=apikey
result_data_mailerlite_parameters_0_type=string
result_data_mailerlite_parameters_0_maxlength=500
result_data_mailerlite_parameters_0_description=MailerLite API key
result_data_mailerlite_parameters_0_documentation=https://help.mailerlite.com/article/show/35040-where-can-i-find-the-api-key
result_data_mailerlite_parameters_0_mandatory=1
result_data_mailerlite_parameters_0_example=e048310c95a6e2621176a3c3d212a871
result_data_mailerlite_parameters_1_name=group
result_data_mailerlite_parameters_1_type=string
result_data_mailerlite_parameters_1_maxlength=500
result_data_mailerlite_parameters_1_description=GroupID of the MailerLite group
result_data_mailerlite_parameters_1_documentation=https://app.mailerlite.com/subscribe/api
result_data_mailerlite_parameters_1_mandatory=1
result_data_mailerlite_parameters_1_example=350624272
result_data_mailerlite_parameters_2_name=fields
result_data_mailerlite_parameters_2_type=json
result_data_mailerlite_parameters_2_maxlength=2000
result_data_mailerlite_parameters_2_description=couples key/values
result_data_mailerlite_parameters_2_mandatory=0
result_data_mailerlite_parameters_2_example={"source":"joturl","test":1}
result_data_zapier_name=Zapier
result_data_zapier_private=1
result_data_zapier_url_required=0
result_data_zapier_info_home=https://zapier.com/
result_data_zapier_info_logo=https://cdn.zapier.com/zapier/images/logos/zapier-logo.png
result_data_zapier_parameters=

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite&format=plain

Query parameters

 types = custom,zapier,mailerlite
format = plain

Response

Custom webhook
0
1
https://joturl.zendesk.com/hc/en-us/articles/360012882199
data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
fields
json
2000
couples key/values
0
{"source":"joturl","test":1}
MailerLite
0
0
https://www.mailerlite.com/
https://www.mailerlite.com/assets/logo-color.png
apikey
string
500
MailerLite API key
https://help.mailerlite.com/article/show/35040-where-can-i-find-the-api-key
1
e048310c95a6e2621176a3c3d212a871
group
string
500
GroupID of the MailerLite group
https://app.mailerlite.com/subscribe/api
1
350624272
fields
json
2000
couples key/values
0
{"source":"joturl","test":1}
Zapier
1
0
https://zapier.com/
https://cdn.zapier.com/zapier/images/logos/zapier-logo.png

Optional parameters

parameter	description
typesSTRING	comma-separated list of webhook types to be returned, if empty all types are returned, available types: `activecampaign`, `custom`, `drift`, `getresponse`, `hubspot`, `mailchimp`, `mailerlite`, `mailjet`, `mautic`, `moosend`, `sendinblue`, `zapier`

Return values

parameter	description
data	array containing information on webhook parameters by type

Check the following tables for information on webhook parameters by type.

ActiveCampaign type = activecampaign

name	description	mandatory	type	max length	example
apiurl	ActiveCampaign API Access URL	Yes	url	4000	https://your-account.api-us1.com
apikey	ActiveCampaign API Access Key	Yes	string	500	bf2dc1416c1e54ac832997095c019529
list	ActiveCampaign list ID, if not specified the email will be added to global contacts	No	string	500	878231258

Custom webhook type = custom

name	description	help	mandatory	type	max length	example
fields	couples key/values		No	json	2000	{"source":"joturl","test":1}

Drift type = drift

name	description	help	mandatory	type	max length	example
apitoken	Drift Personal API Token		Yes	string	500	f4d8de586d98b6d3ded882ba88abb7a9
fields	couples key/values		No	json	2000	{"source":"joturl","test":1}

GetResponse type = getresponse

name	description	help	mandatory	type	max length	example
apikey	GetResponse API key		Yes	string	500	ad1577e1654378ba3d5703224e7de951
list	GetResponse list token		Yes	string	500	ZgNiw

HubSpot type = hubspot

name	description	mandatory	type	max length	example
apikey	HubSpot API Access Key	Yes	string	500	3af37ad6e95d722c9e703b352052f46f
list	HubSpot list ID, if not specified the email will be added to global contacts	No	string	500	1063405698
properties	properties (key/value pairs), each property must exist on HubSpot otherwise the API call will fail	No	json	2000	{"source":"joturl","test":1}

Mailchimp type = mailchimp

name	description	mandatory	type	max length	example
apikey	Mailchimp API key	Yes	string	500	c7470cab44b08fe4e81e1bb1371fc45b
audience	ID of the Mailchimp audience	Yes	string	500	65f38368
fields	couples key/values	No	json	2000	{"source":"joturl","test":1}

MailerLite type = mailerlite

name	description	mandatory	type	max length	example
apikey	MailerLite API key	Yes	string	500	4223743055886902a1e1497642d20300
group	GroupID of the MailerLite group	Yes	string	500	1999473875
fields	couples key/values	No	json	2000	{"source":"joturl","test":1}

Mailjet type = mailjet

name	description	mandatory	type	max length	example
apikey	Mailjet API key	Yes	string	500	8f022d4a5dfbb362bcb1c24b506d8fd7
secretkey	Mailjet secret key	Yes	string	500	2ad92f73b9ce9fe539e777e7231f2395
list	Mailjet contact list ID, if not specified the email will be added to global contacts	No	string	500	638407231

Mautic type = mautic

name	description	mandatory	type	max length	example
apiurl	Your Mautic API base URL	Yes	url	4000	https://your-mautic.com
username	Mautic username	Yes	string	500	400b66d436197b80a3b9e0cf3906fab3
password	Mautic password	Yes	string	500	9e631b7f5e4bee80e73f58a686cf3051
fields	couples key/values	No	json	2000	{"source":"joturl","test":1}

Moosend type = moosend

name	description	mandatory	type	max length	example
apikey	Moosend API key	Yes	string	500	bafe55f4-e53e-4651-8164-c6d6ff05081b
mailingListID	Moosend ID of the mailing list to add the new member	Yes	string	500	a589366a-1a34-4965-ac50-f1299fe5979e
fields	couples key/values	No	json	2000	{"source":"joturl","test":1}

Sendinblue type = sendinblue

name	description	mandatory	type	max length	example
apikey	Sendinblue API key (v3)	Yes	string	500	87c62e3063221f76a497093bdcc8bd0f
list	Sendinblue list ID, if not specified the email will be added to global contacts	No	string	500	1655174263
firstname	Sendinblue "attribute name" for the contact's first name	No	string	500	FNAME
lastname	Sendinblue "attribute name" for the contact's last name	No	string	500	LNAME
fullname	Sendinblue "attribute name" for the contact's full name	No	string	500	FULLNAME
fields	couples key/values	No	json	2000	{"source":"joturl","test":1}

Zapier type = zapier

This type of webhook cannot be directly subscribed, please use our Zapier integration.

access: [WRITE]

This method add a webhook subscription to a CTA.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/webhooks/subscribe?id=2bd5fe53338a416154da2c2ff9769d4b&url=https%3A%2F%2Fjoturl.com%2F

Query parameters

 id = 2bd5fe53338a416154da2c2ff9769d4b
url = https://joturl.com/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/webhooks/subscribe?id=2bd5fe53338a416154da2c2ff9769d4b&url=https%3A%2F%2Fjoturl.com%2F&format=xml

Query parameters

    id = 2bd5fe53338a416154da2c2ff9769d4b
   url = https://joturl.com/
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/webhooks/subscribe?id=2bd5fe53338a416154da2c2ff9769d4b&url=https%3A%2F%2Fjoturl.com%2F&format=txt

Query parameters

    id = 2bd5fe53338a416154da2c2ff9769d4b
   url = https://joturl.com/
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/webhooks/subscribe?id=2bd5fe53338a416154da2c2ff9769d4b&url=https%3A%2F%2Fjoturl.com%2F&format=plain

Query parameters

    id = 2bd5fe53338a416154da2c2ff9769d4b
   url = https://joturl.com/
format = plain

Response

Required parameters

parameter	description
idID	ID of the CTA to which to add the webhook
typeSTRING	webhook type, allowed types: `activecampaign`, `custom`, `drift`, `getresponse`, `hubspot`, `mailchimp`, `mailerlite`, `mailjet`, `mautic`, `moosend`, `sendinblue`, `zapier`

Optional parameters

parameter	description	max length
infoJSON	info to be used with the webhook (e.g., an API key), see below for details
notesSTRING	notes for the webhook	4000
unsubscribeBOOLEAN	1 to unsubscribe from the current webhook (if any) and subscribe to the new one
urlSTRING	URL of the webhook, required for types: `custom`, `zapier`	4000

Return values

parameter	description
added	1 on success, 0 otherwise

/ctas/webhooks/test

access: [WRITE]

This endpoint sends test data to a CTA webhook.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/webhooks/test?id=1922d63665196472621bbe7452f1705e

Query parameters

id = 1922d63665196472621bbe7452f1705e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ok": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/webhooks/test?id=1922d63665196472621bbe7452f1705e&format=xml

Query parameters

    id = 1922d63665196472621bbe7452f1705e
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ok>1</ok>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/webhooks/test?id=1922d63665196472621bbe7452f1705e&format=txt

Query parameters

    id = 1922d63665196472621bbe7452f1705e
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/webhooks/test?id=1922d63665196472621bbe7452f1705e&format=plain

Query parameters

    id = 1922d63665196472621bbe7452f1705e
format = plain

Response

Required parameters

parameter	description
idID	ID of the CTA associated with the webhook

Return values

parameter	description
ok	1 on success, otherwise an error is returned

/ctas/webhooks/unsubscribe

access: [WRITE]

This method removes a webhook subscription to a CTA.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=46516ae7ded18a0de926a366e6a1de4d

Query parameters

id = 46516ae7ded18a0de926a366e6a1de4d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "removed": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=46516ae7ded18a0de926a366e6a1de4d&format=xml

Query parameters

    id = 46516ae7ded18a0de926a366e6a1de4d
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <removed>1</removed>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=46516ae7ded18a0de926a366e6a1de4d&format=txt

Query parameters

    id = 46516ae7ded18a0de926a366e6a1de4d
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_removed=1

Example 4 (plain)

Request

https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=46516ae7ded18a0de926a366e6a1de4d&format=plain

Query parameters

    id = 46516ae7ded18a0de926a366e6a1de4d
format = plain

Response

Required parameters

parameter	description
idID	ID of the CTA from which to remove the webhook

Return values

parameter	description
removed	1 on success, 0 otherwise

/currencies

/currencies/info

access: [READ]

This method returns a list of available currencies.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/currencies/info?id=87a13bf51b20d5351aae8fd819557107

Query parameters

id = 87a13bf51b20d5351aae8fd819557107

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "87a13bf51b20d5351aae8fd819557107",
        "code": "EUR",
        "sign": "€"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/currencies/info?id=87a13bf51b20d5351aae8fd819557107&format=xml

Query parameters

    id = 87a13bf51b20d5351aae8fd819557107
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>87a13bf51b20d5351aae8fd819557107</id>  
        <code>EUR</code>  
        <sign><[CDATA[&euro;]]></sign>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/currencies/info?id=87a13bf51b20d5351aae8fd819557107&format=txt

Query parameters

    id = 87a13bf51b20d5351aae8fd819557107
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=87a13bf51b20d5351aae8fd819557107
result_data_0_code=EUR
result_data_0_sign=&euro;

Example 4 (plain)

Request

https://joturl.com/a/i1/currencies/info?id=87a13bf51b20d5351aae8fd819557107&format=plain

Query parameters

    id = 87a13bf51b20d5351aae8fd819557107
format = plain

Response

87a13bf51b20d5351aae8fd819557107
EUR
&euro;

Required parameters

parameter	description
idID	ID of the currency

Return values

parameter	description
data	information on the specified currency

/currencies/list

access: [READ]

This method returns a list of available currencies.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/currencies/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "af199d3286692864aaa927db0bccab7a",
        "code": "EUR",
        "sign": "€"
      },
      {
        "id": "ecb9fe21d268edcb41ecd7d87981e1be",
        "code": "USD",
        "sign": "$"
      },
      {
        "id": "9f6cef7e9f6d54b6af3ae64f3e16372a",
        "code": "GBP",
        "sign": "£"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/currencies/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>af199d3286692864aaa927db0bccab7a</id>  
        <code>EUR</code>  
        <sign><[CDATA[&euro;]]></sign>  
      </i0>  
      <i1>
        <id>ecb9fe21d268edcb41ecd7d87981e1be</id>  
        <code>USD</code>  
        <sign>$</sign>  
      </i1>  
      <i2>
        <id>9f6cef7e9f6d54b6af3ae64f3e16372a</id>  
        <code>GBP</code>  
        <sign><[CDATA[&pound;]]></sign>  
      </i2>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/currencies/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=af199d3286692864aaa927db0bccab7a
result_data_0_code=EUR
result_data_0_sign=&euro;
result_data_1_id=ecb9fe21d268edcb41ecd7d87981e1be
result_data_1_code=USD
result_data_1_sign=$
result_data_2_id=9f6cef7e9f6d54b6af3ae64f3e16372a
result_data_2_code=GBP
result_data_2_sign=&pound;

Example 4 (plain)

Request

https://joturl.com/a/i1/currencies/list?format=plain

Query parameters

format = plain

Response

af199d3286692864aaa927db0bccab7a
EUR
&euro;
ecb9fe21d268edcb41ecd7d87981e1be
USD
$
9f6cef7e9f6d54b6af3ae64f3e16372a
GBP
&pound;

Return values

parameter	description
data	information on the specified currency

/domains

/domains/add

access: [WRITE]

Add a domain for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 favicon_url = https://path.to/fav/icon
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1234567890abcdef",
    "force_https": "0",
    "host": "domain.ext",
    "nickname": "my domain nickname",
    "redirect_url": "https:\/\/redirect.users.to\/",
    "favicon_url": "https:\/\/path.to\/fav\/icon",
    "logo": "data:image\/gif;base64,R0lGODlhAQABAIAAAAAAAP\/\/\/yH5BAEAAAAALAAAAAABAAEAAAIBRAA7",
    "deeplink_id": "",
    "domain_domains_deeplink_name": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=xml

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 favicon_url = https://path.to/fav/icon
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data
                      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1234567890abcdef</id>  
    <force_https>0</force_https>  
    <host>domain.ext</host>  
    <nickname>my domain nickname</nickname>  
    <redirect_url>https://redirect.users.to/</redirect_url>  
    <favicon_url>https://path.to/fav/icon</favicon_url>  
    <logo>data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7</logo>  
    <deeplink_id></deeplink_id>  
    <domain_domains_deeplink_name></domain_domains_deeplink_name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=txt

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 favicon_url = https://path.to/fav/icon
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data
                      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_force_https=0
result_host=domain.ext
result_nickname=my domain nickname
result_redirect_url=https://redirect.users.to/
result_favicon_url=https://path.to/fav/icon
result_logo=data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
result_deeplink_id=
result_domain_domains_deeplink_name=

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=plain

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 favicon_url = https://path.to/fav/icon
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data
                      format = plain

Response

1234567890abcdef
0
domain.ext
my domain nickname
https://redirect.users.to/
https://path.to/fav/icon
data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7

Required parameters

parameter	description	max length
hostSTRING	domain to add (e.g., domain.ext)	850

Optional parameters

parameter	description	max length
deeplink_idID	ID of the deep link configuration
favicon_urlSTRING	the default favicon URL for the branded domain (to avoid securiy issues it must be HTTPS)	4000
forceBOOLEAN	1 to disable security checks, 0 otherwise. This parameter is ignored if `force_https = 1`
force_httpsBOOLEAN	1 to force HTTPS on HTTP requests, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain)
inputSTRING	name of the HTML form field that contains image data for the logo (max dimensions `120px x 50px`, max size `150kB`), see notes for details	255
nicknameSTRING	the domain nickname	50
redirect_urlSTRING	the default destination URL where to redirect when a user types the domain without any alias (or an invalid alias)	4000
robots_txtSTRING	the `robots.txt` content to serve for the domain, when `robots_txt = :NONE:` requests to `robots.txt` will return a 404 error, if empty the following `robots.txt` will be served: user-agent: * disallow: /	4000

NOTES: The parameter input contains the name of the field of the HTML form that is used to send logo data to this method. Form must have enctype = "multipart/form-data" and method = "post".

<form 
    action="/a/i1/domains/add" 
    method="post" 
    enctype="multipart/form-data">

    <input name="input" value="logo" type="hidden"/>

    [other form fields]

    <input name="logo" type="file"/>    

</form>

Return values

parameter	description
deeplink_id	ID of the deep link configuration
deeplink_name	NA
favicon_url	default favicon URL
force_https	1 if the HTTPS is forced for the domain, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain)
host	the domain that was just added
id	ID of the added domain
logo	default logo for the domain (base64 encoded)
nickname	the domain nickname
redirect_url	default redirect URL
robots_txt	the `robots.txt` content to serve for the domain

/domains/certificates

/domains/certificates/acmes

/domains/certificates/acmes/domains

/domains/certificates/acmes/domains/cert

access: [WRITE]

This method creates or renews an SSL certificate for a domain.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=bd4aee2d553766b3dfdccd119a61ae3b

Query parameters

domain_id = bd4aee2d553766b3dfdccd119a61ae3b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "created": 0,
    "private_key": "-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----",
    "csr": "-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----",
    "cert": "-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----",
    "cert_fingerprint": "9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264",
    "cert_valid_from": "2026-05-26T14:00:30",
    "cert_valid_to": "2026-08-24T14:00:30",
    "intermediate": "-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=bd4aee2d553766b3dfdccd119a61ae3b&format=xml

Query parameters

domain_id = bd4aee2d553766b3dfdccd119a61ae3b
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <created>0</created>  
    <private_key>-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----</private_key>  
    <csr>-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----</csr>  
    <cert>-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----</cert>  
    <cert_fingerprint>9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264</cert_fingerprint>  
    <cert_valid_from>2026-05-26T14:00:30</cert_valid_from>  
    <cert_valid_to>2026-08-24T14:00:30</cert_valid_to>  
    <intermediate>-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----</intermediate>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=bd4aee2d553766b3dfdccd119a61ae3b&format=txt

Query parameters

domain_id = bd4aee2d553766b3dfdccd119a61ae3b
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_created=0
result_private_key=-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----
result_csr=-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----
result_cert=-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----
result_cert_fingerprint=9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264
result_cert_valid_from=2026-05-26T14:00:30
result_cert_valid_to=2026-08-24T14:00:30
result_intermediate=-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=bd4aee2d553766b3dfdccd119a61ae3b&format=plain

Query parameters

domain_id = bd4aee2d553766b3dfdccd119a61ae3b
   format = plain

Response

0
-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----
-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----
9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264
2026-05-26T14:00:30
2026-08-24T14:00:30
-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----

Required parameters

parameter	description
domain_idID	ID of the domain for which the SSL certificate is asked

Return values

parameter	description
cert	domain SSL certificate (PEM format)
cert_fingerprint	fingerprint of the SSL certificate
cert_valid_from	SSL certificate is valid from this date
cert_valid_to	SSL certificate is valid up to this date, usually the certificate expires 90 days after the cert_valid_from date; see <a href="https://letsencrypt.org/docs/faq/">the Let's Encrypt FAQ</a> for details
created	1 on success, 0 otherwise
csr	certificate signing request (CSR) for the doamin (PEM format)
intermediate	domain intermediate certificate(s) (PEM format)
private_key	domain private key (PEM format)

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/acmes/domains/install

access: [WRITE]

This method installs an SSL certificate for a domain.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=ef18dcc22b2706a70ca05e204088df22

Query parameters

domain_id = ef18dcc22b2706a70ca05e204088df22

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "installed": 1,
    "host": "jo.my",
    "cn": "jo.my",
    "certificate_domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
    "domains": "jo.my, www.jo.my",
    "fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
    "id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
    "valid_from": "2018-01-23 14:58:37",
    "valid_to": "2018-04-23 14:58:37",
    "issuer": "JotUrl S.r.l."
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=ef18dcc22b2706a70ca05e204088df22&format=xml

Query parameters

domain_id = ef18dcc22b2706a70ca05e204088df22
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <installed>1</installed>  
    <host>jo.my</host>  
    <cn>jo.my</cn>  
    <certificate_domain_id>6e666877484257716e798888484252472b645a4a49518d8d</certificate_domain_id>  
    <domains>jo.my, www.jo.my</domains>  
    <fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>  
    <id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>  
    <valid_from>2018-01-23 14:58:37</valid_from>  
    <valid_to>2018-04-23 14:58:37</valid_to>  
    <issuer>JotUrl S.r.l.</issuer>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=ef18dcc22b2706a70ca05e204088df22&format=txt

Query parameters

domain_id = ef18dcc22b2706a70ca05e204088df22
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_installed=1
result_host=jo.my
result_cn=jo.my
result_certificate_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_domains=jo.my, www.jo.my
result_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_valid_from=2018-01-23 14:58:37
result_valid_to=2018-04-23 14:58:37
result_issuer=JotUrl S.r.l.

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=ef18dcc22b2706a70ca05e204088df22&format=plain

Query parameters

domain_id = ef18dcc22b2706a70ca05e204088df22
   format = plain

Response

1
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
JotUrl S.r.l.

Required parameters

parameter	description
domain_idID	ID of the domain for which the SSL certificate has to be installed

Return values

parameter	description
certificate_domain_id	ID of the domain the certificate belongs to
cn	common name of the certificate
domains	comma separated list of domains covered by the certificate (e.g., "domain.ext, www.domain.ext")
fingerprint	fingerprint of the certificate
host	domain the certificate belongs to
id	ID of the certificate
installed	1 on success, 0 otherwise
issuer	the certificate issuer
valid_from	the certificate is valid from this dat, can be in the future (e.g., 2018-05-30 13:38:04)
valid_to	the certificate is valid up to this date, can be in the past (e.g., 2020-05-29 13:38:04)

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/acmes/domains/revoke

access: [WRITE]

This method revokes an SSL certificate for a domain.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=bf0635f83e6c46e0033e076e84e4ad4c

Query parameters

domain_id = bf0635f83e6c46e0033e076e84e4ad4c

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "revoked": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=bf0635f83e6c46e0033e076e84e4ad4c&format=xml

Query parameters

domain_id = bf0635f83e6c46e0033e076e84e4ad4c
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <revoked>1</revoked>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=bf0635f83e6c46e0033e076e84e4ad4c&format=txt

Query parameters

domain_id = bf0635f83e6c46e0033e076e84e4ad4c
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_revoked=1

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=bf0635f83e6c46e0033e076e84e4ad4c&format=plain

Query parameters

domain_id = bf0635f83e6c46e0033e076e84e4ad4c
   format = plain

Response

Required parameters

parameter	description
domain_idID	ID of the domain for which the SSL certificate should be revoked

Return values

parameter	description
revoked	1 on success, 0 otherwise

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/acmes/domains/validate

access: [WRITE]

This method validates a domain. You have to validate a domain before creating an SSL certificate.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=7fe95efe3bbdb91f9b45c17bc0c73e6f

Query parameters

domain_id = 7fe95efe3bbdb91f9b45c17bc0c73e6f

Response

{
  "status": "pending"
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=7fe95efe3bbdb91f9b45c17bc0c73e6f&format=xml

Query parameters

domain_id = 7fe95efe3bbdb91f9b45c17bc0c73e6f
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>pending</status>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=7fe95efe3bbdb91f9b45c17bc0c73e6f&format=txt

Query parameters

domain_id = 7fe95efe3bbdb91f9b45c17bc0c73e6f
   format = txt

Response

status=pending

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=7fe95efe3bbdb91f9b45c17bc0c73e6f&format=plain

Query parameters

domain_id = 7fe95efe3bbdb91f9b45c17bc0c73e6f
   format = plain

Response

pending

Required parameters

parameter	description
domain_idID	ID of the domain to validate

Optional parameters

parameter	description
include_www_subdomainBOOLEAN	1 if the WWW subdomain should be asked, 0 otherwise

Return values

parameter	description
domains	list of available domains in the certificate
status	status of the validation request; call this method until a valid status is returned or a timeout of 30 seconds occurs. If the validation fails, you have to wait at least 30 minutes before retrying [unknown\|pending\|valid]

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/acmes/users

/domains/certificates/acmes/users/deactivate

access: [WRITE]

This method deactivates a user on the Let's Encrypt ACME server.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deactivated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deactivated>1</deactivated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deactivated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
deactivated	1 on success, 0 otherwise

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/acmes/users/generatekey

access: [WRITE]

This method generates an RSA key for the user, this key have to be used with all operations on the Let's Encrypt ACME server.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "generated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <generated>1</generated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_generated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
generated	1 on success, 0 otherwise

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/acmes/users/register

access: [WRITE]

This method registers a user on the Let's Encrypt ACME server.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/register

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "registered": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/register?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <registered>1</registered>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/register?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_registered=1

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/acmes/users/register?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
agreementSTRING	links to the Let's Encrypt agreement. Registration on Let's Encrypt ACME server requires two steps; in the first one you have to call this method without parameters, it will return an agreement link and the security parameter nonce, that the user must explicitely approve the agreement; in the second step, you have to call this method with parameters agreement and nonce set to the values returned by the previous call
forceBOOLEAN	1 if the registration process have to be forced (overwriting old values), 0 otherwise
nonceID	a random security string to be used during the registration process

Return values

parameter	description
agreement	[OPTIONAL] returned only if agreement is needed (agreement is only in English)
nonce	[OPTIONAL] returned only if agreement is needed
registered	1 on success, 0 otherwise

Follow these steps to obtain a Let's Encrypt SSL certificate:

call method i1/domains/certificates/acmes/users/generatekey to generate a private key for the current user
call method i1/domains/certificates/acmes/users/register to register the user on the Let's Encrypt ACME server
call method i1/domains/certificates/acmes/domains/validate to validate a specific domain
call method i1/domains/certificates/acmes/domains/cert to obtain a certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 4

To renew a certificate use these steps (at least every 60 days but before 90 days from the generation of the last SSL certificate):

call method i1/domains/certificates/acmes/domains/validate to validate a domain
call method i1/domains/certificates/acmes/domains/cert to obtain a new certificate
call method i1/domains/certificates/acmes/domains/install to install the SSL certificate obtained on step 2

Other endpoints

You can deactivate a user account by calling i1/domains/certificates/acmes/users/deactivate; please note that deactivating a user all associated certificates will be deleted.
You can revoke a cartificate by calling i1/domains/certificates/acmes/domains/cert.

/domains/certificates/add

access: [WRITE]

This method allows to upload a certificate for a specific domain.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D

Query parameters

        domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
  cert_files_type = pfx
input_pfx_archive = [pfx_file]

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "host": "jo.my",
    "id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
    "fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
    "valid_from": "2018-01-23 14:58:37",
    "valid_to": "2018-04-23 14:58:37",
    "cn": "jo.my",
    "domains": "jo.my, www.jo.my"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D&format=xml

Query parameters

        domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
  cert_files_type = pfx
input_pfx_archive = [pfx_file]
           format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <host>jo.my</host>  
    <id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>  
    <fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>  
    <valid_from>2018-01-23 14:58:37</valid_from>  
    <valid_to>2018-04-23 14:58:37</valid_to>  
    <cn>jo.my</cn>  
    <domains>jo.my, www.jo.my</domains>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D&format=txt

Query parameters

        domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
  cert_files_type = pfx
input_pfx_archive = [pfx_file]
           format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_host=jo.my
result_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_valid_from=2018-01-23 14:58:37
result_valid_to=2018-04-23 14:58:37
result_cn=jo.my
result_domains=jo.my, www.jo.my

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D&format=plain

Query parameters

        domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
  cert_files_type = pfx
input_pfx_archive = [pfx_file]
           format = plain

Response

jo.my
69785a4b2f7676744c5a4759642f67524561584b58778d8d
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
2018-01-23 14:58:37
2018-04-23 14:58:37
jo.my
jo.my, www.jo.my

Required parameters

parameter	description
cert_files_typeSTRING	this parameter must be `pfx` or `cert_files`, according to the certificate files
domain_idID	ID of the domain the certificate belongs to

Optional parameters

parameter	description
input_ca_certificate1STRING	name of the HTML form field that is used to transfer the ca certificate #1 data, see notes for details
input_ca_certificate2STRING	name of the HTML form field that is used to transfer the ca certificate #2 data, see notes for details
input_ca_certificate3STRING	name of the HTML form field that is used to transfer the ca certificate #2 data, see notes for details
input_certificateSTRING	name of the HTML form field that is used to transfer the certificate data, mandatory if `cert_files_type = cert_files` , see notes for details
input_pfx_archiveSTRING	name of the HTML form field that is used to transfer the PFX data, mandatory if `cert_files_type = pfx` , see notes for details
input_private_keySTRING	name of the HTML form field that is used to transfer the private key data, mandatory if `cert_files_type = cert_files` , see notes for details
pfx_passwordHTML	password of the PFX archive, mandatory if `cert_files_type = pfx` and the PFX archive is protected by a password

NOTES: Parameters starting with input_ are the names of the field of the HTML form used to send data to this method. Form must have enctype = "multipart/form-data" and method = "post".

<form 
    action="/a/i1/domains/certificates/add" 
    method="post" 
    enctype="multipart/form-data">

    <input name="input_pfx_archive" value="pfx_file" type="hidden"/>
    <input name="input_private_key" value="private_key_file" type="hidden"/>
    <input name="input_certificate" value="certificate_file" type="hidden"/>

    <input name="input_ca_certificate1" value="certificate1_file" type="hidden"/>
    <input name="input_ca_certificate2" value="certificate2_file" type="hidden"/>
    <input name="input_ca_certificate3" value="certificate3_file" type="hidden"/>

    [other form fields]

    <input name="pfx_file" type="file"/>
    <input name="private_key_file" type="file"/>    
    <input name="certificate_file" type="file"/> 

    <input name="certificate1_file" type="file"/>
    <input name="certificate2_file" type="file"/>    
    <input name="certificate3_file" type="file"/>     

</form>

Return values

parameter	description
cn	common name of the certificate
domain_id	ID of the domain the certificate belongs to
domains	comma separated list of domains covered by the certificate (e.g., "domain.ext, www.domain.ext")
fingerprint	fingerprint of the certificate
host	domain the certificate belongs to
id	ID of the certificate
valid_from	the certificate is valid from this dat, can be in the future (e.g., 2018-05-30 13:38:04)
valid_to	the certificate is valid up to this date, can be in the past (e.g., 2020-05-29 13:38:04)

/domains/certificates/count

access: [READ]

This method returns number of certificates associated to a specific domain.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
domain_idID	filters certificates for this domain ID
searchSTRING	count items by searching them

Return values

parameter	description
count	number of (filtered) certificates

/domains/certificates/csr

/domains/certificates/csr/create

access: [WRITE]

This method allows to create a Certificate Signing Request (CSR).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US

Query parameters

            commonName = domain.ext
      organizationName = My Company
organizationalUnitName = accounting
          localityName = Los Angeles
   stateOrProvinceName = California
           countryName = US

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "private_key": "-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq
0\/vm\/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMml
HMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rh
nZNOCM2+NeKvZxN0ZUXTRn2Ed\/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykE
PP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC\/TyDZT2J8Q+w5SEMVylehHNd\/8b5
l3f7NhIW50eIZsmY0xgfpV1wsHUp\/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEV
TqdTl05\/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh\/hD
xyg0pFqTY4Vq48co5q9pG0wWEt\/cN\/73jbnSpIIjgjo+gU8M7UWYzlUk\/9uRVbLC
7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzX
ZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGL
AGjkfMdErAHGK2k\/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZ
sGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOm
YPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q
4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3y
tbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F\/wlkZk2aNHKATu1GZhYKhpGUbhC
vPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVF
K6hpQu7x8hZ1yuehpW3azhm98\/eV7bW48SMcvHl6CGEffGnpQrJ\/ou52mYMhS3Ga
UglUmQGybHkCgYEAm5OsL1P\/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT
9ZZuwbDDfgYBr\/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9Hkf
kteB03tGGZAA7qHy\/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+\/pI9hiCYvcCgYBf
9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM\/eBk\/72FwF+X9OtxWo8J4f6h2
yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53
Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga\/hpw
qGoJ8bl5gab0U\/1u9sXdbMKqeyyaFjXo\/RaLdSOG9y4UFJP\/2JMeTh1FRCWaN7rK
6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc\/zK1OZfUZmOLV+3
yZDE4U3\/Zkgx7gSM\/Ffxw\/62
-----END PRIVATE KEY-----
",
    "csr": "-----BEGIN CERTIFICATE REQUEST-----
MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWEx
FDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYD
VQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2\/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3IS
EzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h\/NkAgoe
y8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9
hHfwk+rRg1LgrFyAaEcM\/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0\/ZGN1
rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf\/G+Zd3+zYSFudHiGbJmNMYH6Vd
cLB1Kf6Eb8jYEaIPgegp5kbgG\/es5l3\/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJ
KoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5\/Qa+kCFzsVDpEaJOuc
2GujOYydNTwFpsQCcVdW\/LR1mbsiS2CVTMTP+VrppiC\/XIJ0btlXeRNzLZdQ9UaX
xBgj46J79oYxXkIpnskcms3SsrKGnK\/Q1bnus0jpvTlji9DnZglQt9QvzePF15As
QCERgitEUTRKzxvYjozq\/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7
XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9
S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=
-----END CERTIFICATE REQUEST-----
"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US&format=xml

Query parameters

            commonName = domain.ext
      organizationName = My Company
organizationalUnitName = accounting
          localityName = Los Angeles
   stateOrProvinceName = California
           countryName = US
                format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <private_key>-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq
0/vm/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMml
HMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rh
nZNOCM2+NeKvZxN0ZUXTRn2Ed/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykE
PP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC/TyDZT2J8Q+w5SEMVylehHNd/8b5
l3f7NhIW50eIZsmY0xgfpV1wsHUp/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEV
TqdTl05/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh/hD
xyg0pFqTY4Vq48co5q9pG0wWEt/cN/73jbnSpIIjgjo+gU8M7UWYzlUk/9uRVbLC
7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzX
ZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGL
AGjkfMdErAHGK2k/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZ
sGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOm
YPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q
4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3y
tbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F/wlkZk2aNHKATu1GZhYKhpGUbhC
vPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVF
K6hpQu7x8hZ1yuehpW3azhm98/eV7bW48SMcvHl6CGEffGnpQrJ/ou52mYMhS3Ga
UglUmQGybHkCgYEAm5OsL1P/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT
9ZZuwbDDfgYBr/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9Hkf
kteB03tGGZAA7qHy/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+/pI9hiCYvcCgYBf
9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM/eBk/72FwF+X9OtxWo8J4f6h2
yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53
Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga/hpw
qGoJ8bl5gab0U/1u9sXdbMKqeyyaFjXo/RaLdSOG9y4UFJP/2JMeTh1FRCWaN7rK
6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc/zK1OZfUZmOLV+3
yZDE4U3/Zkgx7gSM/Ffxw/62
-----END PRIVATE KEY-----
</private_key>  
    <csr>-----BEGIN CERTIFICATE REQUEST-----
MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWEx
FDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYD
VQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3IS
EzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h/NkAgoe
y8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9
hHfwk+rRg1LgrFyAaEcM/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0/ZGN1
rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf/G+Zd3+zYSFudHiGbJmNMYH6Vd
cLB1Kf6Eb8jYEaIPgegp5kbgG/es5l3/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJ
KoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5/Qa+kCFzsVDpEaJOuc
2GujOYydNTwFpsQCcVdW/LR1mbsiS2CVTMTP+VrppiC/XIJ0btlXeRNzLZdQ9UaX
xBgj46J79oYxXkIpnskcms3SsrKGnK/Q1bnus0jpvTlji9DnZglQt9QvzePF15As
QCERgitEUTRKzxvYjozq/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7
XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9
S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=
-----END CERTIFICATE REQUEST-----
</csr>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US&format=txt

Query parameters

            commonName = domain.ext
      organizationName = My Company
organizationalUnitName = accounting
          localityName = Los Angeles
   stateOrProvinceName = California
           countryName = US
                format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_private_key=-----BEGIN PRIVATE KEY-----MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq0/vm/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMmlHMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rhnZNOCM2+NeKvZxN0ZUXTRn2Ed/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykEPP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC/TyDZT2J8Q+w5SEMVylehHNd/8b5l3f7NhIW50eIZsmY0xgfpV1wsHUp/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEVTqdTl05/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh/hDxyg0pFqTY4Vq48co5q9pG0wWEt/cN/73jbnSpIIjgjo+gU8M7UWYzlUk/9uRVbLC7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzXZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGLAGjkfMdErAHGK2k/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZsGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOmYPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3ytbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F/wlkZk2aNHKATu1GZhYKhpGUbhCvPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVFK6hpQu7x8hZ1yuehpW3azhm98/eV7bW48SMcvHl6CGEffGnpQrJ/ou52mYMhS3GaUglUmQGybHkCgYEAm5OsL1P/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT9ZZuwbDDfgYBr/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9HkfkteB03tGGZAA7qHy/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+/pI9hiCYvcCgYBf9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM/eBk/72FwF+X9OtxWo8J4f6h2yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga/hpwqGoJ8bl5gab0U/1u9sXdbMKqeyyaFjXo/RaLdSOG9y4UFJP/2JMeTh1FRCWaN7rK6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc/zK1OZfUZmOLV+3yZDE4U3/Zkgx7gSM/Ffxw/62-----END PRIVATE KEY-----
result_csr=-----BEGIN CERTIFICATE REQUEST-----MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWExFDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYDVQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3ISEzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h/NkAgoey8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9hHfwk+rRg1LgrFyAaEcM/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0/ZGN1rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf/G+Zd3+zYSFudHiGbJmNMYH6VdcLB1Kf6Eb8jYEaIPgegp5kbgG/es5l3/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJKoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5/Qa+kCFzsVDpEaJOuc2GujOYydNTwFpsQCcVdW/LR1mbsiS2CVTMTP+VrppiC/XIJ0btlXeRNzLZdQ9UaXxBgj46J79oYxXkIpnskcms3SsrKGnK/Q1bnus0jpvTlji9DnZglQt9QvzePF15AsQCERgitEUTRKzxvYjozq/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=-----END CERTIFICATE REQUEST-----

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US&format=plain

Query parameters

            commonName = domain.ext
      organizationName = My Company
organizationalUnitName = accounting
          localityName = Los Angeles
   stateOrProvinceName = California
           countryName = US
                format = plain

Response

Required parameters

parameter	description
commonNameSTRING	the Fully Qualified Domain Name (FQDN) for which you are requesting the SSL Certificate, it must contain domain you are requesting a certifacate for (e.g., domain.ext, *.domain.ext)
countryNameSTRING	2-digit code of the country (ISO Alpha-2) the company is based on (e.g., US)
localityNameSTRING	the full name of the locality the company is based on (e.g., Los Angeles)
organizationNameSTRING	the full legal company or personal name, as legally registered, that is requesting the certificate (e.g., My Company)
organizationalUnitNameSTRING	whichever branch of the company is ordering the certificate (e.g., accounting, marketing)
stateOrProvinceNameSTRING	the full name of the state or province the company is based on (e.g., California)

Return values

parameter	description
csr	Certificate request (CSR)
private_key	Private key

/domains/certificates/delete

access: [WRITE]

This method deletes a certificate.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=3000

Query parameters

id = 3000

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=3000&format=xml

Query parameters

    id = 3000
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=3000&format=txt

Query parameters

    id = 3000
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=3000&format=plain

Query parameters

    id = 3000
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=100000

Query parameters

id = 100000

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 0
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=100000&format=xml

Query parameters

    id = 100000
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>0</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=100000&format=txt

Query parameters

    id = 100000
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=0

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/certificates/delete?id=100000&format=plain

Query parameters

    id = 100000
format = plain

Response

Required parameters

parameter	description
idID	ID of the certificate to delete

Return values

parameter	description
deleted	1 if the delete successes, 0 otherwise

/domains/certificates/info

access: [READ]

This method returns information about a certificate. Required information can be passed by using fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed

Query parameters

    id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "host": "jo.my",
    "cn": "jo.my",
    "domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
    "domains": "jo.my, www.jo.my",
    "fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
    "id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
    "valid_from": "2018-01-23 14:58:37",
    "valid_to": "2018-04-23 14:58:37",
    "installed": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed&format=xml

Query parameters

    id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <host>jo.my</host>  
    <cn>jo.my</cn>  
    <domain_id>6e666877484257716e798888484252472b645a4a49518d8d</domain_id>  
    <domains>jo.my, www.jo.my</domains>  
    <fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>  
    <id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>  
    <valid_from>2018-01-23 14:58:37</valid_from>  
    <valid_to>2018-04-23 14:58:37</valid_to>  
    <installed>0</installed>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed&format=txt

Query parameters

    id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_host=jo.my
result_cn=jo.my
result_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_domains=jo.my, www.jo.my
result_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_valid_from=2018-01-23 14:58:37
result_valid_to=2018-04-23 14:58:37
result_installed=0

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed&format=plain

Query parameters

    id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
format = plain

Response

jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
0

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, domain_domain_id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, cn, domain_id, domains, fingerprint, id, valid_from, valid_to, deeplink_name, installed
idID	ID of the certificate

Return values

parameter	description
cn	common name of the certificate
domain_id	ID of the domain the certificate belongs to
domains	comma separated list of domains covered by the certificate (e.g., "domain.ext, www.domain.ext")
fingerprint	fingerprint of the certificate
host	domain the certificate belongs to
id	ID of the certificate
installed	propagation percentage of the certificate installation (e.g. 12.34%, 100%)
valid_from	the certificate is valid from this dat, can be in the future (e.g., 2018-05-30 13:38:04)
valid_to	the certificate is valid up to this date, can be in the past (e.g., 2020-05-29 13:38:04)

/domains/certificates/list

access: [READ]

This method returns the certificates associated to the logged users.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer

Query parameters

fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "host": "jo.my",
        "cn": "jo.my",
        "domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
        "domains": "jo.my, www.jo.my",
        "fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
        "id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
        "valid_from": "2018-01-23 14:58:37",
        "valid_to": "2018-04-23 14:58:37",
        "issuer": "JotUrl S.r.l.",
        "installed": 0
      },
      {
        "host": "joturl.com",
        "cn": "*.joturl.com",
        "domain_id": "544a5451745446616542676449497450686f425446414d4d",
        "domains": "*.joturl.com, joturl.com",
        "fingerprint": "51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB",
        "id": "54576e66564a74412b70596c577175424968715464414d4d",
        "valid_from": "2017-04-06 00:00:00",
        "valid_to": "2028-04-20 23:59:59",
        "issuer": "JotUrl S.r.l.",
        "installed": 100
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=xml

Query parameters

fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <host>jo.my</host>  
        <cn>jo.my</cn>  
        <domain_id>6e666877484257716e798888484252472b645a4a49518d8d</domain_id>  
        <domains>jo.my, www.jo.my</domains>  
        <fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>  
        <id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>  
        <valid_from>2018-01-23 14:58:37</valid_from>  
        <valid_to>2018-04-23 14:58:37</valid_to>  
        <issuer>JotUrl S.r.l.</issuer>  
        <installed>0</installed>  
      </i0>  
      <i1>
        <host>joturl.com</host>  
        <cn>*.joturl.com</cn>  
        <domain_id>544a5451745446616542676449497450686f425446414d4d</domain_id>  
        <domains>*.joturl.com, joturl.com</domains>  
        <fingerprint>51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB</fingerprint>  
        <id>54576e66564a74412b70596c577175424968715464414d4d</id>  
        <valid_from>2017-04-06 00:00:00</valid_from>  
        <valid_to>2028-04-20 23:59:59</valid_to>  
        <issuer>JotUrl S.r.l.</issuer>  
        <installed>100</installed>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=txt

Query parameters

fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_host=jo.my
result_data_0_cn=jo.my
result_data_0_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_data_0_domains=jo.my, www.jo.my
result_data_0_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_data_0_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_data_0_valid_from=2018-01-23 14:58:37
result_data_0_valid_to=2018-04-23 14:58:37
result_data_0_issuer=JotUrl S.r.l.
result_data_0_installed=0
result_data_1_host=joturl.com
result_data_1_cn=*.joturl.com
result_data_1_domain_id=544a5451745446616542676449497450686f425446414d4d
result_data_1_domains=*.joturl.com, joturl.com
result_data_1_fingerprint=51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB
result_data_1_id=54576e66564a74412b70596c577175424968715464414d4d
result_data_1_valid_from=2017-04-06 00:00:00
result_data_1_valid_to=2028-04-20 23:59:59
result_data_1_issuer=JotUrl S.r.l.
result_data_1_installed=100

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=plain

Query parameters

fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = plain

Response

2
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
JotUrl S.r.l.
0
joturl.com
*.joturl.com
544a5451745446616542676449497450686f425446414d4d
*.joturl.com, joturl.com
51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB
54576e66564a74412b70596c577175424968715464414d4d
2017-04-06 00:00:00
2028-04-20 23:59:59
JotUrl S.r.l.
100

Example 5 (json)

Request

https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer

Query parameters

domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
   fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "host": "jo.my",
        "cn": "jo.my",
        "domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
        "domains": "jo.my, www.jo.my",
        "fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
        "id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
        "valid_from": "2018-01-23 14:58:37",
        "valid_to": "2018-04-23 14:58:37",
        "issuer": "JotUrl S.r.l.",
        "installed": 0
      }
    ]
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=xml

Query parameters

domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
   fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <host>jo.my</host>  
        <cn>jo.my</cn>  
        <domain_id>6e666877484257716e798888484252472b645a4a49518d8d</domain_id>  
        <domains>jo.my, www.jo.my</domains>  
        <fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>  
        <id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>  
        <valid_from>2018-01-23 14:58:37</valid_from>  
        <valid_to>2018-04-23 14:58:37</valid_to>  
        <issuer>JotUrl S.r.l.</issuer>  
        <installed>0</installed>  
      </i0>  
    </data>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=txt

Query parameters

domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
   fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_host=jo.my
result_data_0_cn=jo.my
result_data_0_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_data_0_domains=jo.my, www.jo.my
result_data_0_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_data_0_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_data_0_valid_from=2018-01-23 14:58:37
result_data_0_valid_to=2018-04-23 14:58:37
result_data_0_issuer=JotUrl S.r.l.
result_data_0_installed=0

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=plain

Query parameters

domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
   fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
   format = plain

Response

1
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
JotUrl S.r.l.
0

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, domain_domain_id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, cn, domain_id, domains, fingerprint, id, valid_from, valid_to, deeplink_name, installed, count, issuer

Optional parameters

parameter	description
domain_idID	filters certificates for this domain ID
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: deeplink_id, host, for_trials, force_https, domain_domain_id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, cn, domain_id, domains, fingerprint, id, valid_from, valid_to, deeplink_name, installed, count, issuer
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	[OPTIONAL] total number of (filtered) certificates, returned only if count is passed in fields
data	array containing required information on certificates

/domains/count

access: [READ]

This method returns the number of user's domains.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/domains/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
is_defaultBOOLEAN	if 1 this method counts only the default domain
is_ownerBOOLEAN	if 1 this method counts only domains owned by the logged user, if 0 it returns only shared domains
searchSTRING	count items by searching them

Return values

parameter	description
count	number of domains the user has access to (filtered by search if passed)

/domains/deeplinks

/domains/deeplinks/add

access: [WRITE]

Add a deep link configuration for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1234567890abcdef",
    "name": "deep configuration domain_name",
    "android": "[
    {
        \"relation\": [
            \"delegate_permission\/common.handle_all_urls\"
        ],
        \"target\": {
            \"namespace\": \"android_app\",
            \"package_name\": \"com.example.app\",
            \"sha256_cert_fingerprints\": [
                \"hash_of_app_certificate\"
            ]
        }
    }
]",
    "ios": "{
    \"applinks\": {
        \"apps\": [],
        \"details\": [
            {
                \"appID\": \"D3KQX62K1A.com.example.photoapp\",
                \"paths\": [
                    \"\/albums\"
                ]
            },
            {
                \"appID\": \"D3KQX62K1A.com.example.videoapp\",
                \"paths\": [
                    \"\/videos\"
                ]
            }
        ]
    }
}"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=xml

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1234567890abcdef</id>  
    <name>deep configuration domain_name</name>  
    <android>[
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]</android>  
    <ios>{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}</ios>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=txt

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_name=deep configuration domain_name
result_android=[    {        "relation": [            "delegate_permission/common.handle_all_urls"        ],        "target": {            "namespace": "android_app",            "package_name": "com.example.app",            "sha256_cert_fingerprints": [                "hash_of_app_certificate"            ]        }    }]
result_ios={    "applinks": {        "apps": [],        "details": [            {                "appID": "D3KQX62K1A.com.example.photoapp",                "paths": [                    "/albums"                ]            },            {                "appID": "D3KQX62K1A.com.example.videoapp",                "paths": [                    "/videos"                ]            }        ]    }}

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=plain

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}
 format = plain

Response

1234567890abcdef
deep configuration domain_name
[    {        "relation": [            "delegate_permission/common.handle_all_urls"        ],        "target": {            "namespace": "android_app",            "package_name": "com.example.app",            "sha256_cert_fingerprints": [                "hash_of_app_certificate"            ]        }    }]
{    "applinks": {        "apps": [],        "details": [            {                "appID": "D3KQX62K1A.com.example.photoapp",                "paths": [                    "/albums"                ]            },            {                "appID": "D3KQX62K1A.com.example.videoapp",                "paths": [                    "/videos"                ]            }        ]    }}

Required parameters

parameter	description
nameSTRING	domain_name of the deep link configuration

Optional parameters

parameter	description	max length
androidSTRING	JSON configuration for Android (assetlinks.json)	4000
iosSTRING	JSON configuration for iOS (apple-app-site-association)	4000

Return values

parameter	description
android	JSON configuration for Android (assetlinks.json)
id	ID of the deep link configuration
ios	JSON configuration for iOS (apple-app-site-association)
name	domain_name of the deep link configuration

/domains/deeplinks/count

access: [READ]

This method returns the number of user's deep link configurations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	count items by searching them

Return values

parameter	description
count	number of deep link configurations the user has access to (filtered by search if passed)

/domains/deeplinks/delete

access: [WRITE]

Delete a deep link configuration for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000

Query parameters

ids = 10,200,3000

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000&format=xml

Query parameters

   ids = 10,200,3000
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000&format=txt

Query parameters

   ids = 10,200,3000
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000&format=plain

Query parameters

   ids = 10,200,3000
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000

Query parameters

ids = 4000,50000,100000

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "50000,100000",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000&format=xml

Query parameters

   ids = 4000,50000,100000
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>50000,100000</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000&format=txt

Query parameters

   ids = 4000,50000,100000
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=50000,100000
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000&format=plain

Query parameters

   ids = 4000,50000,100000
format = plain

Response

50000,100000
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of domain IDs to be deleted

Return values

parameter	description
deleted	number of deleted domains
ids	[OPTIONAL] list of domain IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/domains/deeplinks/edit

access: [WRITE]

Edit a deep link configuration for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1234567890abcdef",
    "name": "deep configuration domain_name",
    "android": "[
    {
        \"relation\": [
            \"delegate_permission\/common.handle_all_urls\"
        ],
        \"target\": {
            \"namespace\": \"android_app\",
            \"package_name\": \"com.example.app\",
            \"sha256_cert_fingerprints\": [
                \"hash_of_app_certificate\"
            ]
        }
    }
]",
    "ios": "{
    \"applinks\": {
        \"apps\": [],
        \"details\": [
            {
                \"appID\": \"D3KQX62K1A.com.example.photoapp\",
                \"paths\": [
                    \"\/albums\"
                ]
            },
            {
                \"appID\": \"D3KQX62K1A.com.example.videoapp\",
                \"paths\": [
                    \"\/videos\"
                ]
            }
        ]
    }
}"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=xml

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1234567890abcdef</id>  
    <name>deep configuration domain_name</name>  
    <android>[
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]</android>  
    <ios>{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}</ios>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=txt

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_name=deep configuration domain_name
result_android=[    {        "relation": [            "delegate_permission/common.handle_all_urls"        ],        "target": {            "namespace": "android_app",            "package_name": "com.example.app",            "sha256_cert_fingerprints": [                "hash_of_app_certificate"            ]        }    }]
result_ios={    "applinks": {        "apps": [],        "details": [            {                "appID": "D3KQX62K1A.com.example.photoapp",                "paths": [                    "/albums"                ]            },            {                "appID": "D3KQX62K1A.com.example.videoapp",                "paths": [                    "/videos"                ]            }        ]    }}

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=plain

Query parameters

   name = deep configuration domain_name
android = [
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]
    ios = {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}
 format = plain

Response

1234567890abcdef
deep configuration domain_name
[    {        "relation": [            "delegate_permission/common.handle_all_urls"        ],        "target": {            "namespace": "android_app",            "package_name": "com.example.app",            "sha256_cert_fingerprints": [                "hash_of_app_certificate"            ]        }    }]
{    "applinks": {        "apps": [],        "details": [            {                "appID": "D3KQX62K1A.com.example.photoapp",                "paths": [                    "/albums"                ]            },            {                "appID": "D3KQX62K1A.com.example.videoapp",                "paths": [                    "/videos"                ]            }        ]    }}

Required parameters

parameter	description
idID	ID of the deep link configuration

Optional parameters

parameter	description	max length
androidSTRING	JSON configuration for Android (assetlinks.json)	4000
iosSTRING	JSON configuration for iOS (apple-app-site-association)	4000
nameSTRING	domain_name of the deep link configuration

Return values

parameter	description
android	JSON configuration for Android (assetlinks.json)
id	ID of the deep link configuration
ios	JSON configuration for iOS (apple-app-site-association)
name	domain_name of the deep link configuration

/domains/deeplinks/info

access: [READ]

This method returns information on a deep link configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef

Query parameters

id = 1234567890abcdef

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1234567890abcdef",
    "name": "this is my domain_name",
    "android": "[
    {
        \"relation\": [
            \"delegate_permission\/common.handle_all_urls\"
        ],
        \"target\": {
            \"namespace\": \"android_app\",
            \"package_name\": \"com.example.app\",
            \"sha256_cert_fingerprints\": [
                \"hash_of_app_certificate\"
            ]
        }
    }
]",
    "ios": "{
    \"applinks\": {
        \"apps\": [],
        \"details\": [
            {
                \"appID\": \"D3KQX62K1A.com.example.photoapp\",
                \"paths\": [
                    \"\/albums\"
                ]
            },
            {
                \"appID\": \"D3KQX62K1A.com.example.videoapp\",
                \"paths\": [
                    \"\/videos\"
                ]
            }
        ]
    }
}"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef&format=xml

Query parameters

    id = 1234567890abcdef
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1234567890abcdef</id>  
    <name>this is my domain_name</name>  
    <android>[
    {
        "relation": [
            "delegate_permission/common.handle_all_urls"
        ],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.app",
            "sha256_cert_fingerprints": [
                "hash_of_app_certificate"
            ]
        }
    }
]</android>  
    <ios>{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "D3KQX62K1A.com.example.photoapp",
                "paths": [
                    "/albums"
                ]
            },
            {
                "appID": "D3KQX62K1A.com.example.videoapp",
                "paths": [
                    "/videos"
                ]
            }
        ]
    }
}</ios>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef&format=txt

Query parameters

    id = 1234567890abcdef
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_name=this is my domain_name
result_android=[    {        "relation": [            "delegate_permission/common.handle_all_urls"        ],        "target": {            "namespace": "android_app",            "package_name": "com.example.app",            "sha256_cert_fingerprints": [                "hash_of_app_certificate"            ]        }    }]
result_ios={    "applinks": {        "apps": [],        "details": [            {                "appID": "D3KQX62K1A.com.example.photoapp",                "paths": [                    "/albums"                ]            },            {                "appID": "D3KQX62K1A.com.example.videoapp",                "paths": [                    "/videos"                ]            }        ]    }}

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef&format=plain

Query parameters

    id = 1234567890abcdef
format = plain

Response

1234567890abcdef
this is my domain_name
[    {        "relation": [            "delegate_permission/common.handle_all_urls"        ],        "target": {            "namespace": "android_app",            "package_name": "com.example.app",            "sha256_cert_fingerprints": [                "hash_of_app_certificate"            ]        }    }]
{    "applinks": {        "apps": [],        "details": [            {                "appID": "D3KQX62K1A.com.example.photoapp",                "paths": [                    "/albums"                ]            },            {                "appID": "D3KQX62K1A.com.example.videoapp",                "paths": [                    "/videos"                ]            }        ]    }}

Required parameters

parameter	description
idID	ID of the deep link configuration

Return values

parameter	description
android	JSON configuration for Android (assetlinks.json)
id	ID of the deep link configuration
ios	JSON configuration for iOS (apple-app-site-association)
name	domain_name of the deep link configuration

/domains/deeplinks/list

access: [READ]

This method returns a list of deeplink configurations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/deeplinks/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": {
      "id": "1234567890abcdef",
      "name": "this is my domain_name",
      "android": "[{\"relation\":[\"delegate_permission\/common.handle_all_urls\"],\"target\":{\"namespace\":\"android_app\",\"package_name\":\"com.example.app\",\"sha256_cert_fingerprints\":[\"hash_of_app_certificate\"]}}]",
      "ios": "{\"applinks\":{\"apps\":[],\"details\":[{\"appID\":\"D3KQX62K1A.com.example.photoapp\",\"paths\":[\"\/albums\"]},{\"appID\":\"D3KQX62K1A.com.example.videoapp\",\"paths\":[\"\/videos\"]}]}}"
    },
    "android": "",
    "ios": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/deeplinks/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <id>1234567890abcdef</id>  
      <name>this is my domain_name</name>  
      <android>[{"relation":["delegate_permission/common.handle_all_urls"],"target":{"namespace":"android_app","package_name":"com.example.app","sha256_cert_fingerprints":["hash_of_app_certificate"]}}]</android>  
      <ios>{"applinks":{"apps":[],"details":[{"appID":"D3KQX62K1A.com.example.photoapp","paths":["/albums"]},{"appID":"D3KQX62K1A.com.example.videoapp","paths":["/videos"]}]}}</ios>  
    </data>  
    <android></android>  
    <ios></ios>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/deeplinks/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_id=1234567890abcdef
result_data_name=this is my domain_name
result_data_android=[{"relation":["delegate_permission/common.handle_all_urls"],"target":{"namespace":"android_app","package_name":"com.example.app","sha256_cert_fingerprints":["hash_of_app_certificate"]}}]
result_data_ios={"applinks":{"apps":[],"details":[{"appID":"D3KQX62K1A.com.example.photoapp","paths":["/albums"]},{"appID":"D3KQX62K1A.com.example.videoapp","paths":["/videos"]}]}}
result_android=
result_ios=

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/deeplinks/list?format=plain

Query parameters

format = plain

Response

1
1234567890abcdef
this is my domain_name
[{"relation":["delegate_permission/common.handle_all_urls"],"target":{"namespace":"android_app","package_name":"com.example.app","sha256_cert_fingerprints":["hash_of_app_certificate"]}}]
{"applinks":{"apps":[],"details":[{"appID":"D3KQX62K1A.com.example.photoapp","paths":["/albums"]},{"appID":"D3KQX62K1A.com.example.videoapp","paths":["/videos"]}]}}

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: start, length, search, orderby, sort, format, callback
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	total number of deep link configurations
data	array containing information on deep link configurations the user has access to

/domains/delete

access: [WRITE]

Delete a domain for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc

Query parameters

ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=xml

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=txt

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=plain

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143

Query parameters

ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=xml

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=txt

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=plain

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = plain

Response

334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of domain IDs to be deleted, max number of IDs in the list: 100

Return values

parameter	description
deleted	number of deleted domains
ids	[OPTIONAL] list of domain IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/domains/edit

access: [WRITE]

Edit a domain for logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1234567890abcdef",
    "force_https": "0",
    "host": "domain.ext",
    "nickname": "my domain nickname",
    "redirect_url": "https:\/\/redirect.users.to\/",
    "logo": "data:image\/gif;base64,R0lGODlhAQABAIAAAAAAAP\/\/\/yH5BAEAAAAALAAAAAABAAEAAAIBRAA7",
    "deeplink_id": "",
    "domain_domains_deeplink_name": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=xml

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data
                      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1234567890abcdef</id>  
    <force_https>0</force_https>  
    <host>domain.ext</host>  
    <nickname>my domain nickname</nickname>  
    <redirect_url>https://redirect.users.to/</redirect_url>  
    <logo>data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7</logo>  
    <deeplink_id></deeplink_id>  
    <domain_domains_deeplink_name></domain_domains_deeplink_name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=txt

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data
                      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_force_https=0
result_host=domain.ext
result_nickname=my domain nickname
result_redirect_url=https://redirect.users.to/
result_logo=data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
result_deeplink_id=
result_domain_domains_deeplink_name=

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=plain

Query parameters

                          id = 1234567890abcdef
                 force_https = 0
                        host = domain.ext
                    nickname = my domain nickname
                redirect_url = https://redirect.users.to/
                 deeplink_id = 
domain_domains_deeplink_name = 
                       input = name_of_the_form_field_that_contains_image_data
                      format = plain

Response

1234567890abcdef
0
domain.ext
my domain nickname
https://redirect.users.to/
data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7

Required parameters

parameter	description
idID	ID of the domain to edit

Optional parameters

parameter	description	max length
confirm_host_changeBOOLEAN	must be 1 if `host` is passed to confirm the intention to change the domain, its value is ignored if `host` is not passed
deeplink_idID	ID of the deep link configuration
favicon_urlSTRING	the default favicon URL for the branded domain (to avoid securiy issues it must be HTTPS)	4000
forceBOOLEAN	1 to disable security checks, 0 otherwise. This parameter is ignored if `host` is not passed or if `force_https = 1`
force_httpsBOOLEAN	1 to force HTTPS on HTTP requests, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain)
hostSTRING	the new domain (e.g., new.domain.ext), changing the domain impacts all tracking links to which it is associated, tracking links with the old domain will stop working; additionally, the change may take up to 24 hours before it actually takes effect and any SSL certificates associated with the old domain will be invalidated	850
inputSTRING	name of the HTML form field that contains image data for the logo (max dimensions `120px x 50px`, max size `150kB`), see notes for details
nicknameSTRING	the domain nickname	50
redirect_urlSTRING	the default destination URL where to redirect when a user types the domain without any alias (or an invalid alias)	4000
robots_txtSTRING	the `robots.txt` content to serve for the domain, when `robots_txt = :NONE:` requests to `robots.txt` will return a 404 error, if empty the following `robots.txt` will be served: user-agent: * disallow: /	4000

NOTES: The parameter input contains the name of the field of the HTML form that is used to send logo data to this method. Form must have enctype = "multipart/form-data" and method = "post".

<form 
    action="/a/i1/domains/edit" 
    method="post" 
    enctype="multipart/form-data">

    <input name="input" value="logo" type="hidden"/>

    [other form fields]

    <input name="logo" type="file"/>    

</form>

Return values

parameter	description
deeplink_id	ID of the deep link configuration
deeplink_name	name of the associated deep link configuration
favicon_url	default favicon URL
force_https	1 if the HTTPS is forced for the domain, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain)
host	the domain (e.g., domain.ext)
id	ID of the domain
logo	default logo for the domain (base64 encoded)
nickname	the domain nickname
redirect_url	default redirect URL
robots_txt	the `robots.txt` content to serve for the domain

/domains/info

access: [READ]

This method returns information on a domain, the returned information are that passed in the fields param (a comma separated list).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared

Query parameters

    id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "host": "domain.ext",
    "id": "7155502b34434f6a4d52396464684d3874442b454b773d3d",
    "aliases": [
      "domainext"
    ],
    "logo": "",
    "redirect_url": "",
    "favicon_url": "",
    "is_owner": 1,
    "is_default": 1,
    "is_shared": 0,
    "for_trials": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared&format=xml

Query parameters

    id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <host>domain.ext</host>  
    <id>7155502b34434f6a4d52396464684d3874442b454b773d3d</id>  
    <aliases>
      <i0>domainext</i0>  
    </aliases>  
    <logo></logo>  
    <redirect_url></redirect_url>  
    <favicon_url></favicon_url>  
    <is_owner>1</is_owner>  
    <is_default>1</is_default>  
    <is_shared>0</is_shared>  
    <for_trials>0</for_trials>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared&format=txt

Query parameters

    id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_host=domain.ext
result_id=7155502b34434f6a4d52396464684d3874442b454b773d3d
result_aliases_0=domainext
result_logo=
result_redirect_url=
result_favicon_url=
result_is_owner=1
result_is_default=1
result_is_shared=0
result_for_trials=0

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared&format=plain

Query parameters

    id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
format = plain

Response

domain.ext
7155502b34434f6a4d52396464684d3874442b454b773d3d
domainext



1
1
0
0

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, deeplink_name, is_owner, is_default, is_shared
idID	ID of the domain

Return values

parameter	description
aliases	[OPTIONAL] array containing aliases of the domain, i.e., equivalent domains, returned only if `aliases` is passed in `fields`
deeplink_id	[OPTIONAL] ID of the deep link configuration, returned only if `deeplink_id` is passed in `fields`
deeplink_name	[OPTIONAL] ID of the deep link configuration, returned only if `deeplink_name` is passed in `fields`
favicon_url	[OPTIONAL] default favicon URL, returned only if `favicon_url` is passed in `fields`
for_trials	[OPTIONAL] 1 if the domain is reserved to trial plans, 0 otherwise
force_https	[OPTIONAL] 1 if the "force HTTPS" flag is enabled for the domain, 0 otherwise; returned only if `force_https` is passed in `fields`
has_https	[OPTIONAL] 1 if the domain has a valid SSL certificate, 0 otherwise, returned only if `has_https` is passed in `fields`
host	[OPTIONAL] domain (e.g., domain.ext), returned only if `host` is passed in `fields`
id	[OPTIONAL] ID of the domain, returned only if `id` is passed in `fields`
is_default	[OPTIONAL] 1 if the domain is the default domain set in user's settings, 0 otherwise, returned only if `is_default` is passed in `fields`
is_owner	[OPTIONAL] 1 if the logged user is owner of the domain, 0 otherwise, returned only if `is_owner` is passed in `fields`
is_shared	[OPTIONAL] 1 if the domain is shared among all users, 0 otherwise, returned only if `is_shared` is passed in `fields`
logo	[OPTIONAL] default logo (base64 encoded), returned only if `logo` is passed in `fields`
nickname	[OPTIONAL] the domain nickname
redirect_url	[OPTIONAL] default redirect URL, returned only if `redirect_url` is passed in `fields`
robots_txt	[OPTIONAL] robots.txt configuration, see i1/domains/add for details

/domains/list

access: [READ]

This method returns a list of domains's data, specified in a comma separated input called fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/list?fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default

Query parameters

fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "host": "domain.ext",
        "id": "42f82e5eae16d1162fb2ff3295ac3bce",
        "aliases": [
          "domainext"
        ],
        "logo": "",
        "redirect_url": "",
        "favicon_url": "",
        "is_owner": 1,
        "is_default": 1
      },
      {
        "host": "global.domain",
        "id": "15df5931a281c284d23d7233038998e1",
        "aliases": [
          "globaldomain"
        ],
        "logo": "",
        "redirect_url": "https:\/\/www.redirect.to\/",
        "favicon_url": "",
        "is_owner": 0,
        "is_default": 0
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/list?fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default&format=xml

Query parameters

fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <host>domain.ext</host>  
        <id>42f82e5eae16d1162fb2ff3295ac3bce</id>  
        <aliases>
          <i0>domainext</i0>  
        </aliases>  
        <logo></logo>  
        <redirect_url></redirect_url>  
        <favicon_url></favicon_url>  
        <is_owner>1</is_owner>  
        <is_default>1</is_default>  
      </i0>  
      <i1>
        <host>global.domain</host>  
        <id>15df5931a281c284d23d7233038998e1</id>  
        <aliases>
          <i0>globaldomain</i0>  
        </aliases>  
        <logo></logo>  
        <redirect_url>https://www.redirect.to/</redirect_url>  
        <favicon_url></favicon_url>  
        <is_owner>0</is_owner>  
        <is_default>0</is_default>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/list?fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default&format=txt

Query parameters

fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_host=domain.ext
result_data_0_id=42f82e5eae16d1162fb2ff3295ac3bce
result_data_0_aliases_0=domainext
result_data_0_logo=
result_data_0_redirect_url=
result_data_0_favicon_url=
result_data_0_is_owner=1
result_data_0_is_default=1
result_data_1_host=global.domain
result_data_1_id=15df5931a281c284d23d7233038998e1
result_data_1_aliases_0=globaldomain
result_data_1_logo=
result_data_1_redirect_url=https://www.redirect.to/
result_data_1_favicon_url=
result_data_1_is_owner=0
result_data_1_is_default=0

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/list?fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default&format=plain

Query parameters

fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default
format = plain

Response

domain.ext
42f82e5eae16d1162fb2ff3295ac3bce
domainext



1
1
global.domain
15df5931a281c284d23d7233038998e1
globaldomain

https://www.redirect.to/

0
0

Example 5 (json)

Request

https://joturl.com/a/i1/domains/list?is_owner=1&fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default

Query parameters

is_owner = 1
  fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "host": "domain.ext",
        "id": "7155502b34434f6a4d52396464684d3874442b454b773d3d",
        "aliases": [
          "domainext"
        ],
        "logo": "",
        "redirect_url": "",
        "favicon_url": "",
        "is_owner": 1,
        "is_default": 1
      }
    ]
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/domains/list?is_owner=1&fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default&format=xml

Query parameters

is_owner = 1
  fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <host>domain.ext</host>  
        <id>7155502b34434f6a4d52396464684d3874442b454b773d3d</id>  
        <aliases>
          <i0>domainext</i0>  
        </aliases>  
        <logo></logo>  
        <redirect_url></redirect_url>  
        <favicon_url></favicon_url>  
        <is_owner>1</is_owner>  
        <is_default>1</is_default>  
      </i0>  
    </data>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/domains/list?is_owner=1&fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default&format=txt

Query parameters

is_owner = 1
  fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_host=domain.ext
result_data_0_id=7155502b34434f6a4d52396464684d3874442b454b773d3d
result_data_0_aliases_0=domainext
result_data_0_logo=
result_data_0_redirect_url=
result_data_0_favicon_url=
result_data_0_is_owner=1
result_data_0_is_default=1

Example 8 (plain)

Request

https://joturl.com/a/i1/domains/list?is_owner=1&fields=host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default&format=plain

Query parameters

is_owner = 1
  fields = host,id,aliases,logo,redirect_url,favicon_url,is_owner,is_default
  format = plain

Response

domain.ext
7155502b34434f6a4d52396464684d3874442b454b773d3d
domainext



1
1

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, deeplink_name, is_owner, is_default, is_shared, has_https, count

Optional parameters

parameter	description
is_defaultBOOLEAN	if 1 this method returns the default domain and all shared domains, if 0 all domains are returned
is_ownerBOOLEAN	if 1 this method returns only domains owned by the logged user, if 0 it returns only shared domains
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: deeplink_id, host, for_trials, force_https, id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, deeplink_name, is_owner, is_default, is_shared, has_https, count
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	[OPTIONAL] total number of domains, returned only if count is passed in fields
data	array containing required information on domains the user has access to

Available fields in the data array:

id: ID of the domain
aliases: array containing aliases of the domain, i.e., equivalent domains
host: domain (e.g., domain.ext)
force_https: 1 if the "force HTTPS" flag is enabled for the domain, 0 otherwise
redirect_url: default redirect URL
favicon_url: default favicon URL
logo: default logo (base64 encoded)
deeplink_id: ID of the deep link configuration
deeplink_name: name of the deep link configuration
domains_for_trials: 1 if the domain is reserved to trial plans, 0 otherwise
domains_nickname: the domain nickname
domains_robots_txt: the robots.txt content to serve for the domain, see i1/domains/add for details
alias_min_length: minimum number of characters allowed for the alias of tracking links created on this domain
alias_max_length: maximum number of characters allowed for the alias of tracking links created on this domain
is_owner: 1 if the logged user is owner of the domain, 0 otherwise
is_default: 1 if the domain is the default domain set in user's settings, 0 otherwise
is_shared: 1 if the domain is a shared domain (i.e., all users can use it), 0 otherwise
has_https: 1 if the domain has a valid SSL certificate, 0 otherwise

/domains/property

access: [READ]

This method returns the limits for a domain logo.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/domains/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "max_size": 153600,
    "max_width": 120,
    "max_height": 50,
    "allowed_types": [
      "image\/gif",
      "image\/jpeg",
      "image\/jpg",
      "image\/pjpeg",
      "image\/x-png",
      "image\/png"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/domains/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <max_size>153600</max_size>  
    <max_width>120</max_width>  
    <max_height>50</max_height>  
    <allowed_types>
      <i0>image/gif</i0>  
      <i1>image/jpeg</i1>  
      <i2>image/jpg</i2>  
      <i3>image/pjpeg</i3>  
      <i4>image/x-png</i4>  
      <i5>image/png</i5>  
    </allowed_types>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/domains/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_max_size=153600
result_max_width=120
result_max_height=50
result_allowed_types_0=image/gif
result_allowed_types_1=image/jpeg
result_allowed_types_2=image/jpg
result_allowed_types_3=image/pjpeg
result_allowed_types_4=image/x-png
result_allowed_types_5=image/png

Example 4 (plain)

Request

https://joturl.com/a/i1/domains/property?format=plain

Query parameters

format = plain

Response

153600
120
50
image/gif
image/jpeg
image/jpg
image/pjpeg
image/x-png
image/png

Return values

parameter	description
allowed_types	array of allowed image types (mime types)
max_height	maximum allowed height for the logo (pixels)
max_size	maximum allowed size for the logo (bytes)
max_width	maximum allowed width for the logo (pixels)

/gdprs

/gdprs/add

access: [WRITE]

This method adds a new GDPR template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F

Query parameters

  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "company": "JotUrl",
    "home_link": "https:\/\/www.joturl.com\/",
    "tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
    "id": "c977addbbebaaf7657fc3d96613e6711",
    "notes": "",
    "is_default": 0,
    "show_refuse_button": 0,
    "custom_translations": null
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=xml

Query parameters

  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <company>JotUrl</company>  
    <home_link>https://www.joturl.com/</home_link>  
    <tos_link>https://www.joturl.com/terms-of-service/</tos_link>  
    <id>c977addbbebaaf7657fc3d96613e6711</id>  
    <notes></notes>  
    <is_default>0</is_default>  
    <show_refuse_button>0</show_refuse_button>  
    <custom_translations></custom_translations>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=txt

Query parameters

  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_company=JotUrl
result_home_link=https://www.joturl.com/
result_tos_link=https://www.joturl.com/terms-of-service/
result_id=c977addbbebaaf7657fc3d96613e6711
result_notes=
result_is_default=0
result_show_refuse_button=0
result_custom_translations=

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=plain

Query parameters

  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/
   format = plain

Response

JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/
c977addbbebaaf7657fc3d96613e6711

0
0

Required parameters

parameter	description	max length
companySTRING	company name, it is also the name that identifies the template	255
home_linkURL	complete URL to the home page of the company website	4000
tos_linkURL	complete URL to the terms of service page of the company website	4000

Optional parameters

parameter	description	max length
custom_translationsJSON	stringified JSON of the custom GDPR translations
notesSTRING	template notes (not shown on the GDPR page)	255
show_refuse_buttonBOOLEAN	1 to show a "refuse all cookies" button on the consent window, 0 otherwise (only available on custom domains)

Return values

parameter	description
company	echo back of the company input parameter
custom_translations	echo back of the notes input parameter
home_link	echo back of the home_link input parameter
id	ID of the GDPR template
is_default	1 if it is the default template, 0 otherwise
notes	echo back of the notes input parameter
show_refuse_button	1 to show a "refuse all cookies" button, 0 otherwise
tos_link	echo back of the tos_link input parameter

/gdprs/count

access: [READ]

This method returns the number of GDPR templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 8
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>8</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters GDPR templates to be extracted by searching them

Return values

parameter	description
count	the number of GDPR templates

/gdprs/delete

access: [WRITE]

This method deletes one or more GDPR template(s).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/delete?ids=509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3

Query parameters

ids = 509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 2,
    "id": "09fdd33a3cdf5fe1241167b5b78b1f64"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/delete?ids=509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3&format=xml

Query parameters

   ids = 509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>2</deleted>  
    <id>09fdd33a3cdf5fe1241167b5b78b1f64</id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/delete?ids=509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3&format=txt

Query parameters

   ids = 509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=2
result_id=09fdd33a3cdf5fe1241167b5b78b1f64

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/delete?ids=509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3&format=plain

Query parameters

   ids = 509d55695fcdaea69188137536234e2d,f148524bbc5d3ea4076a7b8ad93d22b3
format = plain

Response

2
09fdd33a3cdf5fe1241167b5b78b1f64

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of GDPR templates to remove, max number of IDs in the list: 100

Return values

parameter	description
deleted	number of deleted GDPR templates on success, 0 otherwise
id	ID of the default GDPR template, if available

/gdprs/edit

access: [WRITE]

This method edits a GDPR template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/edit?id=afeab5087d3e56bd276126718957aa38&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F

Query parameters

       id = afeab5087d3e56bd276126718957aa38
  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "afeab5087d3e56bd276126718957aa38",
    "company": "JotUrl",
    "home_link": "https:\/\/www.joturl.com\/",
    "tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/edit?id=afeab5087d3e56bd276126718957aa38&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=xml

Query parameters

       id = afeab5087d3e56bd276126718957aa38
  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>afeab5087d3e56bd276126718957aa38</id>  
    <company>JotUrl</company>  
    <home_link>https://www.joturl.com/</home_link>  
    <tos_link>https://www.joturl.com/terms-of-service/</tos_link>  
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/edit?id=afeab5087d3e56bd276126718957aa38&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=txt

Query parameters

       id = afeab5087d3e56bd276126718957aa38
  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=afeab5087d3e56bd276126718957aa38
result_company=JotUrl
result_home_link=https://www.joturl.com/
result_tos_link=https://www.joturl.com/terms-of-service/
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/edit?id=afeab5087d3e56bd276126718957aa38&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=plain

Query parameters

       id = afeab5087d3e56bd276126718957aa38
  company = JotUrl
home_link = https://www.joturl.com/
 tos_link = https://www.joturl.com/terms-of-service/
   format = plain

Response

afeab5087d3e56bd276126718957aa38
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/
1

Required parameters

parameter	description
idID	ID of the GDPR template to edit

Optional parameters

parameter	description	max length
companySTRING	company name, it is also the name that identifies the template	255
custom_translationsJSON	stringified JSON of the custom GDPR translations, see i1/gdprs/add for details
home_linkURL	complete URL to the home page of the company website	4000
is_defaultBOOLEAN	1 to set the GDPR template as the default, 0 to remove the default flag (the first available GDPR template will be set as default, including the template identified by id)
notesSTRING	template notes (not shown on the GDPR page)	255
show_refuse_buttonBOOLEAN	1 to show a "refuse all cookies" button on the consent window, 0 otherwise (only available on custom domains)
tos_linkURL	complete URL to the terms of service page of the company website	4000

Return values

parameter	description
updated	1 on success, 0 otherwise

/gdprs/info

access: [READ]

This method returns info about a GDPR template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=899f5b65f5f9e0ffa3f1a2b16e76c0dd

Query parameters

fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
    id = 899f5b65f5f9e0ffa3f1a2b16e76c0dd

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "899f5b65f5f9e0ffa3f1a2b16e76c0dd",
        "company": "JotUrl",
        "home_link": "https:\/\/www.joturl.com\/",
        "tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
        "notes": "",
        "is_default": 1,
        "show_refuse_button": 0,
        "custom_translations": null
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=899f5b65f5f9e0ffa3f1a2b16e76c0dd&format=xml

Query parameters

fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
    id = 899f5b65f5f9e0ffa3f1a2b16e76c0dd
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>899f5b65f5f9e0ffa3f1a2b16e76c0dd</id>  
        <company>JotUrl</company>  
        <home_link>https://www.joturl.com/</home_link>  
        <tos_link>https://www.joturl.com/terms-of-service/</tos_link>  
        <notes></notes>  
        <is_default>1</is_default>  
        <show_refuse_button>0</show_refuse_button>  
        <custom_translations></custom_translations>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=899f5b65f5f9e0ffa3f1a2b16e76c0dd&format=txt

Query parameters

fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
    id = 899f5b65f5f9e0ffa3f1a2b16e76c0dd
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=899f5b65f5f9e0ffa3f1a2b16e76c0dd
result_data_0_company=JotUrl
result_data_0_home_link=https://www.joturl.com/
result_data_0_tos_link=https://www.joturl.com/terms-of-service/
result_data_0_notes=
result_data_0_is_default=1
result_data_0_show_refuse_button=0
result_data_0_custom_translations=

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=899f5b65f5f9e0ffa3f1a2b16e76c0dd&format=plain

Query parameters

fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
    id = 899f5b65f5f9e0ffa3f1a2b16e76c0dd
format = plain

Response

899f5b65f5f9e0ffa3f1a2b16e76c0dd
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/

1
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, company, home_link, tos_link, notes, is_default, show_refuse_button, custom_translations
idID	ID of the GDPR template

Return values

parameter	description
data	array containing information on the GDPR templates, returned information depends on the fields parameter.

/gdprs/list

access: [READ]

This method returns a list of GDPR templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations

Query parameters

fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "id": "7bec1713bb504d8f4d43505738d81637",
        "company": "JotUrl",
        "home_link": "https:\/\/www.joturl.com\/",
        "tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
        "notes": "",
        "is_default": 1,
        "show_refuse_button": 0,
        "custom_translations": null
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&format=xml

Query parameters

fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <id>7bec1713bb504d8f4d43505738d81637</id>  
        <company>JotUrl</company>  
        <home_link>https://www.joturl.com/</home_link>  
        <tos_link>https://www.joturl.com/terms-of-service/</tos_link>  
        <notes></notes>  
        <is_default>1</is_default>  
        <show_refuse_button>0</show_refuse_button>  
        <custom_translations></custom_translations>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&format=txt

Query parameters

fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=7bec1713bb504d8f4d43505738d81637
result_data_0_company=JotUrl
result_data_0_home_link=https://www.joturl.com/
result_data_0_tos_link=https://www.joturl.com/terms-of-service/
result_data_0_notes=
result_data_0_is_default=1
result_data_0_show_refuse_button=0
result_data_0_custom_translations=

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&format=plain

Query parameters

fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
format = plain

Response

1
7bec1713bb504d8f4d43505738d81637
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/

1
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, company, home_link, tos_link, notes, is_default, show_refuse_button, custom_translations

Optional parameters

parameter	description
lengthINTEGER	extracts this number of GDPR templates (maxmimum allowed: 100)
orderbyARRAY	orders GDPR templates by field, available fields: id, company, home_link, tos_link, notes, is_default, show_refuse_button, custom_translations
searchSTRING	filters GDPR templates to be extracted by searching them
sortSTRING	sorts GDPR templates in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract GDPR templates from this position

Return values

parameter	description
count	[OPTIONAL] total number of GDPR templates, returned only if count is passed in fields
data	array containing information on the GDPR templates, returned information depends on the fields parameter.

/gdprs/preview

access: [READ]

This method returns a preview for the GDPR consent page (HTML).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/preview?id=8a88f65742597679d454deeec03e464f

Query parameters

id = 8a88f65742597679d454deeec03e464f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "html": "<html lang=\"en\"> [GDPR consent HTML] <\/html>"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/preview?id=8a88f65742597679d454deeec03e464f&format=xml

Query parameters

    id = 8a88f65742597679d454deeec03e464f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <html><[CDATA[&lt;html lang="en"&gt; [GDPR consent HTML] &lt;/html&gt;]]></html>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/preview?id=8a88f65742597679d454deeec03e464f&format=txt

Query parameters

    id = 8a88f65742597679d454deeec03e464f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_html=&lt;html lang="en"&gt; [GDPR consent HTML] &lt;/html&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/preview?id=8a88f65742597679d454deeec03e464f&format=plain

Query parameters

    id = 8a88f65742597679d454deeec03e464f
format = plain

Response

&lt;html lang="en"&gt; [GDPR consent HTML] &lt;/html&gt;

Optional parameters

parameter	description	max length
companySTRING	NA	255
custom_translationsJSON	custom translations for the GDPR consent preview
home_linkURL	NA	4000
idID	ID of the GDPR template
show_refuse_buttonBOOLEAN	NA
tos_linkURL	NA	4000

Return values

parameter	description
html	GDPR consent HTML

/gdprs/property

access: [READ]

This method returns a list of property for a custom GDPR consent.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/gdprs/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "about_cookies": {
      "type": "text",
      "default": "About cookies",
      "notes": "label of the \"about cookies\" tab",
      "max-length": 50
    },
    "accept_button": {
      "type": "text",
      "default": "Accept cookies",
      "notes": "label of the accept button",
      "max-length": 50
    },
    "agreement": {
      "type": "markdown",
      "default": "By clicking \"Accept cookies,\" you agree to the sto [...]",
      "notes": "agreement text",
      "max-length": 1000
    },
    "caption": {
      "type": "text",
      "default": "Cookies",
      "notes": "title of the consent window",
      "max-length": 50
    },
    "consent": {
      "type": "markdown",
      "default": "%COMPANY_WITH_LINK% uses cookies to customise cont [...]",
      "notes": "consent text",
      "max-length": 1000
    },
    "cookie_control_label": {
      "type": "text",
      "default": "aboutcookies.org",
      "notes": "label of the aboutcookies.org link",
      "max-length": 100
    },
    "cookie_control_link": {
      "type": "url",
      "default": "https:\/\/www.aboutcookies.org\/",
      "notes": "URL of the aboutcookies.org page",
      "max-length": 2000
    },
    "cookies_enabled": {
      "type": "text",
      "default": "Enabled",
      "notes": "\"enabled\" header of the consent table",
      "max-length": 30
    },
    "cookies_settings": {
      "type": "text",
      "default": "Cookies settings",
      "notes": "title of the detailed cookie settings page",
      "max-length": 50
    },
    "cookies_used": {
      "type": "text",
      "default": "Cookie name",
      "notes": "\"cookie name\" header of the consent table",
      "max-length": 30
    },
    "description_control_cookies": {
      "type": "markdown",
      "default": "You can control and\/or delete cookies as you wish  [...]",
      "notes": "content of the \"How to control cookies\" section",
      "max-length": 1000
    },
    "description_cookies": {
      "type": "markdown",
      "default": "A cookie is a small text file that a website saves [...]",
      "notes": "content of the \"What are cookies?\" section",
      "max-length": 1000
    },
    "description_marketing_cookies": {
      "type": "markdown",
      "default": "Marketing cookies are used to track visitors acros [...]",
      "notes": "content of the \"What are marketing cookies?\" section",
      "max-length": 1000
    },
    "descriptions.adroll": {
      "type": "markdown",
      "default": "AdRoll is a retargeting and prospecting platform f [...]",
      "notes": "AdRoll consent details",
      "max-length": 1000
    },
    "descriptions.bing": {
      "type": "markdown",
      "default": "Bing Remarketing is a remarketing and behavioral t [...]",
      "notes": "Bing consent details",
      "max-length": 1000
    },
    "descriptions.custom": {
      "type": "markdown",
      "default": "Please refer to the terms of service and cookie po [...]",
      "notes": "Custom consent details",
      "max-length": 1000
    },
    "descriptions.facebook": {
      "type": "markdown",
      "default": "Facebook Remarketing is a remarketing and behavior [...]",
      "notes": "Facebook consent details",
      "max-length": 1000
    },
    "descriptions.google_adwords": {
      "type": "markdown",
      "default": "Google AdWords Remarketing is a remarketing and be [...]",
      "notes": "Google AdWords consent details",
      "max-length": 1000
    },
    "descriptions.google_analytics": {
      "type": "markdown",
      "default": "Google Analytics for Display Advertising is a rema [...]",
      "notes": "Google Analytics consent details",
      "max-length": 1000
    },
    "descriptions.google_tag_manager": {
      "type": "markdown",
      "default": "Google Tag Manager is a tag management service pro [...]",
      "notes": "Google Tag Manager consent details",
      "max-length": 1000
    },
    "descriptions.linkedin": {
      "type": "markdown",
      "default": "LinkedIn Website Retargeting is a remarketing and  [...]",
      "notes": "LinkedIn consent details",
      "max-length": 1000
    },
    "descriptions.manychat": {
      "type": "markdown",
      "default": "ManyChat is a leading Facebook Messenger marketing [...]",
      "notes": "ManyChat consent details",
      "max-length": 1000
    },
    "descriptions.pinterest": {
      "type": "markdown",
      "default": "Pinterest Remarketing is a remarketing and behavio [...]",
      "notes": "Pinterest consent details",
      "max-length": 1000
    },
    "descriptions.quora": {
      "type": "markdown",
      "default": "Quora is an American social question-and-answer we [...]",
      "notes": "Quora consent details",
      "max-length": 1000
    },
    "descriptions.snapchat": {
      "type": "markdown",
      "default": "Snapchat is a mobile app for Android and iOS devic [...]",
      "notes": "Snapchat consent details",
      "max-length": 1000
    },
    "descriptions.tiktok": {
      "type": "markdown",
      "default": "TikTok (Douyin) Remarketing is a remarketing and b [...]",
      "notes": "TikTok consent details",
      "max-length": 1000
    },
    "descriptions.twitter": {
      "type": "markdown",
      "default": "Twitter Remarketing is a remarketing and behaviora [...]",
      "notes": "Twitter consent details",
      "max-length": 1000
    },
    "here": {
      "type": "text",
      "default": "here",
      "notes": "text of the link that leads to the \"control and\/or delete cookies\" page",
      "max-length": 50
    },
    "marketing_cookies": {
      "type": "text",
      "default": "Marketing cookies",
      "notes": "label of the \"marketing cookies\" tab",
      "max-length": 50
    },
    "noscript": {
      "type": "text",
      "default": "You need to enable JavaScript to run this page.",
      "notes": "shown when the user's browser does not support JavaScript",
      "max-length": 100
    },
    "refuse_button": {
      "type": "text",
      "default": "I refuse cookies",
      "notes": "label of the refuse button",
      "max-length": 50
    },
    "save_button": {
      "type": "text",
      "default": "Save & continue",
      "notes": "label of the save button",
      "max-length": 50
    },
    "see_details": {
      "type": "text",
      "default": "See details",
      "notes": "text of the link that leads to the extended consent page (custom page)",
      "max-length": 50
    },
    "settings_button": {
      "type": "text",
      "default": "Cookies settings",
      "notes": "label of the settings button",
      "max-length": 50
    },
    "title": {
      "type": "text",
      "default": "%COMPANY% GDPR - Cookie consent form",
      "notes": "title of the HTML page consent",
      "max-length": 50
    },
    "title_control_cookies": {
      "type": "text",
      "default": "How to control cookies",
      "notes": "title of the \"How to control cookies\" section",
      "max-length": 50
    },
    "title_cookies": {
      "type": "text",
      "default": "What are cookies?",
      "notes": "title of the \"What are cookies?\" section",
      "max-length": 50
    },
    "title_marketing_cookies": {
      "type": "text",
      "default": "What are marketing cookies?",
      "notes": "title of the \"What are marketing cookies?\" section",
      "max-length": 50
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/gdprs/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <about_cookies>
      <type>text</type>  
      <default>About cookies</default>  
      <notes>label of the "about cookies" tab</notes>  
      <max-length>50</max-length>  
    </about_cookies>  
    <accept_button>
      <type>text</type>  
      <default>Accept cookies</default>  
      <notes>label of the accept button</notes>  
      <max-length>50</max-length>  
    </accept_button>  
    <agreement>
      <type>markdown</type>  
      <default>By clicking "Accept cookies," you agree to the sto [...]</default>  
      <notes>agreement text</notes>  
      <max-length>1000</max-length>  
    </agreement>  
    <caption>
      <type>text</type>  
      <default>Cookies</default>  
      <notes>title of the consent window</notes>  
      <max-length>50</max-length>  
    </caption>  
    <consent>
      <type>markdown</type>  
      <default>%COMPANY_WITH_LINK% uses cookies to customise cont [...]</default>  
      <notes>consent text</notes>  
      <max-length>1000</max-length>  
    </consent>  
    <cookie_control_label>
      <type>text</type>  
      <default>aboutcookies.org</default>  
      <notes>label of the aboutcookies.org link</notes>  
      <max-length>100</max-length>  
    </cookie_control_label>  
    <cookie_control_link>
      <type>url</type>  
      <default>https://www.aboutcookies.org/</default>  
      <notes>URL of the aboutcookies.org page</notes>  
      <max-length>2000</max-length>  
    </cookie_control_link>  
    <cookies_enabled>
      <type>text</type>  
      <default>Enabled</default>  
      <notes>"enabled" header of the consent table</notes>  
      <max-length>30</max-length>  
    </cookies_enabled>  
    <cookies_settings>
      <type>text</type>  
      <default>Cookies settings</default>  
      <notes>title of the detailed cookie settings page</notes>  
      <max-length>50</max-length>  
    </cookies_settings>  
    <cookies_used>
      <type>text</type>  
      <default>Cookie name</default>  
      <notes>"cookie name" header of the consent table</notes>  
      <max-length>30</max-length>  
    </cookies_used>  
    <description_control_cookies>
      <type>markdown</type>  
      <default>You can control and/or delete cookies as you wish  [...]</default>  
      <notes>content of the "How to control cookies" section</notes>  
      <max-length>1000</max-length>  
    </description_control_cookies>  
    <description_cookies>
      <type>markdown</type>  
      <default>A cookie is a small text file that a website saves [...]</default>  
      <notes>content of the "What are cookies?" section</notes>  
      <max-length>1000</max-length>  
    </description_cookies>  
    <description_marketing_cookies>
      <type>markdown</type>  
      <default>Marketing cookies are used to track visitors acros [...]</default>  
      <notes>content of the "What are marketing cookies?" section</notes>  
      <max-length>1000</max-length>  
    </description_marketing_cookies>  
    <descriptions.adroll>
      <type>markdown</type>  
      <default>AdRoll is a retargeting and prospecting platform f [...]</default>  
      <notes>AdRoll consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.adroll>  
    <descriptions.bing>
      <type>markdown</type>  
      <default>Bing Remarketing is a remarketing and behavioral t [...]</default>  
      <notes>Bing consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.bing>  
    <descriptions.custom>
      <type>markdown</type>  
      <default>Please refer to the terms of service and cookie po [...]</default>  
      <notes>Custom consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.custom>  
    <descriptions.facebook>
      <type>markdown</type>  
      <default>Facebook Remarketing is a remarketing and behavior [...]</default>  
      <notes>Facebook consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.facebook>  
    <descriptions.google_adwords>
      <type>markdown</type>  
      <default>Google AdWords Remarketing is a remarketing and be [...]</default>  
      <notes>Google AdWords consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.google_adwords>  
    <descriptions.google_analytics>
      <type>markdown</type>  
      <default>Google Analytics for Display Advertising is a rema [...]</default>  
      <notes>Google Analytics consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.google_analytics>  
    <descriptions.google_tag_manager>
      <type>markdown</type>  
      <default>Google Tag Manager is a tag management service pro [...]</default>  
      <notes>Google Tag Manager consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.google_tag_manager>  
    <descriptions.linkedin>
      <type>markdown</type>  
      <default>LinkedIn Website Retargeting is a remarketing and  [...]</default>  
      <notes>LinkedIn consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.linkedin>  
    <descriptions.manychat>
      <type>markdown</type>  
      <default>ManyChat is a leading Facebook Messenger marketing [...]</default>  
      <notes>ManyChat consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.manychat>  
    <descriptions.pinterest>
      <type>markdown</type>  
      <default>Pinterest Remarketing is a remarketing and behavio [...]</default>  
      <notes>Pinterest consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.pinterest>  
    <descriptions.quora>
      <type>markdown</type>  
      <default>Quora is an American social question-and-answer we [...]</default>  
      <notes>Quora consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.quora>  
    <descriptions.snapchat>
      <type>markdown</type>  
      <default>Snapchat is a mobile app for Android and iOS devic [...]</default>  
      <notes>Snapchat consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.snapchat>  
    <descriptions.tiktok>
      <type>markdown</type>  
      <default>TikTok (Douyin) Remarketing is a remarketing and b [...]</default>  
      <notes>TikTok consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.tiktok>  
    <descriptions.twitter>
      <type>markdown</type>  
      <default>Twitter Remarketing is a remarketing and behaviora [...]</default>  
      <notes>Twitter consent details</notes>  
      <max-length>1000</max-length>  
    </descriptions.twitter>  
    <here>
      <type>text</type>  
      <default>here</default>  
      <notes>text of the link that leads to the "control and/or delete cookies" page</notes>  
      <max-length>50</max-length>  
    </here>  
    <marketing_cookies>
      <type>text</type>  
      <default>Marketing cookies</default>  
      <notes>label of the "marketing cookies" tab</notes>  
      <max-length>50</max-length>  
    </marketing_cookies>  
    <noscript>
      <type>text</type>  
      <default>You need to enable JavaScript to run this page.</default>  
      <notes>shown when the user's browser does not support JavaScript</notes>  
      <max-length>100</max-length>  
    </noscript>  
    <refuse_button>
      <type>text</type>  
      <default>I refuse cookies</default>  
      <notes>label of the refuse button</notes>  
      <max-length>50</max-length>  
    </refuse_button>  
    <save_button>
      <type>text</type>  
      <default><[CDATA[Save &amp; continue]]></default>  
      <notes>label of the save button</notes>  
      <max-length>50</max-length>  
    </save_button>  
    <see_details>
      <type>text</type>  
      <default>See details</default>  
      <notes>text of the link that leads to the extended consent page (custom page)</notes>  
      <max-length>50</max-length>  
    </see_details>  
    <settings_button>
      <type>text</type>  
      <default>Cookies settings</default>  
      <notes>label of the settings button</notes>  
      <max-length>50</max-length>  
    </settings_button>  
    <title>
      <type>text</type>  
      <default>%COMPANY% GDPR - Cookie consent form</default>  
      <notes>title of the HTML page consent</notes>  
      <max-length>50</max-length>  
    </title>  
    <title_control_cookies>
      <type>text</type>  
      <default>How to control cookies</default>  
      <notes>title of the "How to control cookies" section</notes>  
      <max-length>50</max-length>  
    </title_control_cookies>  
    <title_cookies>
      <type>text</type>  
      <default>What are cookies?</default>  
      <notes>title of the "What are cookies?" section</notes>  
      <max-length>50</max-length>  
    </title_cookies>  
    <title_marketing_cookies>
      <type>text</type>  
      <default>What are marketing cookies?</default>  
      <notes>title of the "What are marketing cookies?" section</notes>  
      <max-length>50</max-length>  
    </title_marketing_cookies>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/gdprs/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_about_cookies_type=text
result_about_cookies_default=About cookies
result_about_cookies_notes=label of the "about cookies" tab
result_about_cookies_max-length=50
result_accept_button_type=text
result_accept_button_default=Accept cookies
result_accept_button_notes=label of the accept button
result_accept_button_max-length=50
result_agreement_type=markdown
result_agreement_default=By clicking "Accept cookies," you agree to the sto [...]
result_agreement_notes=agreement text
result_agreement_max-length=1000
result_caption_type=text
result_caption_default=Cookies
result_caption_notes=title of the consent window
result_caption_max-length=50
result_consent_type=markdown
result_consent_default=%COMPANY_WITH_LINK% uses cookies to customise cont [...]
result_consent_notes=consent text
result_consent_max-length=1000
result_cookie_control_label_type=text
result_cookie_control_label_default=aboutcookies.org
result_cookie_control_label_notes=label of the aboutcookies.org link
result_cookie_control_label_max-length=100
result_cookie_control_link_type=url
result_cookie_control_link_default=https://www.aboutcookies.org/
result_cookie_control_link_notes=URL of the aboutcookies.org page
result_cookie_control_link_max-length=2000
result_cookies_enabled_type=text
result_cookies_enabled_default=Enabled
result_cookies_enabled_notes="enabled" header of the consent table
result_cookies_enabled_max-length=30
result_cookies_settings_type=text
result_cookies_settings_default=Cookies settings
result_cookies_settings_notes=title of the detailed cookie settings page
result_cookies_settings_max-length=50
result_cookies_used_type=text
result_cookies_used_default=Cookie name
result_cookies_used_notes="cookie name" header of the consent table
result_cookies_used_max-length=30
result_description_control_cookies_type=markdown
result_description_control_cookies_default=You can control and/or delete cookies as you wish  [...]
result_description_control_cookies_notes=content of the "How to control cookies" section
result_description_control_cookies_max-length=1000
result_description_cookies_type=markdown
result_description_cookies_default=A cookie is a small text file that a website saves [...]
result_description_cookies_notes=content of the "What are cookies?" section
result_description_cookies_max-length=1000
result_description_marketing_cookies_type=markdown
result_description_marketing_cookies_default=Marketing cookies are used to track visitors acros [...]
result_description_marketing_cookies_notes=content of the "What are marketing cookies?" section
result_description_marketing_cookies_max-length=1000
result_descriptions.adroll_type=markdown
result_descriptions.adroll_default=AdRoll is a retargeting and prospecting platform f [...]
result_descriptions.adroll_notes=AdRoll consent details
result_descriptions.adroll_max-length=1000
result_descriptions.bing_type=markdown
result_descriptions.bing_default=Bing Remarketing is a remarketing and behavioral t [...]
result_descriptions.bing_notes=Bing consent details
result_descriptions.bing_max-length=1000
result_descriptions.custom_type=markdown
result_descriptions.custom_default=Please refer to the terms of service and cookie po [...]
result_descriptions.custom_notes=Custom consent details
result_descriptions.custom_max-length=1000
result_descriptions.facebook_type=markdown
result_descriptions.facebook_default=Facebook Remarketing is a remarketing and behavior [...]
result_descriptions.facebook_notes=Facebook consent details
result_descriptions.facebook_max-length=1000
result_descriptions.google_adwords_type=markdown
result_descriptions.google_adwords_default=Google AdWords Remarketing is a remarketing and be [...]
result_descriptions.google_adwords_notes=Google AdWords consent details
result_descriptions.google_adwords_max-length=1000
result_descriptions.google_analytics_type=markdown
result_descriptions.google_analytics_default=Google Analytics for Display Advertising is a rema [...]
result_descriptions.google_analytics_notes=Google Analytics consent details
result_descriptions.google_analytics_max-length=1000
result_descriptions.google_tag_manager_type=markdown
result_descriptions.google_tag_manager_default=Google Tag Manager is a tag management service pro [...]
result_descriptions.google_tag_manager_notes=Google Tag Manager consent details
result_descriptions.google_tag_manager_max-length=1000
result_descriptions.linkedin_type=markdown
result_descriptions.linkedin_default=LinkedIn Website Retargeting is a remarketing and  [...]
result_descriptions.linkedin_notes=LinkedIn consent details
result_descriptions.linkedin_max-length=1000
result_descriptions.manychat_type=markdown
result_descriptions.manychat_default=ManyChat is a leading Facebook Messenger marketing [...]
result_descriptions.manychat_notes=ManyChat consent details
result_descriptions.manychat_max-length=1000
result_descriptions.pinterest_type=markdown
result_descriptions.pinterest_default=Pinterest Remarketing is a remarketing and behavio [...]
result_descriptions.pinterest_notes=Pinterest consent details
result_descriptions.pinterest_max-length=1000
result_descriptions.quora_type=markdown
result_descriptions.quora_default=Quora is an American social question-and-answer we [...]
result_descriptions.quora_notes=Quora consent details
result_descriptions.quora_max-length=1000
result_descriptions.snapchat_type=markdown
result_descriptions.snapchat_default=Snapchat is a mobile app for Android and iOS devic [...]
result_descriptions.snapchat_notes=Snapchat consent details
result_descriptions.snapchat_max-length=1000
result_descriptions.tiktok_type=markdown
result_descriptions.tiktok_default=TikTok (Douyin) Remarketing is a remarketing and b [...]
result_descriptions.tiktok_notes=TikTok consent details
result_descriptions.tiktok_max-length=1000
result_descriptions.twitter_type=markdown
result_descriptions.twitter_default=Twitter Remarketing is a remarketing and behaviora [...]
result_descriptions.twitter_notes=Twitter consent details
result_descriptions.twitter_max-length=1000
result_here_type=text
result_here_default=here
result_here_notes=text of the link that leads to the "control and/or delete cookies" page
result_here_max-length=50
result_marketing_cookies_type=text
result_marketing_cookies_default=Marketing cookies
result_marketing_cookies_notes=label of the "marketing cookies" tab
result_marketing_cookies_max-length=50
result_noscript_type=text
result_noscript_default=You need to enable JavaScript to run this page.
result_noscript_notes=shown when the user's browser does not support JavaScript
result_noscript_max-length=100
result_refuse_button_type=text
result_refuse_button_default=I refuse cookies
result_refuse_button_notes=label of the refuse button
result_refuse_button_max-length=50
result_save_button_type=text
result_save_button_default=Save &amp; continue
result_save_button_notes=label of the save button
result_save_button_max-length=50
result_see_details_type=text
result_see_details_default=See details
result_see_details_notes=text of the link that leads to the extended consent page (custom page)
result_see_details_max-length=50
result_settings_button_type=text
result_settings_button_default=Cookies settings
result_settings_button_notes=label of the settings button
result_settings_button_max-length=50
result_title_type=text
result_title_default=%COMPANY% GDPR - Cookie consent form
result_title_notes=title of the HTML page consent
result_title_max-length=50
result_title_control_cookies_type=text
result_title_control_cookies_default=How to control cookies
result_title_control_cookies_notes=title of the "How to control cookies" section
result_title_control_cookies_max-length=50
result_title_cookies_type=text
result_title_cookies_default=What are cookies?
result_title_cookies_notes=title of the "What are cookies?" section
result_title_cookies_max-length=50
result_title_marketing_cookies_type=text
result_title_marketing_cookies_default=What are marketing cookies?
result_title_marketing_cookies_notes=title of the "What are marketing cookies?" section
result_title_marketing_cookies_max-length=50

Example 4 (plain)

Request

https://joturl.com/a/i1/gdprs/property?format=plain

Query parameters

format = plain

Response

text
default:About cookies
label of the "about cookies" tab
50
text
default:Accept cookies
label of the accept button
50
markdown
default:By clicking "Accept cookies," you agree to the sto [...]
agreement text
1000
text
default:Cookies
title of the consent window
50
markdown
default:%COMPANY_WITH_LINK% uses cookies to customise cont [...]
consent text
1000
text
default:aboutcookies.org
label of the aboutcookies.org link
100
url
default:https://www.aboutcookies.org/
URL of the aboutcookies.org page
2000
text
default:Enabled
"enabled" header of the consent table
30
text
default:Cookies settings
title of the detailed cookie settings page
50
text
default:Cookie name
"cookie name" header of the consent table
30
markdown
default:You can control and/or delete cookies as you wish  [...]
content of the "How to control cookies" section
1000
markdown
default:A cookie is a small text file that a website saves [...]
content of the "What are cookies?" section
1000
markdown
default:Marketing cookies are used to track visitors acros [...]
content of the "What are marketing cookies?" section
1000
markdown
default:AdRoll is a retargeting and prospecting platform f [...]
AdRoll consent details
1000
markdown
default:Bing Remarketing is a remarketing and behavioral t [...]
Bing consent details
1000
markdown
default:Please refer to the terms of service and cookie po [...]
Custom consent details
1000
markdown
default:Facebook Remarketing is a remarketing and behavior [...]
Facebook consent details
1000
markdown
default:Google AdWords Remarketing is a remarketing and be [...]
Google AdWords consent details
1000
markdown
default:Google Analytics for Display Advertising is a rema [...]
Google Analytics consent details
1000
markdown
default:Google Tag Manager is a tag management service pro [...]
Google Tag Manager consent details
1000
markdown
default:LinkedIn Website Retargeting is a remarketing and  [...]
LinkedIn consent details
1000
markdown
default:ManyChat is a leading Facebook Messenger marketing [...]
ManyChat consent details
1000
markdown
default:Pinterest Remarketing is a remarketing and behavio [...]
Pinterest consent details
1000
markdown
default:Quora is an American social question-and-answer we [...]
Quora consent details
1000
markdown
default:Snapchat is a mobile app for Android and iOS devic [...]
Snapchat consent details
1000
markdown
default:TikTok (Douyin) Remarketing is a remarketing and b [...]
TikTok consent details
1000
markdown
default:Twitter Remarketing is a remarketing and behaviora [...]
Twitter consent details
1000
text
default:here
text of the link that leads to the "control and/or delete cookies" page
50
text
default:Marketing cookies
label of the "marketing cookies" tab
50
text
default:You need to enable JavaScript to run this page.
shown when the user's browser does not support JavaScript
100
text
default:I refuse cookies
label of the refuse button
50
text
default:Save &amp; continue
label of the save button
50
text
default:See details
text of the link that leads to the extended consent page (custom page)
50
text
default:Cookies settings
label of the settings button
50
text
default:%COMPANY% GDPR - Cookie consent form
title of the HTML page consent
50
text
default:How to control cookies
title of the "How to control cookies" section
50
text
default:What are cookies?
title of the "What are cookies?" section
50
text
default:What are marketing cookies?
title of the "What are marketing cookies?" section
50

Return values

parameter	description
about_cookies	label of the "about cookies" tab (type: text, max length: 50)
accept_button	label of the accept button (type: text, max length: 50)
agreement	agreement text (type: markdown, max length: 1000)
caption	title of the consent window (type: text, max length: 50)
consent	consent text (type: markdown, max length: 1000)
cookie_control_label	label of the aboutcookies.org link (type: text, max length: 100)
cookie_control_link	URL of the aboutcookies.org page (type: url, max length: 2000)
cookies_enabled	"enabled" header of the consent table (type: text, max length: 30)
cookies_settings	title of the detailed cookie settings page (type: text, max length: 50)
cookies_used	"cookie name" header of the consent table (type: text, max length: 30)
description_control_cookies	content of the "How to control cookies" section (type: markdown, max length: 1000)
description_cookies	content of the "What are cookies?" section (type: markdown, max length: 1000)
description_marketing_cookies	content of the "What are marketing cookies?" section (type: markdown, max length: 1000)
descriptions.adroll	AdRoll consent details (type: markdown, max length: 1000)
descriptions.bing	Bing consent details (type: markdown, max length: 1000)
descriptions.custom	Custom consent details (type: markdown, max length: 1000)
descriptions.facebook	Facebook consent details (type: markdown, max length: 1000)
descriptions.google_adwords	Google AdWords consent details (type: markdown, max length: 1000)
descriptions.google_analytics	Google Analytics consent details (type: markdown, max length: 1000)
descriptions.google_tag_manager	Google Tag Manager consent details (type: markdown, max length: 1000)
descriptions.linkedin	LinkedIn consent details (type: markdown, max length: 1000)
descriptions.manychat	ManyChat consent details (type: markdown, max length: 1000)
descriptions.pinterest	Pinterest consent details (type: markdown, max length: 1000)
descriptions.quora	Quora consent details (type: markdown, max length: 1000)
descriptions.snapchat	Snapchat consent details (type: markdown, max length: 1000)
descriptions.tiktok	TikTok consent details (type: markdown, max length: 1000)
descriptions.twitter	Twitter consent details (type: markdown, max length: 1000)
here	text of the link that leads to the "control and/or delete cookies" page (type: text, max length: 50)
marketing_cookies	label of the "marketing cookies" tab (type: text, max length: 50)
noscript	shown when the user's browser does not support JavaScript (type: text, max length: 100)
refuse_button	label of the refuse button (type: text, max length: 50)
save_button	label of the save button (type: text, max length: 50)
see_details	text of the link that leads to the extended consent page (custom page) (type: text, max length: 50)
settings_button	label of the settings button (type: text, max length: 50)
title	title of the HTML page consent (type: text, max length: 50)
title_control_cookies	title of the "How to control cookies" section (type: text, max length: 50)
title_cookies	title of the "What are cookies?" section (type: text, max length: 50)
title_marketing_cookies	title of the "What are marketing cookies?" section (type: text, max length: 50)

/jotbars

/jotbars/property

access: [READ]

This method returns a list of property of a jotbar.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/jotbars/property?context=url

Query parameters

context = url

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "positions": "inherit,right,left,top,bottom,empty",
    "dimensions": "inherit,small,medium,big"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/jotbars/property?context=url&format=xml

Query parameters

context = url
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <positions>inherit,right,left,top,bottom,empty</positions>  
    <dimensions>inherit,small,medium,big</dimensions>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/jotbars/property?context=url&format=txt

Query parameters

context = url
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_positions=inherit,right,left,top,bottom,empty
result_dimensions=inherit,small,medium,big

Example 4 (plain)

Request

https://joturl.com/a/i1/jotbars/property?context=url&format=plain

Query parameters

context = url
 format = plain

Response

inherit,right,left,top,bottom,empty
inherit,small,medium,big

Example 5 (json)

Request

https://joturl.com/a/i1/jotbars/property?context=project

Query parameters

context = project

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "positions": "inherit,right,left,top,bottom,empty",
    "dimensions": "inherit,small,medium,big"
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/jotbars/property?context=project&format=xml

Query parameters

context = project
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <positions>inherit,right,left,top,bottom,empty</positions>  
    <dimensions>inherit,small,medium,big</dimensions>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/jotbars/property?context=project&format=txt

Query parameters

context = project
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_positions=inherit,right,left,top,bottom,empty
result_dimensions=inherit,small,medium,big

Example 8 (plain)

Request

https://joturl.com/a/i1/jotbars/property?context=project&format=plain

Query parameters

context = project
 format = plain

Response

inherit,right,left,top,bottom,empty
inherit,small,medium,big

Example 9 (json)

Request

https://joturl.com/a/i1/jotbars/property?context=user

Query parameters

context = user

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "positions": "right,left,top,bottom,empty",
    "dimensions": "small,medium,big"
  }
}

Example 10 (xml)

Request

https://joturl.com/a/i1/jotbars/property?context=user&format=xml

Query parameters

context = user
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <positions>right,left,top,bottom,empty</positions>  
    <dimensions>small,medium,big</dimensions>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/jotbars/property?context=user&format=txt

Query parameters

context = user
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_positions=right,left,top,bottom,empty
result_dimensions=small,medium,big

Example 12 (plain)

Request

https://joturl.com/a/i1/jotbars/property?context=user&format=plain

Query parameters

context = user
 format = plain

Response

right,left,top,bottom,empty
small,medium,big

Required parameters

parameter	description
contextSTRING	it can be `url`, `project` or `user` and specifies the context for which positions and dimensions are requested

Return values

parameter	description
dimensions	comma separated list of dimensions for the context, available dimensions: big, inherit, medium, small
positions	comma separated list of positions for context, available positions: bottom, empty, inherit, left, right, top

/locations

/locations/list

access: [READ]

This method returns a list of available locations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/locations/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "locations": [
      {
        "label": "Afghanistan (\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646)",
        "code": "AF"
      },
      {
        "label": "Aland Islands",
        "code": "AX"
      },
      {
        "label": "Albania (Shqipëria)",
        "code": "AL"
      },
      {
        "label": "Algeria (\u0627\u0644\u062c\u0632\u0627\u0626\u0631)",
        "code": "DZ"
      },
      {
        "label": "American Samoa",
        "code": "AS"
      },
      {
        "label": "Andorra",
        "code": "AD"
      },
      {
        "label": "Angola",
        "code": "AO"
      },
      {
        "label": "Anguilla",
        "code": "AI"
      },
      {
        "label": "Antarctica",
        "code": "AQ"
      },
      {
        "label": "Antigua and Barbuda",
        "code": "AG"
      },
      {
        "label": "Argentina",
        "code": "AR"
      },
      {
        "label": "Armenia (\u0540\u0561\u0575\u0561\u057d\u057f\u0561\u0576)",
        "code": "AM"
      },
      {
        "label": "Aruba",
        "code": "AW"
      },
      {
        "label": "Australia",
        "code": "AU"
      },
      {
        "label": "Austria (Österreich)",
        "code": "AT"
      },
      {
        "label": "Azerbaijan (Az\u0259rbaycan)",
        "code": "AZ"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/locations/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <locations>
      <i0>
        <label>Afghanistan (افغانستان)</label>  
        <code>AF</code>  
      </i0>  
      <i1>
        <label>Aland Islands</label>  
        <code>AX</code>  
      </i1>  
      <i2>
        <label><[CDATA[Albania (Shqip&euml;ria)]]></label>  
        <code>AL</code>  
      </i2>  
      <i3>
        <label>Algeria (الجزائر)</label>  
        <code>DZ</code>  
      </i3>  
      <i4>
        <label>American Samoa</label>  
        <code>AS</code>  
      </i4>  
      <i5>
        <label>Andorra</label>  
        <code>AD</code>  
      </i5>  
      <i6>
        <label>Angola</label>  
        <code>AO</code>  
      </i6>  
      <i7>
        <label>Anguilla</label>  
        <code>AI</code>  
      </i7>  
      <i8>
        <label>Antarctica</label>  
        <code>AQ</code>  
      </i8>  
      <i9>
        <label>Antigua and Barbuda</label>  
        <code>AG</code>  
      </i9>  
      <i10>
        <label>Argentina</label>  
        <code>AR</code>  
      </i10>  
      <i11>
        <label>Armenia (Հայաստան)</label>  
        <code>AM</code>  
      </i11>  
      <i12>
        <label>Aruba</label>  
        <code>AW</code>  
      </i12>  
      <i13>
        <label>Australia</label>  
        <code>AU</code>  
      </i13>  
      <i14>
        <label><[CDATA[Austria (&Ouml;sterreich)]]></label>  
        <code>AT</code>  
      </i14>  
      <i15>
        <label>Azerbaijan (Azərbaycan)</label>  
        <code>AZ</code>  
      </i15>  
    </locations>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/locations/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_locations_0_label=Afghanistan (افغانستان)
result_locations_0_code=AF
result_locations_1_label=Aland Islands
result_locations_1_code=AX
result_locations_2_label=Albania (Shqip&euml;ria)
result_locations_2_code=AL
result_locations_3_label=Algeria (الجزائر)
result_locations_3_code=DZ
result_locations_4_label=American Samoa
result_locations_4_code=AS
result_locations_5_label=Andorra
result_locations_5_code=AD
result_locations_6_label=Angola
result_locations_6_code=AO
result_locations_7_label=Anguilla
result_locations_7_code=AI
result_locations_8_label=Antarctica
result_locations_8_code=AQ
result_locations_9_label=Antigua and Barbuda
result_locations_9_code=AG
result_locations_10_label=Argentina
result_locations_10_code=AR
result_locations_11_label=Armenia (Հայաստան)
result_locations_11_code=AM
result_locations_12_label=Aruba
result_locations_12_code=AW
result_locations_13_label=Australia
result_locations_13_code=AU
result_locations_14_label=Austria (&Ouml;sterreich)
result_locations_14_code=AT
result_locations_15_label=Azerbaijan (Azərbaycan)
result_locations_15_code=AZ

Example 4 (plain)

Request

https://joturl.com/a/i1/locations/list?format=plain

Query parameters

format = plain

Response

Afghanistan (افغانستان)
AF
Aland Islands
AX
Albania (Shqip&euml;ria)
AL
Algeria (الجزائر)
DZ
American Samoa
AS
Andorra
AD
Angola
AO
Anguilla
AI
Antarctica
AQ
Antigua and Barbuda
AG
Argentina
AR
Armenia (Հայաստան)
AM
Aruba
AW
Australia
AU
Austria (&Ouml;sterreich)
AT
Azerbaijan (Azərbaycan)
AZ

Return values

parameter	description
locations	list of available locations

/oauth

/oauth/access_token

access: [WRITE]

Get OAUTH 2.0 access token.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=3818f474c7a193c5d217f3b663a2b63b&client_secret=a6ee2a129e43b000e48249a9caa423ae&code=37e8afee7ac8668da5de496326c0b4b9

Query parameters

   grant_type = authorization_code
    client_id = 3818f474c7a193c5d217f3b663a2b63b
client_secret = a6ee2a129e43b000e48249a9caa423ae
         code = 37e8afee7ac8668da5de496326c0b4b9

Response

{
  "token_type": "bearer",
  "expires_in": 864000,
  "access_token": "582e57cd875d37bea1a3ce069685b9f9",
  "refresh_token": "7fff1b982c6e292f7fe1c5bb19a3babb"
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=3818f474c7a193c5d217f3b663a2b63b&client_secret=a6ee2a129e43b000e48249a9caa423ae&code=37e8afee7ac8668da5de496326c0b4b9&format=xml

Query parameters

   grant_type = authorization_code
    client_id = 3818f474c7a193c5d217f3b663a2b63b
client_secret = a6ee2a129e43b000e48249a9caa423ae
         code = 37e8afee7ac8668da5de496326c0b4b9
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <token_type>bearer</token_type>  
  <expires_in>864000</expires_in>  
  <access_token>582e57cd875d37bea1a3ce069685b9f9</access_token>  
  <refresh_token>7fff1b982c6e292f7fe1c5bb19a3babb</refresh_token>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=3818f474c7a193c5d217f3b663a2b63b&client_secret=a6ee2a129e43b000e48249a9caa423ae&code=37e8afee7ac8668da5de496326c0b4b9&format=txt

Query parameters

   grant_type = authorization_code
    client_id = 3818f474c7a193c5d217f3b663a2b63b
client_secret = a6ee2a129e43b000e48249a9caa423ae
         code = 37e8afee7ac8668da5de496326c0b4b9
       format = txt

Response

token_type=bearer
expires_in=864000
access_token=582e57cd875d37bea1a3ce069685b9f9
refresh_token=7fff1b982c6e292f7fe1c5bb19a3babb

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=3818f474c7a193c5d217f3b663a2b63b&client_secret=a6ee2a129e43b000e48249a9caa423ae&code=37e8afee7ac8668da5de496326c0b4b9&format=plain

Query parameters

   grant_type = authorization_code
    client_id = 3818f474c7a193c5d217f3b663a2b63b
client_secret = a6ee2a129e43b000e48249a9caa423ae
         code = 37e8afee7ac8668da5de496326c0b4b9
       format = plain

Response

bearer
864000
582e57cd875d37bea1a3ce069685b9f9
7fff1b982c6e292f7fe1c5bb19a3babb

Required parameters

parameter	description
client_idSTRING	is the public identifier for the app
client_secretSTRING	secret identifier for the app for `mode = secret` (see i1/oauth/authorize) or the nonce for `mode = secretless` (see i1/oauth/authorize)
grant_typeSTRING	requested authorization type, supported grand types: authorization_code, refresh_token

Optional parameters

parameter	description
codeSTRING	the code returned from the authorization flow, this parameter is mandatory if `grant_type = authorization_code`
refresh_tokenSTRING	refresh token returned by this method in the authorization flow, this parameter is mandatory if `grant_type = refresh_token`
std_errorsBOOLEAN	1 to return standard OAuth 2.0 errors, otherwise errors that respect this documentation will be returned (default: 0 for backward compatibility, this will be changed in the near future, so it is advisable to use `std_errors = 1`

Return values

parameter	description
access_token	the access token string as issued by the authorization flow
expires_in	the duration of time (in seconds) the access token is granted for
nonce	it is returned only if `mode = secretless` is passed in the request to i1/oauth/authorize and must be used to call all successive calls to JotUrl's APIs, its value is temporary and must be used within few minutes
refresh_token	the refresh token can be used to obtain another access token after the issued one has expired, this token is empty if `mode = secretless` is passed to i1/oauth/authorize
token_type	The type of token this is, it is just the string bearer

/oauth/authorize

access: [WRITE]

OAUTH 2.0 Authorization.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=77a1b838eddca924fd01c6a02461809a&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=31f546f8e2de459f4544b678a2ce8075

Query parameters

response_type = code
    client_id = 77a1b838eddca924fd01c6a02461809a
 redirect_uri = https://www.joturl.com/
        scope = rw
        state = 31f546f8e2de459f4544b678a2ce8075

Response

{
  "code": "9836f682ad08a533392c7b87c5140dca",
  "state": "31f546f8e2de459f4544b678a2ce8075",
  "mode": "secret"
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=77a1b838eddca924fd01c6a02461809a&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=31f546f8e2de459f4544b678a2ce8075&format=xml

Query parameters

response_type = code
    client_id = 77a1b838eddca924fd01c6a02461809a
 redirect_uri = https://www.joturl.com/
        scope = rw
        state = 31f546f8e2de459f4544b678a2ce8075
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <code>9836f682ad08a533392c7b87c5140dca</code>  
  <state>31f546f8e2de459f4544b678a2ce8075</state>  
  <mode>secret</mode>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=77a1b838eddca924fd01c6a02461809a&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=31f546f8e2de459f4544b678a2ce8075&format=txt

Query parameters

response_type = code
    client_id = 77a1b838eddca924fd01c6a02461809a
 redirect_uri = https://www.joturl.com/
        scope = rw
        state = 31f546f8e2de459f4544b678a2ce8075
       format = txt

Response

code=9836f682ad08a533392c7b87c5140dca
state=31f546f8e2de459f4544b678a2ce8075
mode=secret

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=77a1b838eddca924fd01c6a02461809a&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=31f546f8e2de459f4544b678a2ce8075&format=plain

Query parameters

response_type = code
    client_id = 77a1b838eddca924fd01c6a02461809a
 redirect_uri = https://www.joturl.com/
        scope = rw
        state = 31f546f8e2de459f4544b678a2ce8075
       format = plain

Response

9836f682ad08a533392c7b87c5140dca
31f546f8e2de459f4544b678a2ce8075
secret

Required parameters

parameter	description
client_idSTRING	is the public identifier for the app
redirect_uriSTRING	tells the authorization server where to send the user back to after they approve the request
response_typeSTRING	have be set to code, indicating that the application expects to receive an authorization code if successful.
scopeSTRING	one or more space-separated strings indicating which permissions the application is requesting, supported scopes are: rw = read/write access
stateSTRING	this parameter is used to prevent CSRF attacks

Optional parameters

parameter	description
modeSTRING	can be secret to use the OAuth 2.0 flow that requires server-to-server communications or secretless for the flow that does not require the client secret (default: secret)
std_errorsBOOLEAN	1 to return standard OAuth 2.0 errors, otherwise errors that respect this documentation will be returned (default: 0 for backward compatibility, this will be changed in the near future, so it is advisable to use `std_errors = 1`

Return values

parameter	description
[NODATA]	this method does not return any data but redirects to the OAuth 2.0 server to complete the OAuth 2.0 flow

OAuth 2.0 for secret flows requires these steps:

open a browser and send the user to i1/oauth/authorize
the user sees the authorization prompt and approves the app’s request, the server checks the authentication by using i1/oauth/check which returns the parameters needed in next step
the user is redirected back to the application with an authorization code in the query string
the application exchanges the authorization code for an access token by using i1/oauth/access_token

OAuth 2.0 for secretless flows requires these steps:

open a browser and send the user to i1/oauth/authorize
the user sees the authorization prompt and approves the app’s request, the server checks the authentication by using i1/oauth/check which returns the parameters needed in next step
the user is asked to copy a security nonce and is redirected back to the application with an authorization code in the query string
the application exchanges the authorization code for an access token by using i1/oauth/access_token, in this case the nonce is temporary and must be used within few minutes

/oauth/check

access: [WRITE]

Checks if an OAuth 2.0 Authorization was requested.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/check

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "a6a345c411c9cbff3c64f6200414f021",
    "app_name": "OAuth 2.0 App Name",
    "app_logo": "https:\/\/www.joturl.com\/reserved\/res\/ju2.0\/img\/header\/logo.svg",
    "redirect_url": "https:\/\/redirect.to\/?code=2241bc6347e593e23ff0ab90915b6de0&state=8c343b58ba21936dd05a5c3e8dee63f9&mode=secret"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/check?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>a6a345c411c9cbff3c64f6200414f021</id>  
    <app_name>OAuth 2.0 App Name</app_name>  
    <app_logo>https://www.joturl.com/reserved/res/ju2.0/img/header/logo.svg</app_logo>  
    <redirect_url><[CDATA[https://redirect.to/?code=2241bc6347e593e23ff0ab90915b6de0&amp;state=8c343b58ba21936dd05a5c3e8dee63f9&amp;mode=secret]]></redirect_url>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/check?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=a6a345c411c9cbff3c64f6200414f021
result_app_name=OAuth 2.0 App Name
result_app_logo=https://www.joturl.com/reserved/res/ju2.0/img/header/logo.svg
result_redirect_url=https://redirect.to/?code=2241bc6347e593e23ff0ab90915b6de0&amp;state=8c343b58ba21936dd05a5c3e8dee63f9&amp;mode=secret

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/check?format=plain

Query parameters

format = plain

Response

a6a345c411c9cbff3c64f6200414f021
OAuth 2.0 App Name
https://www.joturl.com/reserved/res/ju2.0/img/header/logo.svg
https://redirect.to/?code=2241bc6347e593e23ff0ab90915b6de0&amp;state=8c343b58ba21936dd05a5c3e8dee63f9&amp;mode=secret

Return values

parameter	description
app_logo	the URL to the logo of the application, empty if no authorization request has been made
app_name	the name of the OAuth 2.0 application, empty if no authorization request has been made
id	the ID of the OAuth 2.0 application, empty if no authorization request has been made
nonce	[OPTIONAL] it is returned only if `mode = secretless` is passed in the request to i1/oauth/authorize
redirect_url	it has the same value passed in the request to i1/oauth/authorize with parameters code, state and mode appended, empty if no authorization request has been made

/oauth/granted

/oauth/granted/count

access: [READ]

This method returns the number of granted OAuth 2.0 clients.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/granted/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/granted/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/granted/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/granted/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	count OAuth 2.0 clients by searching them

Return values

parameter	description
count	number of OAuth 2.0 clients the user has granted access to (filtered by search if passed)

/oauth/granted/list

access: [READ]

This method returns a list of granted OAuth 2.0 clients.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/granted/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "app_name": "OAuth 2.0 Client Name",
        "app_logo": "https:\/\/oauth.client\/logo.png"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/granted/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <app_name>OAuth 2.0 Client Name</app_name>  
        <app_logo>https://oauth.client/logo.png</app_logo>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/granted/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_app_name=OAuth 2.0 Client Name
result_data_0_app_logo=https://oauth.client/logo.png

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/granted/list?format=plain

Query parameters

format = plain

Response

OAuth 2.0 Client Name
https://oauth.client/logo.png

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	total number of OAuth 2.0 clients
data	array containing required information on clients the user has granted access to

/oauth/granted/revoke

access: [WRITE]

Revoke granted access to OAuth 2.0 clients.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d

Query parameters

ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d&format=xml

Query parameters

   ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d&format=txt

Query parameters

   ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d&format=plain

Query parameters

   ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b

Query parameters

ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b&format=xml

Query parameters

   ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b&format=txt

Query parameters

   ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b&format=plain

Query parameters

   ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
format = plain

Response

1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of OAuth 2.0 client IDs to be revoked

Return values

parameter	description
deleted	number of revoked OAuth 2.0 clients
ids	[OPTIONAL] list of OAuth 2.0 client IDs whose revoke has failed, this parameter is returned only when at least one revoke error has occurred

/oauth/test

access: [WRITE]

Call this endpoint to test OAuth 2.0 authentication credentials.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/oauth/test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "success": "1"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/oauth/test?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <success>1</success>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/oauth/test?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_success=1

Example 4 (plain)

Request

https://joturl.com/a/i1/oauth/test?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
std_errorsBOOLEAN	1 to return standard OAuth 2.0 errors, otherwise errors that respect this documentation will be returned (default: 0 for backward compatibility, this will be changed in the near future, so it is advisable to use `std_errors = 1`

Return values

parameter	description
success	1 on success, otherwise an authentication error is returned

/permissions

/permissions/add

access: [WRITE]

Define a new permission.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c410ab3b1683b9d8c850cc26318edca4%22,%22bbf28c72ca04a9b3166fc978af694b09%22,%22635f51a7bec809dfded3dfd4f4aa3788%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D

Query parameters

name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c410ab3b1683b9d8c850cc26318edca4","bbf28c72ca04a9b3166fc978af694b09","635f51a7bec809dfded3dfd4f4aa3788"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1ace7b92c8866a07c8a286aad3de8ce0",
    "name": "name of the permission",
    "notes": "",
    "info": {
      "apis": {
        "access_to": {
          "all_except": []
        }
      },
      "conversions": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "can_link": 1,
        "can_unlink": 1,
        "access_to": {
          "all_except": []
        }
      },
      "ctas": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "can_link": 1,
        "can_unlink": 1,
        "access_to": {
          "all_except": []
        }
      },
      "domains": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "access_to": {
          "all_except": []
        },
        "all_except": [
          {
            "id": "c410ab3b1683b9d8c850cc26318edca4",
            "name": "domain_0"
          },
          {
            "id": "bbf28c72ca04a9b3166fc978af694b09",
            "name": "domain_1"
          },
          {
            "id": "635f51a7bec809dfded3dfd4f4aa3788",
            "name": "domain_2"
          }
        ]
      },
      "plans": {
        "can_manage_plans": 0,
        "can_manage_billing": 0
      },
      "projects": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "access_to_default": 1
      },
      "remarketings": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "can_link": 1,
        "can_unlink": 1,
        "access_to": {
          "all_except": []
        }
      },
      "security": {
        "inactivity_timeout": 0,
        "inactivity_timeout_value": 15,
        "force_change_password": 0,
        "force_change_password_interval": 3,
        "do_not_allow_old_passwords": 0,
        "do_not_allow_old_passwords_value": 4,
        "disable_inactive_account": 0,
        "disable_inactive_account_value": 6,
        "warning_on_anomalous_logins": 0
      },
      "subusers": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c410ab3b1683b9d8c850cc26318edca4%22,%22bbf28c72ca04a9b3166fc978af694b09%22,%22635f51a7bec809dfded3dfd4f4aa3788%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=xml

Query parameters

  name = name of the permission
  info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c410ab3b1683b9d8c850cc26318edca4","bbf28c72ca04a9b3166fc978af694b09","635f51a7bec809dfded3dfd4f4aa3788"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1ace7b92c8866a07c8a286aad3de8ce0</id>  
    <name>name of the permission</name>  
    <notes></notes>  
    <info>
      <apis>
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </apis>  
      <conversions>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <can_link>1</can_link>  
        <can_unlink>1</can_unlink>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </conversions>  
      <ctas>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <can_link>1</can_link>  
        <can_unlink>1</can_unlink>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </ctas>  
      <domains>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
        <all_except>
          <i0>
            <id>c410ab3b1683b9d8c850cc26318edca4</id>  
            <name>domain_0</name>  
          </i0>  
          <i1>
            <id>bbf28c72ca04a9b3166fc978af694b09</id>  
            <name>domain_1</name>  
          </i1>  
          <i2>
            <id>635f51a7bec809dfded3dfd4f4aa3788</id>  
            <name>domain_2</name>  
          </i2>  
        </all_except>  
      </domains>  
      <plans>
        <can_manage_plans>0</can_manage_plans>  
        <can_manage_billing>0</can_manage_billing>  
      </plans>  
      <projects>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <access_to_default>1</access_to_default>  
      </projects>  
      <remarketings>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <can_link>1</can_link>  
        <can_unlink>1</can_unlink>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </remarketings>  
      <security>
        <inactivity_timeout>0</inactivity_timeout>  
        <inactivity_timeout_value>15</inactivity_timeout_value>  
        <force_change_password>0</force_change_password>  
        <force_change_password_interval>3</force_change_password_interval>  
        <do_not_allow_old_passwords>0</do_not_allow_old_passwords>  
        <do_not_allow_old_passwords_value>4</do_not_allow_old_passwords_value>  
        <disable_inactive_account>0</disable_inactive_account>  
        <disable_inactive_account_value>6</disable_inactive_account_value>  
        <warning_on_anomalous_logins>0</warning_on_anomalous_logins>  
      </security>  
      <subusers>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
      </subusers>  
    </info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c410ab3b1683b9d8c850cc26318edca4%22,%22bbf28c72ca04a9b3166fc978af694b09%22,%22635f51a7bec809dfded3dfd4f4aa3788%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=txt

Query parameters

  name = name of the permission
  info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c410ab3b1683b9d8c850cc26318edca4","bbf28c72ca04a9b3166fc978af694b09","635f51a7bec809dfded3dfd4f4aa3788"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1ace7b92c8866a07c8a286aad3de8ce0
result_name=name of the permission
result_notes=
result_info_apis_access_to_all_except=
result_info_conversions_can_add=1
result_info_conversions_can_edit=1
result_info_conversions_can_delete=1
result_info_conversions_can_link=1
result_info_conversions_can_unlink=1
result_info_conversions_access_to_all_except=
result_info_ctas_can_add=1
result_info_ctas_can_edit=1
result_info_ctas_can_delete=1
result_info_ctas_can_link=1
result_info_ctas_can_unlink=1
result_info_ctas_access_to_all_except=
result_info_domains_can_add=1
result_info_domains_can_edit=1
result_info_domains_can_delete=1
result_info_domains_access_to_all_except=
result_info_domains_all_except_0_id=c410ab3b1683b9d8c850cc26318edca4
result_info_domains_all_except_0_name=domain_0
result_info_domains_all_except_1_id=bbf28c72ca04a9b3166fc978af694b09
result_info_domains_all_except_1_name=domain_1
result_info_domains_all_except_2_id=635f51a7bec809dfded3dfd4f4aa3788
result_info_domains_all_except_2_name=domain_2
result_info_plans_can_manage_plans=0
result_info_plans_can_manage_billing=0
result_info_projects_can_add=1
result_info_projects_can_edit=1
result_info_projects_can_delete=1
result_info_projects_access_to_default=1
result_info_remarketings_can_add=1
result_info_remarketings_can_edit=1
result_info_remarketings_can_delete=1
result_info_remarketings_can_link=1
result_info_remarketings_can_unlink=1
result_info_remarketings_access_to_all_except=
result_info_security_inactivity_timeout=0
result_info_security_inactivity_timeout_value=15
result_info_security_force_change_password=0
result_info_security_force_change_password_interval=3
result_info_security_do_not_allow_old_passwords=0
result_info_security_do_not_allow_old_passwords_value=4
result_info_security_disable_inactive_account=0
result_info_security_disable_inactive_account_value=6
result_info_security_warning_on_anomalous_logins=0
result_info_subusers_can_add=1
result_info_subusers_can_edit=1
result_info_subusers_can_delete=1

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c410ab3b1683b9d8c850cc26318edca4%22,%22bbf28c72ca04a9b3166fc978af694b09%22,%22635f51a7bec809dfded3dfd4f4aa3788%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=plain

Query parameters

  name = name of the permission
  info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c410ab3b1683b9d8c850cc26318edca4","bbf28c72ca04a9b3166fc978af694b09","635f51a7bec809dfded3dfd4f4aa3788"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = plain

Response

1ace7b92c8866a07c8a286aad3de8ce0
name of the permission


1
1
1
1
1

1
1
1
1
1

1
1
1

c410ab3b1683b9d8c850cc26318edca4
domain_0
bbf28c72ca04a9b3166fc978af694b09
domain_1
635f51a7bec809dfded3dfd4f4aa3788
domain_2
0
0
1
1
1
1
1
1
1
1
1

0
15
0
3
0
4
0
6
0
1
1
1

Required parameters

parameter	description	max length
nameSTRING	name of the permission	100

Optional parameters

parameter	description	max length
infoJSON	information on access rights, see i1/permissions/property for details
notesSTRING	notes for the permission	255

Return values

parameter	description
id	ID of the permission
info	information on access rights
name	echo back of the input parameter name
notes	echo back of the input parameter notes

/permissions/count

access: [READ]

This method returns the number of user's permissions.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 703
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>703</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=703

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/permissions/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 133
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/permissions/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>133</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/permissions/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=133

Example 8 (plain)

Request

https://joturl.com/a/i1/permissions/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	count permissions by searching them

Return values

parameter	description
count	number of permissions (filtered by search if passed)

/permissions/delete

access: [WRITE]

Delete one or more permissions.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1

Query parameters

ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1&format=xml

Query parameters

   ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1&format=txt

Query parameters

   ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1&format=plain

Query parameters

   ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898

Query parameters

ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898&format=xml

Query parameters

   ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898&format=txt

Query parameters

   ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898&format=plain

Query parameters

   ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
format = plain

Response

3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of permission IDs to be deleted

Return values

parameter	description
deleted	number of deleted permissions
ids	[OPTIONAL] list of permission IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/permissions/edit

access: [WRITE]

Edit a permission.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/edit?id=f9e1a4ed44f42c9239b6e68f59887b10&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%225884622c0197389556d262e19057a8c8%22,%224bf2a1f40af8a28118097f04dc58fe67%22,%228f3010ecb5ae22b282a16f12f2019d66%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D

Query parameters

  id = f9e1a4ed44f42c9239b6e68f59887b10
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["5884622c0197389556d262e19057a8c8","4bf2a1f40af8a28118097f04dc58fe67","8f3010ecb5ae22b282a16f12f2019d66"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "f9e1a4ed44f42c9239b6e68f59887b10",
    "info": {
      "apis": {
        "access_to": {
          "all_except": []
        }
      },
      "conversions": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "can_link": 1,
        "can_unlink": 1,
        "access_to": {
          "all_except": []
        }
      },
      "ctas": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "can_link": 1,
        "can_unlink": 1,
        "access_to": {
          "all_except": []
        }
      },
      "domains": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "access_to": {
          "all_except": []
        },
        "all_except": [
          {
            "id": "5884622c0197389556d262e19057a8c8",
            "name": "domain_0"
          },
          {
            "id": "4bf2a1f40af8a28118097f04dc58fe67",
            "name": "domain_1"
          },
          {
            "id": "8f3010ecb5ae22b282a16f12f2019d66",
            "name": "domain_2"
          }
        ]
      },
      "plans": {
        "can_manage_plans": 0,
        "can_manage_billing": 0
      },
      "projects": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "access_to_default": 1
      },
      "remarketings": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1,
        "can_link": 1,
        "can_unlink": 1,
        "access_to": {
          "all_except": []
        }
      },
      "security": {
        "inactivity_timeout": 0,
        "inactivity_timeout_value": 15,
        "force_change_password": 0,
        "force_change_password_interval": 3,
        "do_not_allow_old_passwords": 0,
        "do_not_allow_old_passwords_value": 4,
        "disable_inactive_account": 0,
        "disable_inactive_account_value": 6,
        "warning_on_anomalous_logins": 0
      },
      "subusers": {
        "can_add": 1,
        "can_edit": 1,
        "can_delete": 1
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/edit?id=f9e1a4ed44f42c9239b6e68f59887b10&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%225884622c0197389556d262e19057a8c8%22,%224bf2a1f40af8a28118097f04dc58fe67%22,%228f3010ecb5ae22b282a16f12f2019d66%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=xml

Query parameters

    id = f9e1a4ed44f42c9239b6e68f59887b10
  name = name of the permission
  info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["5884622c0197389556d262e19057a8c8","4bf2a1f40af8a28118097f04dc58fe67","8f3010ecb5ae22b282a16f12f2019d66"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>f9e1a4ed44f42c9239b6e68f59887b10</id>  
    <info>
      <apis>
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </apis>  
      <conversions>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <can_link>1</can_link>  
        <can_unlink>1</can_unlink>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </conversions>  
      <ctas>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <can_link>1</can_link>  
        <can_unlink>1</can_unlink>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </ctas>  
      <domains>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
        <all_except>
          <i0>
            <id>5884622c0197389556d262e19057a8c8</id>  
            <name>domain_0</name>  
          </i0>  
          <i1>
            <id>4bf2a1f40af8a28118097f04dc58fe67</id>  
            <name>domain_1</name>  
          </i1>  
          <i2>
            <id>8f3010ecb5ae22b282a16f12f2019d66</id>  
            <name>domain_2</name>  
          </i2>  
        </all_except>  
      </domains>  
      <plans>
        <can_manage_plans>0</can_manage_plans>  
        <can_manage_billing>0</can_manage_billing>  
      </plans>  
      <projects>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <access_to_default>1</access_to_default>  
      </projects>  
      <remarketings>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
        <can_link>1</can_link>  
        <can_unlink>1</can_unlink>  
        <access_to>
          <all_except>

          </all_except>  
        </access_to>  
      </remarketings>  
      <security>
        <inactivity_timeout>0</inactivity_timeout>  
        <inactivity_timeout_value>15</inactivity_timeout_value>  
        <force_change_password>0</force_change_password>  
        <force_change_password_interval>3</force_change_password_interval>  
        <do_not_allow_old_passwords>0</do_not_allow_old_passwords>  
        <do_not_allow_old_passwords_value>4</do_not_allow_old_passwords_value>  
        <disable_inactive_account>0</disable_inactive_account>  
        <disable_inactive_account_value>6</disable_inactive_account_value>  
        <warning_on_anomalous_logins>0</warning_on_anomalous_logins>  
      </security>  
      <subusers>
        <can_add>1</can_add>  
        <can_edit>1</can_edit>  
        <can_delete>1</can_delete>  
      </subusers>  
    </info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/edit?id=f9e1a4ed44f42c9239b6e68f59887b10&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%225884622c0197389556d262e19057a8c8%22,%224bf2a1f40af8a28118097f04dc58fe67%22,%228f3010ecb5ae22b282a16f12f2019d66%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=txt

Query parameters

    id = f9e1a4ed44f42c9239b6e68f59887b10
  name = name of the permission
  info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["5884622c0197389556d262e19057a8c8","4bf2a1f40af8a28118097f04dc58fe67","8f3010ecb5ae22b282a16f12f2019d66"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=f9e1a4ed44f42c9239b6e68f59887b10
result_info_apis_access_to_all_except=
result_info_conversions_can_add=1
result_info_conversions_can_edit=1
result_info_conversions_can_delete=1
result_info_conversions_can_link=1
result_info_conversions_can_unlink=1
result_info_conversions_access_to_all_except=
result_info_ctas_can_add=1
result_info_ctas_can_edit=1
result_info_ctas_can_delete=1
result_info_ctas_can_link=1
result_info_ctas_can_unlink=1
result_info_ctas_access_to_all_except=
result_info_domains_can_add=1
result_info_domains_can_edit=1
result_info_domains_can_delete=1
result_info_domains_access_to_all_except=
result_info_domains_all_except_0_id=5884622c0197389556d262e19057a8c8
result_info_domains_all_except_0_name=domain_0
result_info_domains_all_except_1_id=4bf2a1f40af8a28118097f04dc58fe67
result_info_domains_all_except_1_name=domain_1
result_info_domains_all_except_2_id=8f3010ecb5ae22b282a16f12f2019d66
result_info_domains_all_except_2_name=domain_2
result_info_plans_can_manage_plans=0
result_info_plans_can_manage_billing=0
result_info_projects_can_add=1
result_info_projects_can_edit=1
result_info_projects_can_delete=1
result_info_projects_access_to_default=1
result_info_remarketings_can_add=1
result_info_remarketings_can_edit=1
result_info_remarketings_can_delete=1
result_info_remarketings_can_link=1
result_info_remarketings_can_unlink=1
result_info_remarketings_access_to_all_except=
result_info_security_inactivity_timeout=0
result_info_security_inactivity_timeout_value=15
result_info_security_force_change_password=0
result_info_security_force_change_password_interval=3
result_info_security_do_not_allow_old_passwords=0
result_info_security_do_not_allow_old_passwords_value=4
result_info_security_disable_inactive_account=0
result_info_security_disable_inactive_account_value=6
result_info_security_warning_on_anomalous_logins=0
result_info_subusers_can_add=1
result_info_subusers_can_edit=1
result_info_subusers_can_delete=1

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/edit?id=f9e1a4ed44f42c9239b6e68f59887b10&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%225884622c0197389556d262e19057a8c8%22,%224bf2a1f40af8a28118097f04dc58fe67%22,%228f3010ecb5ae22b282a16f12f2019d66%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=plain

Query parameters

    id = f9e1a4ed44f42c9239b6e68f59887b10
  name = name of the permission
  info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["5884622c0197389556d262e19057a8c8","4bf2a1f40af8a28118097f04dc58fe67","8f3010ecb5ae22b282a16f12f2019d66"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = plain

Response

f9e1a4ed44f42c9239b6e68f59887b10

1
1
1
1
1

1
1
1
1
1

1
1
1

5884622c0197389556d262e19057a8c8
domain_0
4bf2a1f40af8a28118097f04dc58fe67
domain_1
8f3010ecb5ae22b282a16f12f2019d66
domain_2
0
0
1
1
1
1
1
1
1
1
1

0
15
0
3
0
4
0
6
0
1
1
1

Required parameters

parameter	description
idID	ID of the permission

Optional parameters

parameter	description	max length
infoJSON	information on access rights, see i1/permissions/property for details
nameSTRING	name of the permission	100
notesSTRING	notes of the permission	255

Return values

parameter	description
id	ID of the permission
info	information on access rights
name	name of the permission
notes	notes of the permission

/permissions/info

access: [READ]

This method returns information on a permission.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/info?id=b69127251cf37657d35f7b2e92fbac2e

Query parameters

id = b69127251cf37657d35f7b2e92fbac2e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "id": "b69127251cf37657d35f7b2e92fbac2e",
      "name": "name of the permission",
      "notes": "notes for the permission",
      "info": {
        "apis": {
          "access_to": {
            "all_except": []
          }
        },
        "conversions": {
          "can_add": 1,
          "can_edit": 1,
          "can_delete": 1,
          "can_link": 1,
          "can_unlink": 1,
          "access_to": {
            "all_except": []
          }
        },
        "ctas": {
          "can_add": 1,
          "can_edit": 1,
          "can_delete": 1,
          "can_link": 1,
          "can_unlink": 1,
          "access_to": {
            "all_except": []
          }
        },
        "domains": {
          "can_add": 1,
          "can_edit": 1,
          "can_delete": 1,
          "access_to": {
            "all_except": []
          },
          "all_except": [
            {
              "id": "a5d394fa1f35e9316dd3f57adf4e991c",
              "name": "domain_0"
            },
            {
              "id": "a1d26f634f3b85637968f6f676d0c3fb",
              "name": "domain_1"
            },
            {
              "id": "57eb7c5440f711c38f39d20b9852fc66",
              "name": "domain_2"
            },
            {
              "id": "7639439c071240b3b9a375c86209cc55",
              "name": "domain_3"
            }
          ]
        },
        "plans": {
          "can_manage_plans": 0,
          "can_manage_billing": 0
        },
        "projects": {
          "can_add": 1,
          "can_edit": 1,
          "can_delete": 1,
          "access_to_default": 1
        },
        "remarketings": {
          "can_add": 1,
          "can_edit": 1,
          "can_delete": 1,
          "can_link": 1,
          "can_unlink": 1,
          "access_to": {
            "all_except": []
          }
        },
        "security": {
          "inactivity_timeout": 0,
          "inactivity_timeout_value": 15,
          "force_change_password": 0,
          "force_change_password_interval": 3,
          "do_not_allow_old_passwords": 0,
          "do_not_allow_old_passwords_value": 4,
          "disable_inactive_account": 0,
          "disable_inactive_account_value": 6,
          "warning_on_anomalous_logins": 0
        },
        "subusers": {
          "can_add": 1,
          "can_edit": 1,
          "can_delete": 1
        }
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/info?id=b69127251cf37657d35f7b2e92fbac2e&format=xml

Query parameters

    id = b69127251cf37657d35f7b2e92fbac2e
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <id>b69127251cf37657d35f7b2e92fbac2e</id>  
      <name>name of the permission</name>  
      <notes>notes for the permission</notes>  
      <info>
        <apis>
          <access_to>
            <all_except>

            </all_except>  
          </access_to>  
        </apis>  
        <conversions>
          <can_add>1</can_add>  
          <can_edit>1</can_edit>  
          <can_delete>1</can_delete>  
          <can_link>1</can_link>  
          <can_unlink>1</can_unlink>  
          <access_to>
            <all_except>

            </all_except>  
          </access_to>  
        </conversions>  
        <ctas>
          <can_add>1</can_add>  
          <can_edit>1</can_edit>  
          <can_delete>1</can_delete>  
          <can_link>1</can_link>  
          <can_unlink>1</can_unlink>  
          <access_to>
            <all_except>

            </all_except>  
          </access_to>  
        </ctas>  
        <domains>
          <can_add>1</can_add>  
          <can_edit>1</can_edit>  
          <can_delete>1</can_delete>  
          <access_to>
            <all_except>

            </all_except>  
          </access_to>  
          <all_except>
            <i0>
              <id>a5d394fa1f35e9316dd3f57adf4e991c</id>  
              <name>domain_0</name>  
            </i0>  
            <i1>
              <id>a1d26f634f3b85637968f6f676d0c3fb</id>  
              <name>domain_1</name>  
            </i1>  
            <i2>
              <id>57eb7c5440f711c38f39d20b9852fc66</id>  
              <name>domain_2</name>  
            </i2>  
            <i3>
              <id>7639439c071240b3b9a375c86209cc55</id>  
              <name>domain_3</name>  
            </i3>  
          </all_except>  
        </domains>  
        <plans>
          <can_manage_plans>0</can_manage_plans>  
          <can_manage_billing>0</can_manage_billing>  
        </plans>  
        <projects>
          <can_add>1</can_add>  
          <can_edit>1</can_edit>  
          <can_delete>1</can_delete>  
          <access_to_default>1</access_to_default>  
        </projects>  
        <remarketings>
          <can_add>1</can_add>  
          <can_edit>1</can_edit>  
          <can_delete>1</can_delete>  
          <can_link>1</can_link>  
          <can_unlink>1</can_unlink>  
          <access_to>
            <all_except>

            </all_except>  
          </access_to>  
        </remarketings>  
        <security>
          <inactivity_timeout>0</inactivity_timeout>  
          <inactivity_timeout_value>15</inactivity_timeout_value>  
          <force_change_password>0</force_change_password>  
          <force_change_password_interval>3</force_change_password_interval>  
          <do_not_allow_old_passwords>0</do_not_allow_old_passwords>  
          <do_not_allow_old_passwords_value>4</do_not_allow_old_passwords_value>  
          <disable_inactive_account>0</disable_inactive_account>  
          <disable_inactive_account_value>6</disable_inactive_account_value>  
          <warning_on_anomalous_logins>0</warning_on_anomalous_logins>  
        </security>  
        <subusers>
          <can_add>1</can_add>  
          <can_edit>1</can_edit>  
          <can_delete>1</can_delete>  
        </subusers>  
      </info>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/info?id=b69127251cf37657d35f7b2e92fbac2e&format=txt

Query parameters

    id = b69127251cf37657d35f7b2e92fbac2e
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=b69127251cf37657d35f7b2e92fbac2e
result_data_name=name of the permission
result_data_notes=notes for the permission
result_data_info_apis_access_to_all_except=
result_data_info_conversions_can_add=1
result_data_info_conversions_can_edit=1
result_data_info_conversions_can_delete=1
result_data_info_conversions_can_link=1
result_data_info_conversions_can_unlink=1
result_data_info_conversions_access_to_all_except=
result_data_info_ctas_can_add=1
result_data_info_ctas_can_edit=1
result_data_info_ctas_can_delete=1
result_data_info_ctas_can_link=1
result_data_info_ctas_can_unlink=1
result_data_info_ctas_access_to_all_except=
result_data_info_domains_can_add=1
result_data_info_domains_can_edit=1
result_data_info_domains_can_delete=1
result_data_info_domains_access_to_all_except=
result_data_info_domains_all_except_0_id=a5d394fa1f35e9316dd3f57adf4e991c
result_data_info_domains_all_except_0_name=domain_0
result_data_info_domains_all_except_1_id=a1d26f634f3b85637968f6f676d0c3fb
result_data_info_domains_all_except_1_name=domain_1
result_data_info_domains_all_except_2_id=57eb7c5440f711c38f39d20b9852fc66
result_data_info_domains_all_except_2_name=domain_2
result_data_info_domains_all_except_3_id=7639439c071240b3b9a375c86209cc55
result_data_info_domains_all_except_3_name=domain_3
result_data_info_plans_can_manage_plans=0
result_data_info_plans_can_manage_billing=0
result_data_info_projects_can_add=1
result_data_info_projects_can_edit=1
result_data_info_projects_can_delete=1
result_data_info_projects_access_to_default=1
result_data_info_remarketings_can_add=1
result_data_info_remarketings_can_edit=1
result_data_info_remarketings_can_delete=1
result_data_info_remarketings_can_link=1
result_data_info_remarketings_can_unlink=1
result_data_info_remarketings_access_to_all_except=
result_data_info_security_inactivity_timeout=0
result_data_info_security_inactivity_timeout_value=15
result_data_info_security_force_change_password=0
result_data_info_security_force_change_password_interval=3
result_data_info_security_do_not_allow_old_passwords=0
result_data_info_security_do_not_allow_old_passwords_value=4
result_data_info_security_disable_inactive_account=0
result_data_info_security_disable_inactive_account_value=6
result_data_info_security_warning_on_anomalous_logins=0
result_data_info_subusers_can_add=1
result_data_info_subusers_can_edit=1
result_data_info_subusers_can_delete=1

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/info?id=b69127251cf37657d35f7b2e92fbac2e&format=plain

Query parameters

    id = b69127251cf37657d35f7b2e92fbac2e
format = plain

Response

b69127251cf37657d35f7b2e92fbac2e
name of the permission
notes for the permission

1
1
1
1
1

1
1
1
1
1

1
1
1

a5d394fa1f35e9316dd3f57adf4e991c
domain_0
a1d26f634f3b85637968f6f676d0c3fb
domain_1
57eb7c5440f711c38f39d20b9852fc66
domain_2
7639439c071240b3b9a375c86209cc55
domain_3
0
0
1
1
1
1
1
1
1
1
1

0
15
0
3
0
4
0
6
0
1
1
1

Required parameters

parameter	description
idID	ID of the permission

Return values

parameter	description
data	array containing information on the permission, see i1/permissions/list and i1/permissions/property for details

/permissions/list

access: [READ]

This method returns a list of user-defined permissions.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "id": "f09e44a95b54d432bd509066b872e72a",
        "name": "name of the permission",
        "notes": "notes for the permission"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <id>f09e44a95b54d432bd509066b872e72a</id>  
        <name>name of the permission</name>  
        <notes>notes for the permission</notes>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=f09e44a95b54d432bd509066b872e72a
result_data_0_name=name of the permission
result_data_0_notes=notes for the permission

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/list?format=plain

Query parameters

format = plain

Response

1
f09e44a95b54d432bd509066b872e72a
name of the permission
notes for the permission

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	total number of permissions
data	array containing information on permissions

/permissions/property

access: [READ]

This method returns access rights you can use to create a permission. Each access right is grouped by contexts.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/permissions/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "apis": {
      "access_to": {
        "type": "complementary_ids",
        "default": {
          "all_except": []
        },
        "available": 1
      }
    },
    "conversions": {
      "can_add": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_edit": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_delete": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_link": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_unlink": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "access_to": {
        "type": "complementary_ids",
        "default": {
          "all_except": []
        },
        "available": 1
      }
    },
    "ctas": {
      "can_add": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_edit": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_delete": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_link": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_unlink": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "access_to": {
        "type": "complementary_ids",
        "default": {
          "all_except": []
        },
        "available": 1
      }
    },
    "domains": {
      "can_add": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_edit": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_delete": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "access_to": {
        "type": "complementary_ids",
        "default": {
          "all_except": []
        },
        "available": 1
      }
    },
    "plans": {
      "can_manage_plans": {
        "type": "bool",
        "default": 0,
        "available": 1
      },
      "can_manage_billing": {
        "type": "bool",
        "default": 0,
        "available": 1
      }
    },
    "projects": {
      "can_add": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_edit": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_delete": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "access_to_default": {
        "type": "bool",
        "default": 1,
        "available": 1
      }
    },
    "remarketings": {
      "can_add": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_edit": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_delete": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_link": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_unlink": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "access_to": {
        "type": "complementary_ids",
        "default": {
          "all_except": []
        },
        "available": 1
      }
    },
    "security": {
      "inactivity_timeout": {
        "ref_value": "inactivity_timeout_value",
        "type": "bool_with_value",
        "default": 0,
        "available": 1
      },
      "inactivity_timeout_value": {
        "type": "int",
        "default": 15,
        "min": 15,
        "max": 43200,
        "available": 1
      },
      "force_change_password": {
        "ref_value": "force_change_password_interval",
        "type": "bool_with_value",
        "default": 0,
        "available": 1
      },
      "force_change_password_interval": {
        "type": "int",
        "default": 3,
        "min": 2,
        "max": 60,
        "available": 1
      },
      "do_not_allow_old_passwords": {
        "ref_value": "do_not_allow_old_passwords_value",
        "type": "bool_with_value",
        "default": 0,
        "available": 1
      },
      "do_not_allow_old_passwords_value": {
        "type": "int",
        "default": 4,
        "min": 2,
        "max": 10,
        "available": 1
      },
      "disable_inactive_account": {
        "ref_value": "disable_inactive_account_value",
        "type": "bool_with_value",
        "default": 0,
        "available": 1
      },
      "disable_inactive_account_value": {
        "type": "int",
        "default": 6,
        "min": 2,
        "max": 36,
        "available": 1
      },
      "warning_on_anomalous_logins": {
        "type": "bool",
        "default": 0,
        "available": 1
      }
    },
    "subusers": {
      "can_add": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_edit": {
        "type": "bool",
        "default": 1,
        "available": 1
      },
      "can_delete": {
        "type": "bool",
        "default": 1,
        "available": 1
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/permissions/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <apis>
      <access_to>
        <type>complementary_ids</type>  
        <default>
          <all_except>

          </all_except>  
        </default>  
        <available>1</available>  
      </access_to>  
    </apis>  
    <conversions>
      <can_add>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_add>  
      <can_edit>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_edit>  
      <can_delete>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_delete>  
      <can_link>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_link>  
      <can_unlink>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_unlink>  
      <access_to>
        <type>complementary_ids</type>  
        <default>
          <all_except>

          </all_except>  
        </default>  
        <available>1</available>  
      </access_to>  
    </conversions>  
    <ctas>
      <can_add>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_add>  
      <can_edit>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_edit>  
      <can_delete>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_delete>  
      <can_link>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_link>  
      <can_unlink>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_unlink>  
      <access_to>
        <type>complementary_ids</type>  
        <default>
          <all_except>

          </all_except>  
        </default>  
        <available>1</available>  
      </access_to>  
    </ctas>  
    <domains>
      <can_add>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_add>  
      <can_edit>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_edit>  
      <can_delete>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_delete>  
      <access_to>
        <type>complementary_ids</type>  
        <default>
          <all_except>

          </all_except>  
        </default>  
        <available>1</available>  
      </access_to>  
    </domains>  
    <plans>
      <can_manage_plans>
        <type>bool</type>  
        <default>0</default>  
        <available>1</available>  
      </can_manage_plans>  
      <can_manage_billing>
        <type>bool</type>  
        <default>0</default>  
        <available>1</available>  
      </can_manage_billing>  
    </plans>  
    <projects>
      <can_add>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_add>  
      <can_edit>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_edit>  
      <can_delete>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_delete>  
      <access_to_default>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </access_to_default>  
    </projects>  
    <remarketings>
      <can_add>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_add>  
      <can_edit>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_edit>  
      <can_delete>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_delete>  
      <can_link>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_link>  
      <can_unlink>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_unlink>  
      <access_to>
        <type>complementary_ids</type>  
        <default>
          <all_except>

          </all_except>  
        </default>  
        <available>1</available>  
      </access_to>  
    </remarketings>  
    <security>
      <inactivity_timeout>
        <ref_value>inactivity_timeout_value</ref_value>  
        <type>bool_with_value</type>  
        <default>0</default>  
        <available>1</available>  
      </inactivity_timeout>  
      <inactivity_timeout_value>
        <type>int</type>  
        <default>15</default>  
        <min>15</min>  
        <max>43200</max>  
        <available>1</available>  
      </inactivity_timeout_value>  
      <force_change_password>
        <ref_value>force_change_password_interval</ref_value>  
        <type>bool_with_value</type>  
        <default>0</default>  
        <available>1</available>  
      </force_change_password>  
      <force_change_password_interval>
        <type>int</type>  
        <default>3</default>  
        <min>2</min>  
        <max>60</max>  
        <available>1</available>  
      </force_change_password_interval>  
      <do_not_allow_old_passwords>
        <ref_value>do_not_allow_old_passwords_value</ref_value>  
        <type>bool_with_value</type>  
        <default>0</default>  
        <available>1</available>  
      </do_not_allow_old_passwords>  
      <do_not_allow_old_passwords_value>
        <type>int</type>  
        <default>4</default>  
        <min>2</min>  
        <max>10</max>  
        <available>1</available>  
      </do_not_allow_old_passwords_value>  
      <disable_inactive_account>
        <ref_value>disable_inactive_account_value</ref_value>  
        <type>bool_with_value</type>  
        <default>0</default>  
        <available>1</available>  
      </disable_inactive_account>  
      <disable_inactive_account_value>
        <type>int</type>  
        <default>6</default>  
        <min>2</min>  
        <max>36</max>  
        <available>1</available>  
      </disable_inactive_account_value>  
      <warning_on_anomalous_logins>
        <type>bool</type>  
        <default>0</default>  
        <available>1</available>  
      </warning_on_anomalous_logins>  
    </security>  
    <subusers>
      <can_add>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_add>  
      <can_edit>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_edit>  
      <can_delete>
        <type>bool</type>  
        <default>1</default>  
        <available>1</available>  
      </can_delete>  
    </subusers>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/permissions/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_apis_access_to_type=complementary_ids
result_apis_access_to_default_all_except=
result_apis_access_to_available=1
result_conversions_can_add_type=bool
result_conversions_can_add_default=1
result_conversions_can_add_available=1
result_conversions_can_edit_type=bool
result_conversions_can_edit_default=1
result_conversions_can_edit_available=1
result_conversions_can_delete_type=bool
result_conversions_can_delete_default=1
result_conversions_can_delete_available=1
result_conversions_can_link_type=bool
result_conversions_can_link_default=1
result_conversions_can_link_available=1
result_conversions_can_unlink_type=bool
result_conversions_can_unlink_default=1
result_conversions_can_unlink_available=1
result_conversions_access_to_type=complementary_ids
result_conversions_access_to_default_all_except=
result_conversions_access_to_available=1
result_ctas_can_add_type=bool
result_ctas_can_add_default=1
result_ctas_can_add_available=1
result_ctas_can_edit_type=bool
result_ctas_can_edit_default=1
result_ctas_can_edit_available=1
result_ctas_can_delete_type=bool
result_ctas_can_delete_default=1
result_ctas_can_delete_available=1
result_ctas_can_link_type=bool
result_ctas_can_link_default=1
result_ctas_can_link_available=1
result_ctas_can_unlink_type=bool
result_ctas_can_unlink_default=1
result_ctas_can_unlink_available=1
result_ctas_access_to_type=complementary_ids
result_ctas_access_to_default_all_except=
result_ctas_access_to_available=1
result_domains_can_add_type=bool
result_domains_can_add_default=1
result_domains_can_add_available=1
result_domains_can_edit_type=bool
result_domains_can_edit_default=1
result_domains_can_edit_available=1
result_domains_can_delete_type=bool
result_domains_can_delete_default=1
result_domains_can_delete_available=1
result_domains_access_to_type=complementary_ids
result_domains_access_to_default_all_except=
result_domains_access_to_available=1
result_plans_can_manage_plans_type=bool
result_plans_can_manage_plans_default=0
result_plans_can_manage_plans_available=1
result_plans_can_manage_billing_type=bool
result_plans_can_manage_billing_default=0
result_plans_can_manage_billing_available=1
result_projects_can_add_type=bool
result_projects_can_add_default=1
result_projects_can_add_available=1
result_projects_can_edit_type=bool
result_projects_can_edit_default=1
result_projects_can_edit_available=1
result_projects_can_delete_type=bool
result_projects_can_delete_default=1
result_projects_can_delete_available=1
result_projects_access_to_default_type=bool
result_projects_access_to_default_default=1
result_projects_access_to_default_available=1
result_remarketings_can_add_type=bool
result_remarketings_can_add_default=1
result_remarketings_can_add_available=1
result_remarketings_can_edit_type=bool
result_remarketings_can_edit_default=1
result_remarketings_can_edit_available=1
result_remarketings_can_delete_type=bool
result_remarketings_can_delete_default=1
result_remarketings_can_delete_available=1
result_remarketings_can_link_type=bool
result_remarketings_can_link_default=1
result_remarketings_can_link_available=1
result_remarketings_can_unlink_type=bool
result_remarketings_can_unlink_default=1
result_remarketings_can_unlink_available=1
result_remarketings_access_to_type=complementary_ids
result_remarketings_access_to_default_all_except=
result_remarketings_access_to_available=1
result_security_inactivity_timeout_ref_value=inactivity_timeout_value
result_security_inactivity_timeout_type=bool_with_value
result_security_inactivity_timeout_default=0
result_security_inactivity_timeout_available=1
result_security_inactivity_timeout_value_type=int
result_security_inactivity_timeout_value_default=15
result_security_inactivity_timeout_value_min=15
result_security_inactivity_timeout_value_max=43200
result_security_inactivity_timeout_value_available=1
result_security_force_change_password_ref_value=force_change_password_interval
result_security_force_change_password_type=bool_with_value
result_security_force_change_password_default=0
result_security_force_change_password_available=1
result_security_force_change_password_interval_type=int
result_security_force_change_password_interval_default=3
result_security_force_change_password_interval_min=2
result_security_force_change_password_interval_max=60
result_security_force_change_password_interval_available=1
result_security_do_not_allow_old_passwords_ref_value=do_not_allow_old_passwords_value
result_security_do_not_allow_old_passwords_type=bool_with_value
result_security_do_not_allow_old_passwords_default=0
result_security_do_not_allow_old_passwords_available=1
result_security_do_not_allow_old_passwords_value_type=int
result_security_do_not_allow_old_passwords_value_default=4
result_security_do_not_allow_old_passwords_value_min=2
result_security_do_not_allow_old_passwords_value_max=10
result_security_do_not_allow_old_passwords_value_available=1
result_security_disable_inactive_account_ref_value=disable_inactive_account_value
result_security_disable_inactive_account_type=bool_with_value
result_security_disable_inactive_account_default=0
result_security_disable_inactive_account_available=1
result_security_disable_inactive_account_value_type=int
result_security_disable_inactive_account_value_default=6
result_security_disable_inactive_account_value_min=2
result_security_disable_inactive_account_value_max=36
result_security_disable_inactive_account_value_available=1
result_security_warning_on_anomalous_logins_type=bool
result_security_warning_on_anomalous_logins_default=0
result_security_warning_on_anomalous_logins_available=1
result_subusers_can_add_type=bool
result_subusers_can_add_default=1
result_subusers_can_add_available=1
result_subusers_can_edit_type=bool
result_subusers_can_edit_default=1
result_subusers_can_edit_available=1
result_subusers_can_delete_type=bool
result_subusers_can_delete_default=1
result_subusers_can_delete_available=1

Example 4 (plain)

Request

https://joturl.com/a/i1/permissions/property?format=plain

Query parameters

format = plain

Response

complementary_ids

1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids

1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids

1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids

1
bool
default:0
1
bool
default:0
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids

1
inactivity_timeout_value
bool_with_value
default:0
1
int
default:15
15
43200
1
force_change_password_interval
bool_with_value
default:0
1
int
default:3
2
60
1
do_not_allow_old_passwords_value
bool_with_value
default:0
1
int
default:4
2
10
1
disable_inactive_account_value
bool_with_value
default:0
1
int
default:6
2
36
1
bool
default:0
1
bool
default:1
1
bool
default:1
1
bool
default:1
1

Return values

parameter	description
data	object containing available access permissions and their descriptions

The data array is in the format context => info, where info contains:

type: type of access permission (see below for possible types)
default: default value for the permission
min: optional but can only be present if it is an int type, indicates the minimum possible value, if not specified the minimum value is 1
max: optional but can only be present if it is an int type, indicates the maximum possible value, if not specified the maximum value is 2147483647
available: 1 if the parameter is available for the user's current plan, 0 otherwise

Available types:

bool: boolean, possible values are 1 and 0
bool_with_value: boolean with associated value
int: positive integer (from 1 to 2147483647)
complementary_ids: complementary ID lists, it can contain 2 complementary lists: "all_except" and "none_except". In the "all_except" list, access is granted to all IDs except those in the list. In the "none_except" list, access is granted to all IDs except those in the list. Only one of the two lists can be defined. Each list can contain a maximum of 100 elements. WARNING: When the list is passed to a write endpoint (e.g., i1/permissions/edit, i1/permissions/add) it must contain only the IDs, while all returned lists contain an object (id, name).

Available contexts and parameters apis

Access rights for APIs.

parameter	type	description	default
access_to	complementary_ids	1 allows the user to access API access (all versions), 0 otherwise	`{"all_except":[]}`

conversions

Access rights for conversions.

parameter	type	description	default
can_add	bool	1 allows the user to add conversions, 0 otherwise	1
can_edit	bool	1 allows the user to edit conversions, 0 otherwise	1
can_delete	bool	1 allows the user to delete conversions, 0 otherwise	1
can_link	bool	1 allows the user to link conversion codes to tracking links, 0 otherwise	1
can_unlink	bool	1 allows the user to unlink conversion codes from tracking links, 0 otherwise	1
access_to	complementary_ids	list of conversion codes to which the user has access	`{"all_except":[]}`

ctas

Access rights for CTAs.

parameter	type	description	default
can_add	bool	1 allows the user to add CTAs, 0 otherwise	1
can_edit	bool	1 allows the user to edit CTAs, 0 otherwise	1
can_delete	bool	1 allows the user to delete CTAs, 0 otherwise	1
can_link	bool	1 allows the user to link CTAs to tracking links, 0 otherwise	1
can_unlink	bool	1 allows the user to unlink CTAs from tracking links, 0 otherwise	1
access_to	complementary_ids	list of CTAs to which the user has access	`{"all_except":[]}`

domains

Access rights for domains.

parameter	type	description	default
can_add	bool	1 allows the user to add domains, 0 otherwise	1
can_edit	bool	1 allows the user to edit domains, 0 otherwise	1
can_delete	bool	1 allows the user to delete domains, 0 otherwise	1
access_to	complementary_ids	list of domains to which the user has access	`{"all_except":[]}`

plans

Access rights for plans management.

parameter	type	description	default
can_manage_plans	bool	1 allows the user to change the current plan and subscription, 0 otherwise	0
can_manage_billing	bool	1 allows the user to change the billing information and download invoices, 0 otherwise	0

projects

Access rights for projects.

parameter	type	description	default
can_add	bool	1 allows the user to create projects, 0 otherwise	1
can_edit	bool	1 allows the user to edit projects, 0 otherwise	1
can_delete	bool	1 allows the user to delete projects, 0 otherwise	1
access_to_default	bool	1 allows the user to access the default project, 0 otherwise	1

remarketings

Access rights for remarketing pixels.

parameter	type	description	default
can_add	bool	1 allows the user to add pixels, 0 otherwise	1
can_edit	bool	1 allows the user to edit pixels, 0 otherwise	1
can_delete	bool	1 allows the user to delete pixels, 0 otherwise	1
can_link	bool	1 allows the user to link remarketing pixels to tracking links, 0 otherwise	1
can_unlink	bool	1 allows the user to unlink remarketing pixels from tracking links, 0 otherwise	1
access_to	complementary_ids	list of remarketing pixels to which the user has access	`{"all_except":[]}`

security

Access rights for advanced security.

parameter	type	description	default	min value	max value
inactivity_timeout	bool	1 enable automatic user logout for inactivity, 0 otherwise	0
inactivity_timeout_value	int	the time in minutes after which the user is disconnected in the absence of activity	15	15	43200
force_change_password	bool	1 if the user must change password at first login and every N months specified as specified in `force_change_password_interval`, 0 otherwise	0
force_change_password_interval	int	the time in months after which the user must change password	3	2	60
do_not_allow_old_passwords	bool	1 to prevent the use of the last N previous passwords as specified in `do_not_allow_old_passwords_value`, 0 otherwise	0
do_not_allow_old_passwords_value	int	number of previous passwords that the user cannot use when changing password	4	2	10
disable_inactive_account	bool	1 to deactivate inactive accounts, 0 otherwise	0
disable_inactive_account_value	int	the time in months after which an inactive user is disabled	6	2	36
warning_on_anomalous_logins	bool	1 to send an email in case of access from previously unused devices/IPs, 0 otherwise	0

subusers

Access rights for subusers.

parameter	type	description	default
can_add	bool	1 allows the user to add team members, 0 otherwise	1
can_edit	bool	1 allows the user to edit team members, 0 otherwise	1
can_delete	bool	1 allows the user to delete team members, 0 otherwise	1

/plans

/plans/addresses

/plans/addresses/add

access: [WRITE]

This method adds address information about the user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2026-05-26+14%3A00%3A32

Query parameters

         is_business = 1
                name = John Smith
             address = 72 Sussex St.
         postal_code = 21122
                city = Pasadena
        country_code = US
responsibility_check = 2026-05-26 14:00:32

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2026-05-26+14%3A00%3A32&format=xml

Query parameters

         is_business = 1
                name = John Smith
             address = 72 Sussex St.
         postal_code = 21122
                city = Pasadena
        country_code = US
responsibility_check = 2026-05-26 14:00:32
              format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2026-05-26+14%3A00%3A32&format=txt

Query parameters

         is_business = 1
                name = John Smith
             address = 72 Sussex St.
         postal_code = 21122
                city = Pasadena
        country_code = US
responsibility_check = 2026-05-26 14:00:32
              format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2026-05-26+14%3A00%3A32&format=plain

Query parameters

         is_business = 1
                name = John Smith
             address = 72 Sussex St.
         postal_code = 21122
                city = Pasadena
        country_code = US
responsibility_check = 2026-05-26 14:00:32
              format = plain

Response

Required parameters

parameter	description	max length
addressSTRING	billing address	255
citySTRING	billing city	255
country_codeSTRING	billing country code	2
is_businessBOOLEAN	1 for business accounts, 0 for private
nameSTRING	billing name	255
postal_codeSTRING	billing postal code	50
responsibility_checkDATE_TIME	date/time (UTC) in which the declaration of correctness of the address information was signed, the value passed is mandatory and must be a valid date/time, but it is always overwritten with the date/time of the call to this endpoint

Optional parameters

parameter	description	max length
cfSTRING	fiscal code for private Italian users	16
pecSTRING	certified email address for Italian users	255
provinceSTRING	province for Italian users, see i1/provinces/list for details	2
recipient_codeSTRING	recipient code for Italian users	15
vat_idSTRING	VAT ID for business users	50

Return values

parameter	description
added	1 on success, 0 otherwise

/plans/addresses/info

access: [READ]

This method returns address information about the user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/addresses/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "is_business": 1,
    "name": "John Smith",
    "address": "72 Sussex St.",
    "postal_code": "21122",
    "city": "Pasadena",
    "country_code": "US",
    "vat_treatment": "EXTRA_EU_BUSINESS",
    "vat_id": "",
    "cf": "",
    "pec": "",
    "recipient_code": "",
    "province": "",
    "responsibility_check": "2026-05-26 14:00:32"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/addresses/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <is_business>1</is_business>  
    <name>John Smith</name>  
    <address>72 Sussex St.</address>  
    <postal_code>21122</postal_code>  
    <city>Pasadena</city>  
    <country_code>US</country_code>  
    <vat_treatment>EXTRA_EU_BUSINESS</vat_treatment>  
    <vat_id></vat_id>  
    <cf></cf>  
    <pec></pec>  
    <recipient_code></recipient_code>  
    <province></province>  
    <responsibility_check>2026-05-26 14:00:32</responsibility_check>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/addresses/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_is_business=1
result_name=John Smith
result_address=72 Sussex St.
result_postal_code=21122
result_city=Pasadena
result_country_code=US
result_vat_treatment=EXTRA_EU_BUSINESS
result_vat_id=
result_cf=
result_pec=
result_recipient_code=
result_province=
result_responsibility_check=2026-05-26 14:00:32

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/addresses/info?format=plain

Query parameters

format = plain

Response

1
John Smith
72 Sussex St.
21122
Pasadena
US
EXTRA_EU_BUSINESS





2026-05-26 14:00:32

Return values

parameter	description
address	billing address
cf	fiscal code for private Italian users
city	billing city
country_code	billing country code
is_business	1 for business accounts, 0 for private
name	billing name
pec	certified email address for private Italian users
postal_code	billing postal code
province	province for private Italian users
recipient_code	recipient code for private Italian users
responsibility_check	date/time (UTC) when the declaration of correctness of the address information was signed
vat_id	VAT ID for business users
vat_treatment	NA

/plans/addresses/locations

/plans/addresses/locations/list

access: [READ]

This method returns a list of available countries/localities for the user's billing addresses.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/addresses/locations/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "locations": [
      {
        "label": "Afghanistan (\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646)",
        "code": "AF",
        "other": 0
      },
      {
        "label": "Aland Islands",
        "code": "AX",
        "other": 0
      },
      {
        "label": "Albania (Shqipëria)",
        "code": "AL",
        "other": 0
      },
      {
        "label": "Algeria (\u0627\u0644\u062c\u0632\u0627\u0626\u0631)",
        "code": "DZ",
        "other": 0
      },
      {
        "label": "American Samoa",
        "code": "AS",
        "other": 0
      },
      {
        "label": "Andorra",
        "code": "AD",
        "other": 0
      },
      {
        "label": "Angola",
        "code": "AO",
        "other": 0
      },
      {
        "label": "Anguilla",
        "code": "AI",
        "other": 0
      },
      {
        "label": "Antarctica",
        "code": "AQ",
        "other": 0
      },
      {
        "label": "Antigua and Barbuda",
        "code": "AG",
        "other": 0
      },
      {
        "label": "Argentina",
        "code": "AR",
        "other": 0
      },
      {
        "label": "Armenia (\u0540\u0561\u0575\u0561\u057d\u057f\u0561\u0576)",
        "code": "AM",
        "other": 0
      },
      {
        "label": "Aruba",
        "code": "AW",
        "other": 0
      },
      {
        "label": "Australia",
        "code": "AU",
        "other": 0
      },
      {
        "label": "Austria (Österreich)",
        "code": "AT",
        "other": 0
      },
      {
        "label": "Azerbaijan (Az\u0259rbaycan)",
        "code": "AZ",
        "other": 0
      },
      {
        "label": "[....]",
        "code": "..",
        "other": 0
      },
      {
        "label": "Canary Islands",
        "code": "_C",
        "other": 1
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/addresses/locations/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <locations>
      <i0>
        <label>Afghanistan (افغانستان)</label>  
        <code>AF</code>  
        <other>0</other>  
      </i0>  
      <i1>
        <label>Aland Islands</label>  
        <code>AX</code>  
        <other>0</other>  
      </i1>  
      <i2>
        <label><[CDATA[Albania (Shqip&euml;ria)]]></label>  
        <code>AL</code>  
        <other>0</other>  
      </i2>  
      <i3>
        <label>Algeria (الجزائر)</label>  
        <code>DZ</code>  
        <other>0</other>  
      </i3>  
      <i4>
        <label>American Samoa</label>  
        <code>AS</code>  
        <other>0</other>  
      </i4>  
      <i5>
        <label>Andorra</label>  
        <code>AD</code>  
        <other>0</other>  
      </i5>  
      <i6>
        <label>Angola</label>  
        <code>AO</code>  
        <other>0</other>  
      </i6>  
      <i7>
        <label>Anguilla</label>  
        <code>AI</code>  
        <other>0</other>  
      </i7>  
      <i8>
        <label>Antarctica</label>  
        <code>AQ</code>  
        <other>0</other>  
      </i8>  
      <i9>
        <label>Antigua and Barbuda</label>  
        <code>AG</code>  
        <other>0</other>  
      </i9>  
      <i10>
        <label>Argentina</label>  
        <code>AR</code>  
        <other>0</other>  
      </i10>  
      <i11>
        <label>Armenia (Հայաստան)</label>  
        <code>AM</code>  
        <other>0</other>  
      </i11>  
      <i12>
        <label>Aruba</label>  
        <code>AW</code>  
        <other>0</other>  
      </i12>  
      <i13>
        <label>Australia</label>  
        <code>AU</code>  
        <other>0</other>  
      </i13>  
      <i14>
        <label><[CDATA[Austria (&Ouml;sterreich)]]></label>  
        <code>AT</code>  
        <other>0</other>  
      </i14>  
      <i15>
        <label>Azerbaijan (Azərbaycan)</label>  
        <code>AZ</code>  
        <other>0</other>  
      </i15>  
      <i16>
        <label>[....]</label>  
        <code>..</code>  
        <other>0</other>  
      </i16>  
      <i17>
        <label>Canary Islands</label>  
        <code>_C</code>  
        <other>1</other>  
      </i17>  
    </locations>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/addresses/locations/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_locations_0_label=Afghanistan (افغانستان)
result_locations_0_code=AF
result_locations_0_other=0
result_locations_1_label=Aland Islands
result_locations_1_code=AX
result_locations_1_other=0
result_locations_2_label=Albania (Shqip&euml;ria)
result_locations_2_code=AL
result_locations_2_other=0
result_locations_3_label=Algeria (الجزائر)
result_locations_3_code=DZ
result_locations_3_other=0
result_locations_4_label=American Samoa
result_locations_4_code=AS
result_locations_4_other=0
result_locations_5_label=Andorra
result_locations_5_code=AD
result_locations_5_other=0
result_locations_6_label=Angola
result_locations_6_code=AO
result_locations_6_other=0
result_locations_7_label=Anguilla
result_locations_7_code=AI
result_locations_7_other=0
result_locations_8_label=Antarctica
result_locations_8_code=AQ
result_locations_8_other=0
result_locations_9_label=Antigua and Barbuda
result_locations_9_code=AG
result_locations_9_other=0
result_locations_10_label=Argentina
result_locations_10_code=AR
result_locations_10_other=0
result_locations_11_label=Armenia (Հայաստան)
result_locations_11_code=AM
result_locations_11_other=0
result_locations_12_label=Aruba
result_locations_12_code=AW
result_locations_12_other=0
result_locations_13_label=Australia
result_locations_13_code=AU
result_locations_13_other=0
result_locations_14_label=Austria (&Ouml;sterreich)
result_locations_14_code=AT
result_locations_14_other=0
result_locations_15_label=Azerbaijan (Azərbaycan)
result_locations_15_code=AZ
result_locations_15_other=0
result_locations_16_label=[....]
result_locations_16_code=..
result_locations_16_other=0
result_locations_17_label=Canary Islands
result_locations_17_code=_C
result_locations_17_other=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/addresses/locations/list?format=plain

Query parameters

format = plain

Response

Afghanistan (افغانستان)
AF
0
Aland Islands
AX
0
Albania (Shqip&euml;ria)
AL
0
Algeria (الجزائر)
DZ
0
American Samoa
AS
0
Andorra
AD
0
Angola
AO
0
Anguilla
AI
0
Antarctica
AQ
0
Antigua and Barbuda
AG
0
Argentina
AR
0
Armenia (Հայաստան)
AM
0
Aruba
AW
0
Australia
AU
0
Austria (&Ouml;sterreich)
AT
0
Azerbaijan (Azərbaycan)
AZ
0
[....]
..
0
Canary Islands
_C
1

Return values

parameter	description
locations	list of available countries/locations

/plans/addresses/property

access: [READ]

This method returns requirements for the user info.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)Example 13 (json)Example 14 (xml)Example 15 (txt)Example 16 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US

Query parameters

 is_business = 0
country_code = US

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "vat_treatment": "EXTRA_EU_PRIVATE",
    "vat_id": {
      "mandatory": 0,
      "show": 0
    },
    "cf": {
      "mandatory": 0,
      "show": 0
    },
    "pec": {
      "mandatory": 0,
      "show": 0
    },
    "recipient_code": {
      "mandatory": 0,
      "show": 0
    },
    "province": {
      "mandatory": 0,
      "show": 0
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US&format=xml

Query parameters

 is_business = 0
country_code = US
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <vat_treatment>EXTRA_EU_PRIVATE</vat_treatment>  
    <vat_id>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </vat_id>  
    <cf>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </cf>  
    <pec>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </pec>  
    <recipient_code>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </recipient_code>  
    <province>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </province>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US&format=txt

Query parameters

 is_business = 0
country_code = US
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=EXTRA_EU_PRIVATE
result_vat_id_mandatory=0
result_vat_id_show=0
result_cf_mandatory=0
result_cf_show=0
result_pec_mandatory=0
result_pec_show=0
result_recipient_code_mandatory=0
result_recipient_code_show=0
result_province_mandatory=0
result_province_show=0

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US&format=plain

Query parameters

 is_business = 0
country_code = US
      format = plain

Response

EXTRA_EU_PRIVATE
0
0
0
0
0
0
0
0
0
0

Example 5 (json)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US

Query parameters

 is_business = 1
country_code = US

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "vat_treatment": "EXTRA_EU_BUSINESS",
    "vat_id": {
      "mandatory": 0,
      "show": 1
    },
    "cf": {
      "mandatory": 0,
      "show": 0
    },
    "pec": {
      "mandatory": 1,
      "show": 0
    },
    "recipient_code": {
      "mandatory": 1,
      "show": 0
    },
    "province": {
      "mandatory": 0,
      "show": 0
    }
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US&format=xml

Query parameters

 is_business = 1
country_code = US
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <vat_treatment>EXTRA_EU_BUSINESS</vat_treatment>  
    <vat_id>
      <mandatory>0</mandatory>  
      <show>1</show>  
    </vat_id>  
    <cf>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </cf>  
    <pec>
      <mandatory>1</mandatory>  
      <show>0</show>  
    </pec>  
    <recipient_code>
      <mandatory>1</mandatory>  
      <show>0</show>  
    </recipient_code>  
    <province>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </province>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US&format=txt

Query parameters

 is_business = 1
country_code = US
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=EXTRA_EU_BUSINESS
result_vat_id_mandatory=0
result_vat_id_show=1
result_cf_mandatory=0
result_cf_show=0
result_pec_mandatory=1
result_pec_show=0
result_recipient_code_mandatory=1
result_recipient_code_show=0
result_province_mandatory=0
result_province_show=0

Example 8 (plain)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US&format=plain

Query parameters

 is_business = 1
country_code = US
      format = plain

Response

EXTRA_EU_BUSINESS
0
1
0
0
1
0
1
0
0
0

Example 9 (json)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT

Query parameters

 is_business = 0
country_code = IT

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "vat_treatment": "ITALY_PRIVATE",
    "vat_id": {
      "mandatory": 0,
      "show": 0
    },
    "cf": {
      "mandatory": 1,
      "show": 1
    },
    "pec": {
      "mandatory": 0,
      "show": 1
    },
    "recipient_code": {
      "mandatory": 0,
      "show": 0
    },
    "province": {
      "mandatory": 1,
      "show": 1
    }
  }
}

Example 10 (xml)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT&format=xml

Query parameters

 is_business = 0
country_code = IT
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <vat_treatment>ITALY_PRIVATE</vat_treatment>  
    <vat_id>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </vat_id>  
    <cf>
      <mandatory>1</mandatory>  
      <show>1</show>  
    </cf>  
    <pec>
      <mandatory>0</mandatory>  
      <show>1</show>  
    </pec>  
    <recipient_code>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </recipient_code>  
    <province>
      <mandatory>1</mandatory>  
      <show>1</show>  
    </province>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT&format=txt

Query parameters

 is_business = 0
country_code = IT
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=ITALY_PRIVATE
result_vat_id_mandatory=0
result_vat_id_show=0
result_cf_mandatory=1
result_cf_show=1
result_pec_mandatory=0
result_pec_show=1
result_recipient_code_mandatory=0
result_recipient_code_show=0
result_province_mandatory=1
result_province_show=1

Example 12 (plain)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT&format=plain

Query parameters

 is_business = 0
country_code = IT
      format = plain

Response

ITALY_PRIVATE
0
0
1
1
0
1
0
0
1
1

Example 13 (json)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT

Query parameters

 is_business = 1
country_code = IT

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "vat_treatment": "ITALY_BUSINESS",
    "vat_id": {
      "mandatory": 1,
      "show": 1
    },
    "cf": {
      "mandatory": 0,
      "show": 0
    },
    "pec": {
      "mandatory": 1,
      "show": 1
    },
    "recipient_code": {
      "mandatory": 1,
      "show": 1
    },
    "province": {
      "mandatory": 1,
      "show": 1
    }
  }
}

Example 14 (xml)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT&format=xml

Query parameters

 is_business = 1
country_code = IT
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <vat_treatment>ITALY_BUSINESS</vat_treatment>  
    <vat_id>
      <mandatory>1</mandatory>  
      <show>1</show>  
    </vat_id>  
    <cf>
      <mandatory>0</mandatory>  
      <show>0</show>  
    </cf>  
    <pec>
      <mandatory>1</mandatory>  
      <show>1</show>  
    </pec>  
    <recipient_code>
      <mandatory>1</mandatory>  
      <show>1</show>  
    </recipient_code>  
    <province>
      <mandatory>1</mandatory>  
      <show>1</show>  
    </province>  
  </result>  
</response>

Example 15 (txt)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT&format=txt

Query parameters

 is_business = 1
country_code = IT
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=ITALY_BUSINESS
result_vat_id_mandatory=1
result_vat_id_show=1
result_cf_mandatory=0
result_cf_show=0
result_pec_mandatory=1
result_pec_show=1
result_recipient_code_mandatory=1
result_recipient_code_show=1
result_province_mandatory=1
result_province_show=1

Example 16 (plain)

Request

https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT&format=plain

Query parameters

 is_business = 1
country_code = IT
      format = plain

Response

ITALY_BUSINESS
1
1
0
0
1
1
1
1
1
1

Required parameters

parameter	description	max length
country_codeSTRING	code of the country of the user	2
is_businessBOOLEAN	1 for business users, 0 from private

Return values

parameter	description
cf	array containing `mandatory` and `show`
pec	array containing `mandatory` and `show`
province	array containing `mandatory` and `show`
recipient_code	array containing `mandatory` and `show`
vat_id	array containing `mandatory` and `show`
vat_treatment	VAT threatment type, see i1/plans/vats/property for details

/plans/coupons

/plans/coupons/attach

access: [READ]

This method allows to attach a coupon to the current customer.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/coupons/attach?coupon=7326d9fb58130b2ff2ad505183d2ff8f

Query parameters

coupon = 7326d9fb58130b2ff2ad505183d2ff8f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "attached": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/coupons/attach?coupon=7326d9fb58130b2ff2ad505183d2ff8f&format=xml

Query parameters

coupon = 7326d9fb58130b2ff2ad505183d2ff8f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <attached>1</attached>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/coupons/attach?coupon=7326d9fb58130b2ff2ad505183d2ff8f&format=txt

Query parameters

coupon = 7326d9fb58130b2ff2ad505183d2ff8f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_attached=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/coupons/attach?coupon=7326d9fb58130b2ff2ad505183d2ff8f&format=plain

Query parameters

coupon = 7326d9fb58130b2ff2ad505183d2ff8f
format = plain

Response

Required parameters

parameter	description
couponSTRING	The coupon code to be attached

Optional parameters

parameter	description
detach_existingBOOLEAN	1 to detach any coupons already present (default: 0)

Return values

parameter	description
attached	1 on success, an error is emitted otherwise

/plans/coupons/check

access: [READ]

This method checks the validity of a coupon.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/coupons/check?coupon=700ccacef90b0dbacbf7d2549a13d5b2&amount=100

Query parameters

coupon = 700ccacef90b0dbacbf7d2549a13d5b2
amount = 100

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "valid": 1,
    "description": "Test coupon for PayPal",
    "params": {
      "expiration": "2026-12-31T13:13:00+01:00",
      "en": "Test coupon for PayPal",
      "it": "Coupon di prova per PayPal",
      "plan": "pro, business",
      "charge_amount": "12",
      "public_plan": "Pro, Business"
    },
    "amount": 100,
    "amount1": 0,
    "discounted": 0,
    "discounted1": 0,
    "is_100p_discount": 1,
    "charge_amount": 12,
    "charge_amount_formatted": "12.00 €",
    "paypal": {
      "env": "production",
      "client": {
        "production": "b6ef3ed93ab58faaebba88b7174258f1-bbf0ec519f7c2e0a443e62edf41777e0"
      }
    },
    "discounted_formatted": "0.00",
    "discounted1_formatted": "0.00"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/coupons/check?coupon=700ccacef90b0dbacbf7d2549a13d5b2&amount=100&format=xml

Query parameters

coupon = 700ccacef90b0dbacbf7d2549a13d5b2
amount = 100
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <valid>1</valid>  
    <description>Test coupon for PayPal</description>  
    <params>
      <expiration>2026-12-31T13:13:00+01:00</expiration>  
      <en>Test coupon for PayPal</en>  
      <it>Coupon di prova per PayPal</it>  
      <plan>pro, business</plan>  
      <charge_amount>12</charge_amount>  
      <public_plan>Pro, Business</public_plan>  
    </params>  
    <amount>100</amount>  
    <amount1>0</amount1>  
    <discounted>0</discounted>  
    <discounted1>0</discounted1>  
    <is_100p_discount>1</is_100p_discount>  
    <charge_amount>12</charge_amount>  
    <charge_amount_formatted><[CDATA[12.00 &euro;]]></charge_amount_formatted>  
    <paypal>
      <env>production</env>  
      <client>
        <production>b6ef3ed93ab58faaebba88b7174258f1-bbf0ec519f7c2e0a443e62edf41777e0</production>  
      </client>  
    </paypal>  
    <discounted_formatted>0.00</discounted_formatted>  
    <discounted1_formatted>0.00</discounted1_formatted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/coupons/check?coupon=700ccacef90b0dbacbf7d2549a13d5b2&amount=100&format=txt

Query parameters

coupon = 700ccacef90b0dbacbf7d2549a13d5b2
amount = 100
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_valid=1
result_description=Test coupon for PayPal
result_params_expiration=2026-12-31T13:13:00+01:00
result_params_en=Test coupon for PayPal
result_params_it=Coupon di prova per PayPal
result_params_plan=pro, business
result_params_charge_amount=12
result_params_public_plan=Pro, Business
result_amount=100
result_amount1=0
result_discounted=0
result_discounted1=0
result_is_100p_discount=1
result_charge_amount=12
result_charge_amount_formatted=12.00 &euro;
result_paypal_env=production
result_paypal_client_production=b6ef3ed93ab58faaebba88b7174258f1-bbf0ec519f7c2e0a443e62edf41777e0
result_discounted_formatted=0.00
result_discounted1_formatted=0.00

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/coupons/check?coupon=700ccacef90b0dbacbf7d2549a13d5b2&amount=100&format=plain

Query parameters

coupon = 700ccacef90b0dbacbf7d2549a13d5b2
amount = 100
format = plain

Response

1
Test coupon for PayPal
2026-12-31T13:13:00+01:00
Test coupon for PayPal
Coupon di prova per PayPal
pro, business
12
Pro, Business
100
0
0
0
1
12
12.00 &euro;
production
b6ef3ed93ab58faaebba88b7174258f1-bbf0ec519f7c2e0a443e62edf41777e0
0.00
0.00

Required parameters

parameter	description
couponSTRING	Coupon code. This can be a comma separated list of coupons for stackable coupons.

Optional parameters

parameter	description
amountSTRING	if this parameter is passed, the method returns the amount requested after applying the coupon
amount1STRING	if this parameter is passed, the method returns the amount requested after applying the coupon

Return values

parameter	description
amount	echo back of the input parameter amount
amount1	echo back of the input parameter amount1
charge_amount	[OPTIONAL] returned only if the coupon requires an immediate charge
charge_amount_formatted	[OPTIONAL] formatted version of charge_amount
description	description of the coupon if available, empty otherwise
discounted	the amount requested after applying the coupon to parameter amount
discounted1	the amount requested after applying the coupon to parameter amount1
discounted1_formatted	formatted version of discounted1
discounted_formatted	formatted version of discounted
is_100p_discount	1 if the coupon applies a 100% discount, 0 otherwise
params	array containing extended parameters for the coupon
paypal	[OPTIONAL] array containing information on the PayPal client to be used to precess payments, please see PayPal API documentation for details
valid	1 if the coupon is valid, 0 otherwise

Fields in params:

annual: if 1 the coupon can be used only for annual subscriptions
monthly: if 1 the coupon can be used only for monthly subscriptions
registered_after: if not empty, the coupon can only be redeemed by users registered after the indicated date/time (UTC)
only_higher_cost_plans: if 1 the coupon can be used only for subscriptions with a higher cost
plan=[comma separated list of plan names]: if not empty, the coupon can be used only for plans in the comma-separated list
public_plan=[comma separated list public plan name]: the public names of the plans in the plan parameter
charge_amount=[amount in euros (decimal point)]: if not empty, the coupon requires an immediate charge to be activated
email=[email address]: if not empty, the coupon can be redeemed only by the account identified by the email address
paypal: if 0 then the possibility of using PayPal to pay coupons with charge_amount is disabled, 1 has no effect because the use of paypal is activated automatically
expiration=[expiration date]: the coupon can be used until the expiration date
current_plan=[comma separated list of plan names]: if not empty, the coupon can be used only if the user has a plan in the list
not_current_plan=[comma separated list of plan names]: if not empty, the coupon can be used only if the user does NOT have a plan in the list
trial: if 1 the coupon can only be used if the user currently has a trial for a plan
only_once: if 1 the coupon can only be used once per user, otherwise it can be used multiple times (default: 0)
only_once_in_period: forces the use of the coupon to 1 time in the time frame indicated by only_once_in_period in days
prorate: if 0 the proration is disabled
customer: if 1 the coupon can be applied to active subscriptions
status: if not empty, the coupon can only be used for the statuses in the comma-separated list (integer, 0=GREEN, 1=YELLOW, 2=RED, 3=EXCEEDED)
extended_checks=[comma separated list of extended checks]: additional checks to validate the use of the coupon

Available checks in extended_checks:

full_name: check that the user's full name (entered at registration) contains at least 2 words (first and last name)

/plans/customers

/plans/customers/add

access: [WRITE]

This method creates a customer on the payment gateway.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/customers/add

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/customers/add?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/customers/add?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/customers/add?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
added	1 on success, 0 otherwise

/plans/customers/balance_transactions

access: [READ]

This method returns the list of balance transactions for the current customer. Transactions are returned in reverse order (most recent first).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/customers/balance_transactions

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/customers/balance_transactions?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/customers/balance_transactions?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/customers/balance_transactions?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
startingSTRING	it is an ID (returned in `data`) that defines the point in the list from which to extract transactions, to be used in pagination

Return values

parameter	description
data	list of transactions

Available fields in data:

id: ID of the transaction, to be used with the starting paramenter,
amount: the amount of the transaction, a negative value is a credit for the balance, and a positive value is a debit to the balance,
currency: three-letter ISO currency code, in lowercase,
balance: the balance after the transaction was applied, a negative value decreases the amount due on the next invoice, a positive value increases the amount due on next invoice,
created: date/time at which the transaction was created (UTC),
type: transaction type.

Available transaction types:

adjustment: an explicitly created adjustment transaction to debit or credit the credit balance,
invoice: traces the application of credit against a payment,
credit_note: traces the creation of credit to a payment,
unspent: a corresponding credit transaction is created if unspent funds aren't fully charged after 60 days, when this happens,
other: unspecified transaction,
initial: the starting value of the balance.

/plans/customers/info

access: [READ]

This method returns payment information about the user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/customers/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "1409a53a893dfbd591eac08ce4c30521",
    "created": "2018-08-07T20:33:07+02:00",
    "updated": "2018-08-07T20:33:07+02:00",
    "payments": [
      {
        "token": "44486a7a62773951522b6a636d663931695a75594c6d314162416768375355784f487445762b704e4c37486f3130375553426133796279314e64776b52594e64",
        "country": "US",
        "created": "2018-12-06T23:31:24+01:00",
        "updated": "2018-12-06T23:31:24+01:00",
        "default": 1,
        "image": "",
        "subscriptions": 0,
        "brand": "Visa",
        "type": "visa",
        "last4": "4242",
        "expiration": {
          "month": 4,
          "year": 2024
        }
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/customers/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>1409a53a893dfbd591eac08ce4c30521</id>  
    <created>2018-08-07T20:33:07+02:00</created>  
    <updated>2018-08-07T20:33:07+02:00</updated>  
    <payments>
      <i0>
        <token>44486a7a62773951522b6a636d663931695a75594c6d314162416768375355784f487445762b704e4c37486f3130375553426133796279314e64776b52594e64</token>  
        <country>US</country>  
        <created>2018-12-06T23:31:24+01:00</created>  
        <updated>2018-12-06T23:31:24+01:00</updated>  
        <default>1</default>  
        <image></image>  
        <subscriptions>0</subscriptions>  
        <brand>Visa</brand>  
        <type>visa</type>  
        <last4>4242</last4>  
        <expiration>
          <month>4</month>  
          <year>2024</year>  
        </expiration>  
      </i0>  
    </payments>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/customers/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1409a53a893dfbd591eac08ce4c30521
result_created=2018-08-07T20:33:07+02:00
result_updated=2018-08-07T20:33:07+02:00
result_payments_0_token=44486a7a62773951522b6a636d663931695a75594c6d314162416768375355784f487445762b704e4c37486f3130375553426133796279314e64776b52594e64
result_payments_0_country=US
result_payments_0_created=2018-12-06T23:31:24+01:00
result_payments_0_updated=2018-12-06T23:31:24+01:00
result_payments_0_default=1
result_payments_0_image=
result_payments_0_subscriptions=0
result_payments_0_brand=Visa
result_payments_0_type=visa
result_payments_0_last4=4242
result_payments_0_expiration_month=4
result_payments_0_expiration_year=2024

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/customers/info?format=plain

Query parameters

format = plain

Response

1409a53a893dfbd591eac08ce4c30521
2018-08-07T20:33:07+02:00
2018-08-07T20:33:07+02:00
44486a7a62773951522b6a636d663931695a75594c6d314162416768375355784f487445762b704e4c37486f3130375553426133796279314e64776b52594e64
US
2018-12-06T23:31:24+01:00
2018-12-06T23:31:24+01:00
default:1

0
Visa
visa
4242
4
2024

Return values

parameter	description
created	date on which the customer was created
id	customer ID on the payment gateway
payments	object containing payment information
updated	date on which the customer was updated

/plans/info

access: [READ]

This method returns information about the user's plan.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/info

Response

{
  "id": "c64c6b186c2d064c76cd9c2f56f35a62",
  "name": "business",
  "annually_cost": 135,
  "monthly_cost": 169,
  "events_per_month": 500000,
  "tracking_links": 100000,
  "stats_permanency_days": 730,
  "max_users": 30,
  "max_permissions": 6,
  "max_brands": 70,
  "has_smart_balancer": 1,
  "has_split_testing": 1,
  "has_smart_redirector": 1,
  "max_qrcode_templates": 100,
  "max_projects": "",
  "has_conversions": 1,
  "has_timed_urls": 1,
  "force_brand_on_ctas": 0,
  "has_watchdog_ping": 1,
  "has_watchdog_advanced": 1,
  "number_of_ctas": "",
  "max_banners": "",
  "custom_domains": 30,
  "email_support": 1,
  "priority_email_support": 1,
  "has_security_monitor": 1,
  "has_cfm": 1,
  "has_custom_aliases": 1,
  "has_masking": 1,
  "has_jotbar": 1,
  "has_custom_logo_in_reports": 1,
  "has_custom_css_cta": 1,
  "has_setup_assistance_and_training": 0,
  "has_custom_invoicing": 0,
  "has_enterprise_sla": 0,
  "has_customizations_and_integrations": 0,
  "has_digital_marketing_advice": 0,
  "has_minipages": 1,
  "has_deeplinks": 1,
  "has_easydeeplinks": 1,
  "has_preview": 1,
  "public_name": "Business",
  "has_utm_builder": 1,
  "max_utm_templates": 30,
  "has_remarketing": "",
  "has_whatsapp": 1,
  "has_instaurl": 0,
  "has_selfdestruction": 0,
  "has_cloaking": 1,
  "has_advanced_security": 0,
  "has_sso": 0,
  "is_monthly": 1,
  "status": "green",
  "trial_left_days": 30,
  "events": "",
  "is_monitored": 1,
  "can_manage_plans": 1,
  "can_manage_billing": 1,
  "email_sent": 0,
  "subscription_status": "ACTIVE",
  "subscription_creation": "2018-08-13T23:16:14+02:00",
  "subscription_next_billing_date": "2018-12-27T11:58:57+01:00",
  "subscription_billing_end_date": "2018-12-27T11:58:57+01:00",
  "subscription_never_expires": 1,
  "subscription_trial_period": 0,
  "subscription_first_billing_date": "2018-12-27T11:58:57+01:00",
  "subscription_balance": 0,
  "max_gdpr_templates": 10,
  "has_gdpr_custom_consent": 1,
  "max_media": 100000,
  "max_media_size": 10000000,
  "cdnbytes_per_month": 100000000000,
  "api_rate_limits": {
    "primary": {
      "limit": 500,
      "unit": "HOUR"
    },
    "secondary": {
      "limit": 50000,
      "unit": "DAY"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <id>c64c6b186c2d064c76cd9c2f56f35a62</id>  
  <name>business</name>  
  <annually_cost>135</annually_cost>  
  <monthly_cost>169</monthly_cost>  
  <events_per_month>500000</events_per_month>  
  <tracking_links>100000</tracking_links>  
  <stats_permanency_days>730</stats_permanency_days>  
  <max_users>30</max_users>  
  <max_permissions>6</max_permissions>  
  <max_brands>70</max_brands>  
  <has_smart_balancer>1</has_smart_balancer>  
  <has_split_testing>1</has_split_testing>  
  <has_smart_redirector>1</has_smart_redirector>  
  <max_qrcode_templates>100</max_qrcode_templates>  
  <max_projects></max_projects>  
  <has_conversions>1</has_conversions>  
  <has_timed_urls>1</has_timed_urls>  
  <force_brand_on_ctas>0</force_brand_on_ctas>  
  <has_watchdog_ping>1</has_watchdog_ping>  
  <has_watchdog_advanced>1</has_watchdog_advanced>  
  <number_of_ctas></number_of_ctas>  
  <max_banners></max_banners>  
  <custom_domains>30</custom_domains>  
  <email_support>1</email_support>  
  <priority_email_support>1</priority_email_support>  
  <has_security_monitor>1</has_security_monitor>  
  <has_cfm>1</has_cfm>  
  <has_custom_aliases>1</has_custom_aliases>  
  <has_masking>1</has_masking>  
  <has_jotbar>1</has_jotbar>  
  <has_custom_logo_in_reports>1</has_custom_logo_in_reports>  
  <has_custom_css_cta>1</has_custom_css_cta>  
  <has_setup_assistance_and_training>0</has_setup_assistance_and_training>  
  <has_custom_invoicing>0</has_custom_invoicing>  
  <has_enterprise_sla>0</has_enterprise_sla>  
  <has_customizations_and_integrations>0</has_customizations_and_integrations>  
  <has_digital_marketing_advice>0</has_digital_marketing_advice>  
  <has_minipages>1</has_minipages>  
  <has_deeplinks>1</has_deeplinks>  
  <has_easydeeplinks>1</has_easydeeplinks>  
  <has_preview>1</has_preview>  
  <public_name>Business</public_name>  
  <has_utm_builder>1</has_utm_builder>  
  <max_utm_templates>30</max_utm_templates>  
  <has_remarketing></has_remarketing>  
  <has_whatsapp>1</has_whatsapp>  
  <has_instaurl>0</has_instaurl>  
  <has_selfdestruction>0</has_selfdestruction>  
  <has_cloaking>1</has_cloaking>  
  <has_advanced_security>0</has_advanced_security>  
  <has_sso>0</has_sso>  
  <is_monthly>1</is_monthly>  
  <status>green</status>  
  <trial_left_days>30</trial_left_days>  
  <events></events>  
  <is_monitored>1</is_monitored>  
  <can_manage_plans>1</can_manage_plans>  
  <can_manage_billing>1</can_manage_billing>  
  <email_sent>0</email_sent>  
  <subscription_status>ACTIVE</subscription_status>  
  <subscription_creation>2018-08-13T23:16:14+02:00</subscription_creation>  
  <subscription_next_billing_date>2018-12-27T11:58:57+01:00</subscription_next_billing_date>  
  <subscription_billing_end_date>2018-12-27T11:58:57+01:00</subscription_billing_end_date>  
  <subscription_never_expires>1</subscription_never_expires>  
  <subscription_trial_period>0</subscription_trial_period>  
  <subscription_first_billing_date>2018-12-27T11:58:57+01:00</subscription_first_billing_date>  
  <subscription_balance>0</subscription_balance>  
  <max_gdpr_templates>10</max_gdpr_templates>  
  <has_gdpr_custom_consent>1</has_gdpr_custom_consent>  
  <max_media>100000</max_media>  
  <max_media_size>10000000</max_media_size>  
  <cdnbytes_per_month>100000000000</cdnbytes_per_month>  
  <api_rate_limits>
    <primary>
      <limit>500</limit>  
      <unit>HOUR</unit>  
    </primary>  
    <secondary>
      <limit>50000</limit>  
      <unit>DAY</unit>  
    </secondary>  
  </api_rate_limits>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/info?format=txt

Query parameters

format = txt

Response

id=c64c6b186c2d064c76cd9c2f56f35a62
name=business
annually_cost=135
monthly_cost=169
events_per_month=500000
tracking_links=100000
stats_permanency_days=730
max_users=30
max_permissions=6
max_brands=70
has_smart_balancer=1
has_split_testing=1
has_smart_redirector=1
max_qrcode_templates=100
max_projects=
has_conversions=1
has_timed_urls=1
force_brand_on_ctas=0
has_watchdog_ping=1
has_watchdog_advanced=1
number_of_ctas=
max_banners=
custom_domains=30
email_support=1
priority_email_support=1
has_security_monitor=1
has_cfm=1
has_custom_aliases=1
has_masking=1
has_jotbar=1
has_custom_logo_in_reports=1
has_custom_css_cta=1
has_setup_assistance_and_training=0
has_custom_invoicing=0
has_enterprise_sla=0
has_customizations_and_integrations=0
has_digital_marketing_advice=0
has_minipages=1
has_deeplinks=1
has_easydeeplinks=1
has_preview=1
public_name=Business
has_utm_builder=1
max_utm_templates=30
has_remarketing=
has_whatsapp=1
has_instaurl=0
has_selfdestruction=0
has_cloaking=1
has_advanced_security=0
has_sso=0
is_monthly=1
status=green
trial_left_days=30
events=
is_monitored=1
can_manage_plans=1
can_manage_billing=1
email_sent=0
subscription_status=ACTIVE
subscription_creation=2018-08-13T23:16:14+02:00
subscription_next_billing_date=2018-12-27T11:58:57+01:00
subscription_billing_end_date=2018-12-27T11:58:57+01:00
subscription_never_expires=1
subscription_trial_period=0
subscription_first_billing_date=2018-12-27T11:58:57+01:00
subscription_balance=0
max_gdpr_templates=10
has_gdpr_custom_consent=1
max_media=100000
max_media_size=10000000
cdnbytes_per_month=100000000000
api_rate_limits_primary_limit=500
api_rate_limits_primary_unit=HOUR
api_rate_limits_secondary_limit=50000
api_rate_limits_secondary_unit=DAY

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/info?format=plain

Query parameters

format = plain

Response

c64c6b186c2d064c76cd9c2f56f35a62
business
135
169
500000
100000
730
30
6
70
1
1
1
100

1
1
0
1
1


30
1
1
1
1
1
1
1
1
1
0
0
0
0
0
1
1
1
1
Business
1
30

1
0
0
1
0
0
1
green
30

1
1
1
0
ACTIVE
2018-08-13T23:16:14+02:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
1
0
2018-12-27T11:58:57+01:00
0
10
1
100000
10000000
100000000000
500
HOUR
50000
DAY

Return values

parameter	description
annually_cost	cost if paid annually
api_rate_limits	API rate limits, see i1/apis/limits for details
can_manage_billing	1 if the user can change the billing information and download invoices, 0 otherwise
can_manage_plans	1 if the user can change the current plan and subscription, 0 otherwise
cdnbytes_per_month	available CDN bytes per month
custom_domains	maximum number of custom domains
email_sent	if an email was sent after a change of status, in any case emails are sent with a frequency of no less than 72 hours
email_support	1 if email support is available, 0 otherwise
events	events used in the last 30 days
events_per_month	available events per month
force_brand_on_ctas	1 if the JotUrl brand is forced to be shown on CTAs, 0 otherwise
has_advanced_security	1 if the advanced security (permissions) is available, 0 otherwise
has_cfm	1 if click fraud protection is available, 0 otherwise
has_cloaking	1 if the cloaking option is available, 0 otherwise
has_conversions	1 if conversions are available, 0 otherwise
has_custom_aliases	1 if custom aliases are available, 0 otherwise
has_custom_css_cta	1 if custom CSS on CTAs is available, 0 otherwise
has_custom_invoicing	1 if custom invoicing is available, 0 otherwise
has_custom_logo_in_reports	1 if custom logo in reports is available, 0 otherwise
has_customizations_and_integrations	1 if customizations and integrations is available, 0 otherwise
has_deeplinks	1 if deep links are available, 0 otherwise
has_digital_marketing_advice	1 if digital marketing advice is available, 0 otherwise
has_easydeeplinks	1 if the option easy deep links is available, 0 otherwise
has_enterprise_sla	1 if enterprise SLA is available, 0 otherwise
has_gdpr_custom_consent	1 if GDPR consent can be customized, 0 otherwise
has_instaurl	1 if JotBio (InstaUrl) is available, 0 otherwise
has_jotbar	1 if JotBar is available, 0 otherwise
has_masking	1 if masking is available, 0 otherwise
has_minipages	1 if minipages are available, 0 otherwise
has_preview	1 if link preview edit (Open Graph tags) is available, 0 otherwise
has_remarketing	number of available remarketing pixels, empty means "unlimited", 0 means no remarketing pixel available
has_security_monitor	1 if security monitor is available, 0 otherwise
has_selfdestruction	1 if the self destruction option is available, 0 otherwise
has_setup_assistance_and_training	1 if setup assistance and training is available, 0 otherwise
has_smart_balancer	1 if smart balanger is available, 0 otherwise
has_smart_redirector	1 if smart redirector is available, 0 otherwise
has_split_testing	1 if split testing is available, 0 otherwise
has_sso	1 if the Single sign-on (SSO) is available, 0 otherwise
has_timed_urls	1 if timed urls is available, 0 otherwise
has_utm_builder	1 if UTM builder is available, 0 otherwise
has_watchdog_advanced	1 if advanced Watchdog is available, 0 otherwise
has_watchdog_ping	1 if basic Watchdog is available, 0 otherwise
has_whatsapp	1 if WhatsUrl is available, 0 otherwise
id	ID of the subscribed profile
is_monitored	1 if the user profile is automatically monitored, 0 otherwise
is_monthly	1 billing is made monthly, 0 for annually billing
max_brands	maximum number of brands
max_gdpr_templates	maximum available GDPR templates
max_media	maximum number of media in the media library
max_media_size	maximum size of the the media library (in bytes)
max_permissions	maximum number of permissions for your team members
max_qrcode_templates	maximum number of QR-Code templates
max_users	maximum number of users (including the admin user)
max_utm_templates	maximum number of UTM templates
monthly_cost	cost per month if paid monthly
name	name of the profile
priority_email_support	1 if priority email support is available, 0 otherwise
public_name	user-friendly name of the profile
stats_permanency_days	analytics are stored for this number of days
status	status for the user, it can be: `green` if the user is using less than 80% of the available events, `yellow` if the user is using between the 80% (included) and 110% (excluded) of the available events, `red` if the user is using between the 110% (included) and 150% (excluded) of the available events, `black` if the user is using more than the 150% (included) of the available events or if the user is continuosly in the `red` status for at least 144 hours
subscription_balance	[OPTIONAL] any remaining credit that will be used for future payments, available only for monitored and paid profile
subscription_billing_end_date	[OPTIONAL] end of the current period that the subscription has been invoiced for; at the end of this period, a new invoice will be created, available only for monitored and paid profile
subscription_creation	[OPTIONAL] time at which the subscription was created, available only for monitored and paid profile
subscription_first_billing_date	[OPTIONAL] date at which a new invoice will be generated for the subscription (for trialing subscriptions), available only for monitored and paid profile
subscription_never_expires	[OPTIONAL] 0 if the subscription is scheduled to be canceled at the end of the current billing period, 1 otherwise, available only for monitored and paid profile
subscription_next_billing_date	[OPTIONAL] date at which a new invoice will be generated for the subscription, available only for monitored and paid profile
subscription_status	[subscription status, it can be one of [TRIALING, INCOMPLETE, INCOMPLETE_EXPIRED, ACTIVE, PAST_DUE, CANCELED, UNPAID]
subscription_trial_period	[OPTIONAL] 1 if the subscription is in its trial period, 0 otherwise, available only for monitored and paid profile
tracking_links	maximum number of tracking links
trial_left_days	available maximum trial days for the user

/plans/invoices

/plans/invoices/count

access: [READ]

This method returns the number of invoices issued to the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/invoices/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 90
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/invoices/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>90</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/invoices/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=90

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/invoices/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
is_credit_noteBOOLEAN	count only credit notes
searchSTRING	filters invoices to be extracted by searching them
vat_treatmentSTRING	filter invoices by VAT treatment
yearINTEGER	filter invoices by year

Return values

parameter	description
count	the total number of invoices issued to the logged user

/plans/invoices/emails

/plans/invoices/emails/get

access: [READ]

This method returns the email addresses to which invoices are sent for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/invoices/emails/get

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "emails": "user@example.com,accounting@example.com"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/invoices/emails/get?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <emails>user@example.com,accounting@example.com</emails>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/invoices/emails/get?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_emails=user@example.com,accounting@example.com

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/invoices/emails/get?format=plain

Query parameters

format = plain

Response

user@example.com,accounting@example.com

Return values

parameter	description
emails	comma-separated list of email addresses to which invoices are sent

/plans/invoices/emails/set

access: [WRITE]

This method sets the email addresses to which invoices will be sent for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/invoices/emails/set?emails=user%40example.com,accounting%40example.com

Query parameters

emails = user@example.com,accounting@example.com

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "emails": "user@example.com,accounting@example.com"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/invoices/emails/set?emails=user%40example.com,accounting%40example.com&format=xml

Query parameters

emails = user@example.com,accounting@example.com
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <emails>user@example.com,accounting@example.com</emails>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/invoices/emails/set?emails=user%40example.com,accounting%40example.com&format=txt

Query parameters

emails = user@example.com,accounting@example.com
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_emails=user@example.com,accounting@example.com

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/invoices/emails/set?emails=user%40example.com,accounting%40example.com&format=plain

Query parameters

emails = user@example.com,accounting@example.com
format = plain

Response

user@example.com,accounting@example.com

Optional parameters

parameter	description
emailsSTRING	NA

Return values

parameter	description
emails	comma-separated list of email addresses

/plans/invoices/get

access: [READ]

This method returns an invoice for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/invoices/get?id=9a67e79c1adef2ad65eab2a43fb8e41d&pdf=1

Query parameters

 id = 9a67e79c1adef2ad65eab2a43fb8e41d
pdf = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "10C-CC\/2019",
    "pdf": "[PDF]"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/invoices/get?id=9a67e79c1adef2ad65eab2a43fb8e41d&pdf=1&format=xml

Query parameters

    id = 9a67e79c1adef2ad65eab2a43fb8e41d
   pdf = 1
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>10C-CC/2019</id>  
    <pdf>[PDF]</pdf>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/invoices/get?id=9a67e79c1adef2ad65eab2a43fb8e41d&pdf=1&format=txt

Query parameters

    id = 9a67e79c1adef2ad65eab2a43fb8e41d
   pdf = 1
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=10C-CC/2019
result_pdf=[PDF]

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/invoices/get?id=9a67e79c1adef2ad65eab2a43fb8e41d&pdf=1&format=plain

Query parameters

    id = 9a67e79c1adef2ad65eab2a43fb8e41d
   pdf = 1
format = plain

Response

10C-CC/2019
[PDF]

Required parameters

parameter	description
idID	internal ID of the invoice

Optional parameters

parameter	description
pdfBOOLEAN	1 to generate a PDF (returned as binary string), 0 to generate the corresponding HTML (default value: 0)

Return values

parameter	description
html	HTML for the invoice if `pdf = 0`
id	ID of the invoice
pdf	PDF for the invoice if `pdf = 1`

/plans/invoices/list

access: [READ]

This method returns a list of invoices associated to the user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/invoices/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "id": "d4140a7d18de40000e5a5d8a11ddb32a",
        "profile_id": "4e4765cd7721fba0e0472333a6d7101a",
        "profile_name": "planname",
        "public_name": "Plan Name",
        "amount": "9.00",
        "created": "2019-06-20 08:57:21",
        "invoice_datetime": "2019-06-20 09:57:38",
        "billing_period_start": "2019-06-20 08:57:21",
        "billing_period_end": "2019-07-20 08:57:21",
        "vat_treatment": "INTRA_EU_BUSINESS",
        "year": 2019,
        "sequence": 11,
        "address": {
          "is_business": 1,
          "name": "Company name",
          "address_address": "Company address",
          "postal_code": "DH8 6ZL",
          "city": "MEDOMSLEY",
          "country_code": "UK",
          "vat_id": "2380238238E123",
          "cf": "",
          "pec": "",
          "recipient_code": ""
        },
        "promo_code": "",
        "promo_amount": "",
        "invoice_template": "",
        "invoice_description": "",
        "refund_amount": "",
        "refund_invoice_id": "",
        "refund_vat_treatment": "",
        "refund_year": "",
        "refund_sequence": "",
        "refund_datetime": "",
        "invoice_id": "11B-EU\/2019",
        "is_credit_note": 0
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/invoices/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <id>d4140a7d18de40000e5a5d8a11ddb32a</id>  
        <profile_id>4e4765cd7721fba0e0472333a6d7101a</profile_id>  
        <profile_name>planname</profile_name>  
        <public_name>Plan Name</public_name>  
        <amount>9.00</amount>  
        <created>2019-06-20 08:57:21</created>  
        <invoice_datetime>2019-06-20 09:57:38</invoice_datetime>  
        <billing_period_start>2019-06-20 08:57:21</billing_period_start>  
        <billing_period_end>2019-07-20 08:57:21</billing_period_end>  
        <vat_treatment>INTRA_EU_BUSINESS</vat_treatment>  
        <year>2019</year>  
        <sequence>11</sequence>  
        <address>
          <is_business>1</is_business>  
          <name>Company name</name>  
          <address_address>Company address</address_address>  
          <postal_code>DH8 6ZL</postal_code>  
          <city>MEDOMSLEY</city>  
          <country_code>UK</country_code>  
          <vat_id>2380238238E123</vat_id>  
          <cf></cf>  
          <pec></pec>  
          <recipient_code></recipient_code>  
        </address>  
        <promo_code></promo_code>  
        <promo_amount></promo_amount>  
        <invoice_template></invoice_template>  
        <invoice_description></invoice_description>  
        <refund_amount></refund_amount>  
        <refund_invoice_id></refund_invoice_id>  
        <refund_vat_treatment></refund_vat_treatment>  
        <refund_year></refund_year>  
        <refund_sequence></refund_sequence>  
        <refund_datetime></refund_datetime>  
        <invoice_id>11B-EU/2019</invoice_id>  
        <is_credit_note>0</is_credit_note>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/invoices/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=d4140a7d18de40000e5a5d8a11ddb32a
result_data_0_profile_id=4e4765cd7721fba0e0472333a6d7101a
result_data_0_profile_name=planname
result_data_0_public_name=Plan Name
result_data_0_amount=9.00
result_data_0_created=2019-06-20 08:57:21
result_data_0_invoice_datetime=2019-06-20 09:57:38
result_data_0_billing_period_start=2019-06-20 08:57:21
result_data_0_billing_period_end=2019-07-20 08:57:21
result_data_0_vat_treatment=INTRA_EU_BUSINESS
result_data_0_year=2019
result_data_0_sequence=11
result_data_0_address_is_business=1
result_data_0_address_name=Company name
result_data_0_address_address_address=Company address
result_data_0_address_postal_code=DH8 6ZL
result_data_0_address_city=MEDOMSLEY
result_data_0_address_country_code=UK
result_data_0_address_vat_id=2380238238E123
result_data_0_address_cf=
result_data_0_address_pec=
result_data_0_address_recipient_code=
result_data_0_promo_code=
result_data_0_promo_amount=
result_data_0_invoice_template=
result_data_0_invoice_description=
result_data_0_refund_amount=
result_data_0_refund_invoice_id=
result_data_0_refund_vat_treatment=
result_data_0_refund_year=
result_data_0_refund_sequence=
result_data_0_refund_datetime=
result_data_0_invoice_id=11B-EU/2019
result_data_0_is_credit_note=0

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/invoices/list?format=plain

Query parameters

format = plain

Response

1
d4140a7d18de40000e5a5d8a11ddb32a
4e4765cd7721fba0e0472333a6d7101a
planname
Plan Name
9.00
2019-06-20 08:57:21
2019-06-20 09:57:38
2019-06-20 08:57:21
2019-07-20 08:57:21
INTRA_EU_BUSINESS
2019
11
1
Company name
Company address
DH8 6ZL
MEDOMSLEY
UK
2380238238E123













11B-EU/2019
0

Optional parameters

parameter	description
idID	filter invoice by ID
is_credit_noteBOOLEAN	show only credit notes
lengthINTEGER	extracts this number of invoices (maxmimum allowed: 100)
searchSTRING	filters invoices to be extracted by searching them
startINTEGER	starts to extract invoices from this position
vat_treatmentSTRING	filter invoices by VAT treatment
yearINTEGER	filter invoices by year

Return values

parameter	description
count	[OPTIONAL] the total number of invoices available for the user, only returned if id is not passed
data
next	[OPTIONAL] the URL to call to retrieve the next page of invoices when they are paged, returned only if at least one more invoice is available

Please note that our engine could return a lower number of invoices than specified by the length parameter if the extraction time exceeds a specific threshold.

Returned data contains the following fields:

id: internal ID of the invoice
profile_id: profile ID associated with the invoice
profile_name: profile name associated with the invoice
public_name: profile user-friendly name associated with the invoice
amount: amount of the invoice
created: date/time at which the invoice was created by the payment gateway
invoice_datetime: date/time at which the invoice was generated (may be different from created)
billing_period_start: start of the current period that the subscription has been invoiced for
billing_period_end: end of the current period that the subscription has been invoiced for, at the end of this period, a new invoice will be created
vat_treatment: VAT treatment applied to the invoice
year: year when the invoice was issued
sequence: unique sequential number that identifies the invoice, this number is unique within the same VAT treatment
address: array containing billing information of the customer
promo_code: promo code applied to the invoice (optional)
promo_amount: discount amount applied to the invoice (optional)
invoice_template: template for the invoice (optional)
invoice_description: description for the invoice (optional)
refund_amount: refund amonut, only available is the invoice is a refund (optional)
refund_invoice_id: the credit note was generated against the invoice with this internal ID (optional)
invoice_id: ID of the invoice
is_credit_note: 1 if the item is a credit note
refund_vat_treatment: VAT treatment applied to the invoice that was refunded
refund_year: year of the invoice that was refunded
refund_sequence: unique sequential number that identifies the invoice that was refunded
refund_datetime: date of the invoice that was refunded

Available VAT treatments:

ITALY_PRIVATE: applied to Italian private customers
ITALY_BUSINESS: applied to Italian business customers
INTRA_EU_PRIVATE: applied to private customers in the EU
INTRA_EU_BUSINESS: applied to business customers in the EU
EXTRA_EU_PRIVATE: applied to all private customers outside the EU
EXTRA_EU_BUSINESS: applied to all business customers outside the EU

Field address is an array containing:

is_business: 1 if it is business customer, 0 otherwise
name: name
address_address: address
postal_code: postal code
city: city
country_code: ISO 3166-1 alpha-2 country code
vat_id: VAT id
cf: fiscal code (only for Italian customers)
pec: certified email (only for Italian customers)
recipient_code: recipient code (only for Italian customers)
province: province (only for Italian customers)

/plans/invoices/next

access: [READ]

This method returns the next upcoming invoice for the logged user and, if available, information about discounts that will applied.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/invoices/next

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "upcoming_amount_due": 9,
    "upcoming_invoice_date": "2026-06-26 14:00:32"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/invoices/next?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <upcoming_amount_due>9</upcoming_amount_due>  
    <upcoming_invoice_date>2026-06-26 14:00:32</upcoming_invoice_date>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/invoices/next?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_upcoming_amount_due=9
result_upcoming_invoice_date=2026-06-26 14:00:32

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/invoices/next?format=plain

Query parameters

format = plain

Response

9
2026-06-26 14:00:32

Return values

parameter	description
coupon_amount_off	discount amout that will applied to the invoice, if available
coupon_description	description for the coupon, if available
coupon_end	the date/time that the coupon will end, if available
coupon_id	coupon code that will applied to the invoice, if available
coupon_percent_off	percentage discount that will applied to the invoice, if available
coupon_start	date/time that the coupon was applied, if available
scheduled_amount_due	the amount of the next scheduled invoice (in case of a recent payment waiting to be completed)
scheduled_invoice_date	the date/time at which the scheduled invoice will be issued
upcoming_amount_due	the amount of the upcoming invoice
upcoming_invoice_date	the date/time at which the invoice will be issued

/plans/list

access: [READ]

This method returns a list of available plans for the current user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    {
      "id": "a98893ebf9ae24f1c7b566d91c8d413a",
      "is_preferred": 0,
      "name": "free",
      "reference_name": "",
      "annually_cost": 0,
      "monthly_cost": 0,
      "events_per_month": 1000,
      "tracking_links": 200,
      "stats_permanency_days": 30,
      "max_users": 1,
      "max_brands": 1,
      "has_smart_balancer": 0,
      "has_split_testing": 0,
      "has_smart_redirector": 0,
      "max_qrcode_templates": 1,
      "max_projects": 5,
      "has_conversions": 0,
      "has_timed_urls": 0,
      "force_brand_on_ctas": 1,
      "has_watchdog_ping": 1,
      "has_watchdog_advanced": 0,
      "number_of_ctas": "",
      "max_banners": 0,
      "custom_domains": 0,
      "email_support": 1,
      "priority_email_support": 0,
      "has_security_monitor": 0,
      "has_cfm": 0,
      "has_custom_aliases": 1,
      "has_masking": 0,
      "has_jotbar": 0,
      "has_custom_logo_in_reports": 0,
      "has_custom_css_cta": 0,
      "has_setup_assistance_and_training": 0,
      "has_custom_invoicing": 0,
      "has_enterprise_sla": 0,
      "has_customizations_and_integrations": 0,
      "has_digital_marketing_advice": 0,
      "trial_days": 0,
      "has_minipages": 0,
      "has_deeplinks": 0,
      "has_easydeeplinks": 0,
      "has_preview": 0,
      "public_name": "Free",
      "has_utm_builder": 0,
      "has_remarketing": 1,
      "has_whatsapp": 0,
      "has_instaurl": 0,
      "has_selfdestruction": 0,
      "user_profile": 0,
      "reserved_for_user": 0,
      "max_media": 0,
      "max_media_size": 0,
      "cdnbytes_per_month": 0
    },
    {
      "id": "afe48614e30cd41f46d0b30f4ce68501",
      "is_preferred": 0,
      "name": "growth",
      "reference_name": "",
      "annually_cost": 7,
      "monthly_cost": 9,
      "events_per_month": 5000,
      "tracking_links": 2000,
      "stats_permanency_days": 365,
      "max_users": 3,
      "max_brands": 5,
      "has_smart_balancer": 1,
      "has_split_testing": 1,
      "has_smart_redirector": 1,
      "max_qrcode_templates": 10,
      "max_projects": "",
      "has_conversions": 1,
      "has_timed_urls": 1,
      "force_brand_on_ctas": 0,
      "has_watchdog_ping": 1,
      "has_watchdog_advanced": 0,
      "number_of_ctas": "",
      "max_banners": "",
      "custom_domains": 3,
      "email_support": 1,
      "priority_email_support": 0,
      "has_security_monitor": 1,
      "has_cfm": 1,
      "has_custom_aliases": 1,
      "has_masking": 1,
      "has_jotbar": 1,
      "has_custom_logo_in_reports": 0,
      "has_custom_css_cta": 0,
      "has_setup_assistance_and_training": 0,
      "has_custom_invoicing": 0,
      "has_enterprise_sla": 0,
      "has_customizations_and_integrations": 0,
      "has_digital_marketing_advice": 0,
      "trial_days": 14,
      "has_minipages": 1,
      "has_deeplinks": 1,
      "has_easydeeplinks": 1,
      "has_preview": 1,
      "public_name": "Growth",
      "has_utm_builder": 1,
      "has_remarketing": 5,
      "has_whatsapp": 1,
      "has_instaurl": 0,
      "has_selfdestruction": 0,
      "user_profile": 0,
      "reserved_for_user": 0,
      "max_media": 100000,
      "max_media_size": 10000000,
      "cdnbytes_per_month": 100000000000
    }
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>
      <id>a98893ebf9ae24f1c7b566d91c8d413a</id>  
      <is_preferred>0</is_preferred>  
      <name>free</name>  
      <reference_name></reference_name>  
      <annually_cost>0</annually_cost>  
      <monthly_cost>0</monthly_cost>  
      <events_per_month>1000</events_per_month>  
      <tracking_links>200</tracking_links>  
      <stats_permanency_days>30</stats_permanency_days>  
      <max_users>1</max_users>  
      <max_brands>1</max_brands>  
      <has_smart_balancer>0</has_smart_balancer>  
      <has_split_testing>0</has_split_testing>  
      <has_smart_redirector>0</has_smart_redirector>  
      <max_qrcode_templates>1</max_qrcode_templates>  
      <max_projects>5</max_projects>  
      <has_conversions>0</has_conversions>  
      <has_timed_urls>0</has_timed_urls>  
      <force_brand_on_ctas>1</force_brand_on_ctas>  
      <has_watchdog_ping>1</has_watchdog_ping>  
      <has_watchdog_advanced>0</has_watchdog_advanced>  
      <number_of_ctas></number_of_ctas>  
      <max_banners>0</max_banners>  
      <custom_domains>0</custom_domains>  
      <email_support>1</email_support>  
      <priority_email_support>0</priority_email_support>  
      <has_security_monitor>0</has_security_monitor>  
      <has_cfm>0</has_cfm>  
      <has_custom_aliases>1</has_custom_aliases>  
      <has_masking>0</has_masking>  
      <has_jotbar>0</has_jotbar>  
      <has_custom_logo_in_reports>0</has_custom_logo_in_reports>  
      <has_custom_css_cta>0</has_custom_css_cta>  
      <has_setup_assistance_and_training>0</has_setup_assistance_and_training>  
      <has_custom_invoicing>0</has_custom_invoicing>  
      <has_enterprise_sla>0</has_enterprise_sla>  
      <has_customizations_and_integrations>0</has_customizations_and_integrations>  
      <has_digital_marketing_advice>0</has_digital_marketing_advice>  
      <trial_days>0</trial_days>  
      <has_minipages>0</has_minipages>  
      <has_deeplinks>0</has_deeplinks>  
      <has_easydeeplinks>0</has_easydeeplinks>  
      <has_preview>0</has_preview>  
      <public_name>Free</public_name>  
      <has_utm_builder>0</has_utm_builder>  
      <has_remarketing>1</has_remarketing>  
      <has_whatsapp>0</has_whatsapp>  
      <has_instaurl>0</has_instaurl>  
      <has_selfdestruction>0</has_selfdestruction>  
      <user_profile>0</user_profile>  
      <reserved_for_user>0</reserved_for_user>  
      <max_media>0</max_media>  
      <max_media_size>0</max_media_size>  
      <cdnbytes_per_month>0</cdnbytes_per_month>  
    </i0>  
    <i1>
      <id>afe48614e30cd41f46d0b30f4ce68501</id>  
      <is_preferred>0</is_preferred>  
      <name>growth</name>  
      <reference_name></reference_name>  
      <annually_cost>7</annually_cost>  
      <monthly_cost>9</monthly_cost>  
      <events_per_month>5000</events_per_month>  
      <tracking_links>2000</tracking_links>  
      <stats_permanency_days>365</stats_permanency_days>  
      <max_users>3</max_users>  
      <max_brands>5</max_brands>  
      <has_smart_balancer>1</has_smart_balancer>  
      <has_split_testing>1</has_split_testing>  
      <has_smart_redirector>1</has_smart_redirector>  
      <max_qrcode_templates>10</max_qrcode_templates>  
      <max_projects></max_projects>  
      <has_conversions>1</has_conversions>  
      <has_timed_urls>1</has_timed_urls>  
      <force_brand_on_ctas>0</force_brand_on_ctas>  
      <has_watchdog_ping>1</has_watchdog_ping>  
      <has_watchdog_advanced>0</has_watchdog_advanced>  
      <number_of_ctas></number_of_ctas>  
      <max_banners></max_banners>  
      <custom_domains>3</custom_domains>  
      <email_support>1</email_support>  
      <priority_email_support>0</priority_email_support>  
      <has_security_monitor>1</has_security_monitor>  
      <has_cfm>1</has_cfm>  
      <has_custom_aliases>1</has_custom_aliases>  
      <has_masking>1</has_masking>  
      <has_jotbar>1</has_jotbar>  
      <has_custom_logo_in_reports>0</has_custom_logo_in_reports>  
      <has_custom_css_cta>0</has_custom_css_cta>  
      <has_setup_assistance_and_training>0</has_setup_assistance_and_training>  
      <has_custom_invoicing>0</has_custom_invoicing>  
      <has_enterprise_sla>0</has_enterprise_sla>  
      <has_customizations_and_integrations>0</has_customizations_and_integrations>  
      <has_digital_marketing_advice>0</has_digital_marketing_advice>  
      <trial_days>14</trial_days>  
      <has_minipages>1</has_minipages>  
      <has_deeplinks>1</has_deeplinks>  
      <has_easydeeplinks>1</has_easydeeplinks>  
      <has_preview>1</has_preview>  
      <public_name>Growth</public_name>  
      <has_utm_builder>1</has_utm_builder>  
      <has_remarketing>5</has_remarketing>  
      <has_whatsapp>1</has_whatsapp>  
      <has_instaurl>0</has_instaurl>  
      <has_selfdestruction>0</has_selfdestruction>  
      <user_profile>0</user_profile>  
      <reserved_for_user>0</reserved_for_user>  
      <max_media>100000</max_media>  
      <max_media_size>10000000</max_media_size>  
      <cdnbytes_per_month>100000000000</cdnbytes_per_month>  
    </i1>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=a98893ebf9ae24f1c7b566d91c8d413a
result_0_is_preferred=0
result_0_name=free
result_0_reference_name=
result_0_annually_cost=0
result_0_monthly_cost=0
result_0_events_per_month=1000
result_0_tracking_links=200
result_0_stats_permanency_days=30
result_0_max_users=1
result_0_max_brands=1
result_0_has_smart_balancer=0
result_0_has_split_testing=0
result_0_has_smart_redirector=0
result_0_max_qrcode_templates=1
result_0_max_projects=5
result_0_has_conversions=0
result_0_has_timed_urls=0
result_0_force_brand_on_ctas=1
result_0_has_watchdog_ping=1
result_0_has_watchdog_advanced=0
result_0_number_of_ctas=
result_0_max_banners=0
result_0_custom_domains=0
result_0_email_support=1
result_0_priority_email_support=0
result_0_has_security_monitor=0
result_0_has_cfm=0
result_0_has_custom_aliases=1
result_0_has_masking=0
result_0_has_jotbar=0
result_0_has_custom_logo_in_reports=0
result_0_has_custom_css_cta=0
result_0_has_setup_assistance_and_training=0
result_0_has_custom_invoicing=0
result_0_has_enterprise_sla=0
result_0_has_customizations_and_integrations=0
result_0_has_digital_marketing_advice=0
result_0_trial_days=0
result_0_has_minipages=0
result_0_has_deeplinks=0
result_0_has_easydeeplinks=0
result_0_has_preview=0
result_0_public_name=Free
result_0_has_utm_builder=0
result_0_has_remarketing=1
result_0_has_whatsapp=0
result_0_has_instaurl=0
result_0_has_selfdestruction=0
result_0_user_profile=0
result_0_reserved_for_user=0
result_0_max_media=0
result_0_max_media_size=0
result_0_cdnbytes_per_month=0
result_1_id=afe48614e30cd41f46d0b30f4ce68501
result_1_is_preferred=0
result_1_name=growth
result_1_reference_name=
result_1_annually_cost=7
result_1_monthly_cost=9
result_1_events_per_month=5000
result_1_tracking_links=2000
result_1_stats_permanency_days=365
result_1_max_users=3
result_1_max_brands=5
result_1_has_smart_balancer=1
result_1_has_split_testing=1
result_1_has_smart_redirector=1
result_1_max_qrcode_templates=10
result_1_max_projects=
result_1_has_conversions=1
result_1_has_timed_urls=1
result_1_force_brand_on_ctas=0
result_1_has_watchdog_ping=1
result_1_has_watchdog_advanced=0
result_1_number_of_ctas=
result_1_max_banners=
result_1_custom_domains=3
result_1_email_support=1
result_1_priority_email_support=0
result_1_has_security_monitor=1
result_1_has_cfm=1
result_1_has_custom_aliases=1
result_1_has_masking=1
result_1_has_jotbar=1
result_1_has_custom_logo_in_reports=0
result_1_has_custom_css_cta=0
result_1_has_setup_assistance_and_training=0
result_1_has_custom_invoicing=0
result_1_has_enterprise_sla=0
result_1_has_customizations_and_integrations=0
result_1_has_digital_marketing_advice=0
result_1_trial_days=14
result_1_has_minipages=1
result_1_has_deeplinks=1
result_1_has_easydeeplinks=1
result_1_has_preview=1
result_1_public_name=Growth
result_1_has_utm_builder=1
result_1_has_remarketing=5
result_1_has_whatsapp=1
result_1_has_instaurl=0
result_1_has_selfdestruction=0
result_1_user_profile=0
result_1_reserved_for_user=0
result_1_max_media=100000
result_1_max_media_size=10000000
result_1_cdnbytes_per_month=100000000000

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/list?format=plain

Query parameters

format = plain

Response

a98893ebf9ae24f1c7b566d91c8d413a
0
free

0
0
1000
200
30
1
1
0
0
0
1
5
0
0
1
1
0

0
0
1
0
0
0
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
Free
0
1
0
0
0
0
0
0
0
0
afe48614e30cd41f46d0b30f4ce68501
0
growth

7
9
5000
2000
365
3
5
1
1
1
10

1
1
0
1
0


3
1
0
1
1
1
1
1
0
0
0
0
0
0
0
14
1
1
1
1
Growth
1
5
1
0
0
0
0
100000
10000000
100000000000

Optional parameters

parameter	description	max length
idID	filter by using the plan ID
is_preferredBOOLEAN	1 to return preferred plan(s)
nameSTRING	filter by using the plan name	150
public_nameSTRING	filter by using the plan user-friendly name	150

Return values

parameter	description
data	list of available plans for the current user

Available fields in data:

id: ID of the profile
name: name of the profile
public_name: user-friendly name of the profile
annually_cost: cost if paid annually
monthly_cost: cost per month if paid monthly
events_per_month: available events per month
tracking_links: maximum number of tracking links
stats_permanency_days: analytics are stored for this number of days
max_users: maximum number of users (including the admin user)
max_brands: maximum number of brands
has_smart_balancer: 1 if smart balanger is available, 0 otherwise
has_split_testing: 1 if split testing is available, 0 otherwise
has_smart_redirector: 1 if smart redirector is available, 0 otherwise
max_qrcode_templates: maximum number of QR-Code templates
has_conversions: 1 if conversions are available, 0 otherwise
has_timed_urls: 1 if timed urls is available, 0 otherwise
force_brand_on_ctas: 1 if the JotUrl brand is forced to be shown on CTAs, 0 otherwise
has_watchdog_ping: 1 if basic Watchdog is available, 0 otherwise
has_watchdog_advanced: 1 if advanced Watchdog is available, 0 otherwise
custom_domains: maximum number of custom domains
email_support: 1 if email support is available, 0 otherwise
priority_email_support: 1 if priority email support is available, 0 otherwise
has_security_monitor: 1 if security monitor is available, 0 otherwise
has_cfm: 1 if click fraud protection is available, 0 otherwise
has_custom_aliases: 1 if custom aliases are available, 0 otherwise
has_masking: 1 if masking is available, 0 otherwise
has_jotbar: 1 if JotBar is available, 0 otherwise
has_custom_logo_in_reports: 1 if custom logo in reports is available, 0 otherwise
has_custom_css_cta: 1 if custom CSS on CTAs is available, 0 otherwise
has_setup_assistance_and_training: 1 if setup assistance and training is available, 0 otherwise
has_custom_invoicing: 1 if custom invoicing is available, 0 otherwise
has_enterprise_sla: 1 if enterprise SLA is available, 0 otherwise
has_customizations_and_integrations: 1 if customizations and integrations is available, 0 otherwise
has_digital_marketing_advice: 1 if digital marketing advice is available, 0 otherwise
has_minipages: 1 if minipages are available, 0 otherwise
has_deeplinks: 1 if deep links are available, 0 otherwise
has_easydeeplinks: 1 if the option easy deep links is available, 0 otherwise
has_preview: 1 if link preview edit (Open Graph tags) is available, 0 otherwise
has_utm_builder: 1 if UTM builder is available, 0 otherwise
has_whatsapp: 1 if WhatsUrl is available, 0 otherwise
has_instaurl: 1 if JotBio (InstaUrl) is available, 0 otherwise
has_selfdestruction: 1 if the self destruction option is available, 0 otherwise
is_preferred: 1 if the profile is the best compromise cost/functionality
reference_name: if not empty, it is the name of the plan that is slitly different from some features
max_projects: maximum number of projects, empty means "unlimited"
number_of_ctas: maximum number of CTAs, empty means "unlimited"
max_banners: maximum number of banners, empty means "unlimited"
trial_days: number of trial days
has_remarketing: number of available remarketing pixels, empty means "unlimited", 0 means no remarketing pixels available
user_profile: 1 if the plan is already associated with the user, 0 otherwise
reserved_for_user: 1 if the plan is not public, but available for the user
max_media: maximum number of media in the media library
max_media_size: maximum size of the the media library (in bytes)
cdnbytes_per_month: available CDN bytes per month

/plans/payments

/plans/payments/add

access: [WRITE]

This method add a payment method.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/payments/add?nonce=48ff9cda04a2c910061bdcfa0e16c609

Query parameters

nonce = 48ff9cda04a2c910061bdcfa0e16c609

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/payments/add?nonce=48ff9cda04a2c910061bdcfa0e16c609&format=xml

Query parameters

 nonce = 48ff9cda04a2c910061bdcfa0e16c609
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/payments/add?nonce=48ff9cda04a2c910061bdcfa0e16c609&format=txt

Query parameters

 nonce = 48ff9cda04a2c910061bdcfa0e16c609
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/payments/add?nonce=48ff9cda04a2c910061bdcfa0e16c609&format=plain

Query parameters

 nonce = 48ff9cda04a2c910061bdcfa0e16c609
format = plain

Response

Required parameters

parameter	description
nonceSTRING	nonce that identifies the payment method, it comes from the payment gateway API

Optional parameters

parameter	description
forceBOOLEAN	force the attachment of the payment method

Return values

parameter	description
added	1 on success, 0 otherwise

/plans/payments/authorization

access: [READ]

This method returns an authorization code for the payment gateway.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/payments/authorization

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "secret": "e634e20670620f6b7b115152daaf3fd4",
    "authorization": "5acada48ae9d20aa4aa5f3fc058f12ce"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/payments/authorization?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <secret>e634e20670620f6b7b115152daaf3fd4</secret>  
    <authorization>5acada48ae9d20aa4aa5f3fc058f12ce</authorization>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/payments/authorization?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_secret=e634e20670620f6b7b115152daaf3fd4
result_authorization=5acada48ae9d20aa4aa5f3fc058f12ce

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/payments/authorization?format=plain

Query parameters

format = plain

Response

e634e20670620f6b7b115152daaf3fd4
5acada48ae9d20aa4aa5f3fc058f12ce

Return values

parameter	description
authorization	public API key of the payment gateway
secret	secret key for the Strong Customer Authentication (SCA)

/plans/payments/default

access: [WRITE]

This method make a payment method the default one.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/payments/default?token=79f23f7ab8ec40db935b0c029b6372c6

Query parameters

token = 79f23f7ab8ec40db935b0c029b6372c6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "default": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/payments/default?token=79f23f7ab8ec40db935b0c029b6372c6&format=xml

Query parameters

 token = 79f23f7ab8ec40db935b0c029b6372c6
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <default>1</default>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/payments/default?token=79f23f7ab8ec40db935b0c029b6372c6&format=txt

Query parameters

 token = 79f23f7ab8ec40db935b0c029b6372c6
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_default=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/payments/default?token=79f23f7ab8ec40db935b0c029b6372c6&format=plain

Query parameters

 token = 79f23f7ab8ec40db935b0c029b6372c6
format = plain

Response

default:1

Required parameters

parameter	description
tokenSTRING	token that uniquely identifies the payment method

Return values

parameter	description
default	1 on success, 0 otherwise

/plans/payments/delete

access: [WRITE]

This method deletes a payment method.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/payments/delete?token=916cfda008d68bba3310189a28d1d386

Query parameters

token = 916cfda008d68bba3310189a28d1d386

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/payments/delete?token=916cfda008d68bba3310189a28d1d386&format=xml

Query parameters

 token = 916cfda008d68bba3310189a28d1d386
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/payments/delete?token=916cfda008d68bba3310189a28d1d386&format=txt

Query parameters

 token = 916cfda008d68bba3310189a28d1d386
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/payments/delete?token=916cfda008d68bba3310189a28d1d386&format=plain

Query parameters

 token = 916cfda008d68bba3310189a28d1d386
format = plain

Response

Required parameters

parameter	description
tokenSTRING	token that uniquely identifies the payment method

Return values

parameter	description
deleted	1 on success, 0 otherwise

/plans/payments/paypals

/plans/payments/paypals/check

access: [WRITE]

This method checks a PayPal payment.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/payments/paypals/check?id=ed4f608c307d95c457c1bc3cce82ce23

Query parameters

id = ed4f608c307d95c457c1bc3cce82ce23

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "ed4f608c307d95c457c1bc3cce82ce23",
    "valid": 1,
    "total": 12.34,
    "currency": "EUR",
    "email": "this.is.your.email@pay.pal.com",
    "transaction_id": "9fec84ab0f6d46de09"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/payments/paypals/check?id=ed4f608c307d95c457c1bc3cce82ce23&format=xml

Query parameters

    id = ed4f608c307d95c457c1bc3cce82ce23
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>ed4f608c307d95c457c1bc3cce82ce23</id>  
    <valid>1</valid>  
    <total>12.34</total>  
    <currency>EUR</currency>  
    <email>this.is.your.email@pay.pal.com</email>  
    <transaction_id>9fec84ab0f6d46de09</transaction_id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/payments/paypals/check?id=ed4f608c307d95c457c1bc3cce82ce23&format=txt

Query parameters

    id = ed4f608c307d95c457c1bc3cce82ce23
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=ed4f608c307d95c457c1bc3cce82ce23
result_valid=1
result_total=12.34
result_currency=EUR
result_email=this.is.your.email@pay.pal.com
result_transaction_id=9fec84ab0f6d46de09

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/payments/paypals/check?id=ed4f608c307d95c457c1bc3cce82ce23&format=plain

Query parameters

    id = ed4f608c307d95c457c1bc3cce82ce23
format = plain

Response

ed4f608c307d95c457c1bc3cce82ce23
1
12.34
EUR
this.is.your.email@pay.pal.com
9fec84ab0f6d46de09

Required parameters

parameter	description
idSTRING	ID of the PayPal payment to check

Return values

parameter	description
currency	currency of the payment, see https://developer.paypal.com/docs/api/reference/currency-codes/ for a list of payment codes
id	echo back of the id input parameter
total	amount of the payment
valid	1 if the PayPal payment is valid, 0 otherwise

/plans/subscriptions

/plans/subscriptions/delete

access: [WRITE]

This method cancels the plan (main) subscription associated with the current user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/subscriptions/delete

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "canceled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/subscriptions/delete?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <canceled>1</canceled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/subscriptions/delete?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_canceled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/subscriptions/delete?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
canceled	1 on success (i.e., the subscription was canceled), 0 otherwise

/plans/subscriptions/estimate

access: [READ]

This method returns an estimate of the upcoming invoice for the logged user and, if available, information about discounts that will applied.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2026-06-26+14%3A00%3A32

Query parameters

start_datetime = 2026-06-26 14:00:32

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "estimate_amount_due": 9,
    "estimate_invoice_date": "2026-06-26 14:00:32",
    "estimate_coupon": "",
    "estimate_balance": 0,
    "current_balance": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2026-06-26+14%3A00%3A32&format=xml

Query parameters

start_datetime = 2026-06-26 14:00:32
        format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <estimate_amount_due>9</estimate_amount_due>  
    <estimate_invoice_date>2026-06-26 14:00:32</estimate_invoice_date>  
    <estimate_coupon></estimate_coupon>  
    <estimate_balance>0</estimate_balance>  
    <current_balance>0</current_balance>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2026-06-26+14%3A00%3A32&format=txt

Query parameters

start_datetime = 2026-06-26 14:00:32
        format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_estimate_amount_due=9
result_estimate_invoice_date=2026-06-26 14:00:32
result_estimate_coupon=
result_estimate_balance=0
result_current_balance=0

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2026-06-26+14%3A00%3A32&format=plain

Query parameters

start_datetime = 2026-06-26 14:00:32
        format = plain

Response

9
2026-06-26 14:00:32

0
0

Required parameters

parameter	description
idID	ID of the plan to switch to in the estimate
periodSTRING	the subscription billing period to be used in the estimate, it can be `monthly` or `annually`

Optional parameters

parameter	description
couponSTRING	coupon ID to be applied to calculate the estimate
planSTRING	NA
start_datetimeDATE_TIME	the estimate will be calculated as though the update was done at the specified date/time, if not specified, it will be equal to 3 minutes from the request

Return values

parameter	description
current_balance	user balance before the plan switch (negative means a credit, positive a debit)
estimate_amount_due	the amount of the estimate
estimate_balance	estimate user balance after the plan switch (negative means a credit, positive a debit)
estimate_coupon	coupon code applied to the estimate, if available
estimate_invoice_date	the date/time at which the estimate was calculated

/plans/subscriptions/info

access: [READ]

This method returns information about the user's subscription.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/subscriptions/info

Response

{
  "status": "ACTIVE",
  "balance": 0,
  "createdAt": "2018-08-13T23:16:14+02:00",
  "updatedAt": "2018-08-13T23:16:14+02:00",
  "nextBillingDate": "2018-12-27T11:58:57+01:00",
  "firstBillingDate": "2018-12-27T11:58:57+01:00",
  "billingPeriodEndDate": "2018-12-27T11:58:57+01:00",
  "trialPeriod": 0,
  "neverExpires": 1
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/subscriptions/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ACTIVE</status>  
  <balance>0</balance>  
  <createdAt>2018-08-13T23:16:14+02:00</createdAt>  
  <updatedAt>2018-08-13T23:16:14+02:00</updatedAt>  
  <nextBillingDate>2018-12-27T11:58:57+01:00</nextBillingDate>  
  <firstBillingDate>2018-12-27T11:58:57+01:00</firstBillingDate>  
  <billingPeriodEndDate>2018-12-27T11:58:57+01:00</billingPeriodEndDate>  
  <trialPeriod>0</trialPeriod>  
  <neverExpires>1</neverExpires>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/subscriptions/info?format=txt

Query parameters

format = txt

Response

status=ACTIVE
balance=0
createdAt=2018-08-13T23:16:14+02:00
updatedAt=2018-08-13T23:16:14+02:00
nextBillingDate=2018-12-27T11:58:57+01:00
firstBillingDate=2018-12-27T11:58:57+01:00
billingPeriodEndDate=2018-12-27T11:58:57+01:00
trialPeriod=0
neverExpires=1

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/subscriptions/info?format=plain

Query parameters

format = plain

Response

ACTIVE
0
2018-08-13T23:16:14+02:00
2018-08-13T23:16:14+02:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
0
1

Optional parameters

parameter	description
idSTRING	NA

Return values

parameter	description
balance	any remaining credit that will be used for future payments
billingPeriodEndDate	end of the current period that the subscription has been invoiced for; at the end of this period, a new invoice will be created
createdAt	time at which the subscription was created
firstBillingDate	date at which a new invoice will be generated for the subscription (for trialing subscriptions)
neverExpires	0 if the subscription is scheduled to be canceled at the end of the current billing period, 1 otherwise
nextBillingDate	date at which a new invoice will be generated for the subscription
status	subscription status, see notes for details
trialPeriod	1 if the subscription is in its trial period, 0 otherwise
updatedAt	time at which the subscription was updated

/plans/subscriptions/payment_link

access: [READ]

This method returns a payment link for a past due subscription.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/subscriptions/payment_link

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "payment_link": "https:\/\/payment.link.joturl.com\/"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/subscriptions/payment_link?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <payment_link>https://payment.link.joturl.com/</payment_link>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/subscriptions/payment_link?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_payment_link=https://payment.link.joturl.com/

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/subscriptions/payment_link?format=plain

Query parameters

format = plain

Response

https://payment.link.joturl.com/

Return values

parameter	description
payment_link	if available, the payment link to pay the last open invoice, empty string otherwise

/plans/subscriptions/set

access: [WRITE]

This method sets the primary subscription (plan) for the current user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=20cc5eddaeb3ebead84bc83aa55ce264&type=buy&period=monthly&id=a5c940539cf13a877d6fea5515620688&coupon=A1E4D5251AC247EAC7491805F426FE06

Query parameters

paypal = 0
 nonce = 20cc5eddaeb3ebead84bc83aa55ce264
  type = buy
period = monthly
    id = a5c940539cf13a877d6fea5515620688
coupon = A1E4D5251AC247EAC7491805F426FE06

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1,
    "nonce": "dc7e06d00c006c7358b80490ec143277cec72c85d10f8a5573c357c30a0af7ec",
    "ref": "bfb975b55fc6435ad369d4fcff069291c124c18db5b8041b47d55dae4c14a6fc427cbb1624819edcc61a4b53ab184c5e"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=20cc5eddaeb3ebead84bc83aa55ce264&type=buy&period=monthly&id=a5c940539cf13a877d6fea5515620688&coupon=A1E4D5251AC247EAC7491805F426FE06&format=xml

Query parameters

paypal = 0
 nonce = 20cc5eddaeb3ebead84bc83aa55ce264
  type = buy
period = monthly
    id = a5c940539cf13a877d6fea5515620688
coupon = A1E4D5251AC247EAC7491805F426FE06
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
    <nonce>dc7e06d00c006c7358b80490ec143277cec72c85d10f8a5573c357c30a0af7ec</nonce>  
    <ref>bfb975b55fc6435ad369d4fcff069291c124c18db5b8041b47d55dae4c14a6fc427cbb1624819edcc61a4b53ab184c5e</ref>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=20cc5eddaeb3ebead84bc83aa55ce264&type=buy&period=monthly&id=a5c940539cf13a877d6fea5515620688&coupon=A1E4D5251AC247EAC7491805F426FE06&format=txt

Query parameters

paypal = 0
 nonce = 20cc5eddaeb3ebead84bc83aa55ce264
  type = buy
period = monthly
    id = a5c940539cf13a877d6fea5515620688
coupon = A1E4D5251AC247EAC7491805F426FE06
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
result_nonce=dc7e06d00c006c7358b80490ec143277cec72c85d10f8a5573c357c30a0af7ec
result_ref=bfb975b55fc6435ad369d4fcff069291c124c18db5b8041b47d55dae4c14a6fc427cbb1624819edcc61a4b53ab184c5e

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=20cc5eddaeb3ebead84bc83aa55ce264&type=buy&period=monthly&id=a5c940539cf13a877d6fea5515620688&coupon=A1E4D5251AC247EAC7491805F426FE06&format=plain

Query parameters

paypal = 0
 nonce = 20cc5eddaeb3ebead84bc83aa55ce264
  type = buy
period = monthly
    id = a5c940539cf13a877d6fea5515620688
coupon = A1E4D5251AC247EAC7491805F426FE06
format = plain

Response

1
dc7e06d00c006c7358b80490ec143277cec72c85d10f8a5573c357c30a0af7ec
bfb975b55fc6435ad369d4fcff069291c124c18db5b8041b47d55dae4c14a6fc427cbb1624819edcc61a4b53ab184c5e

Required parameters

parameter	description
idID	ID of the plan to subscribe to
periodSTRING	the subscription billing period, it can be `monthly` or `annually`
typeSTRING	it can be `try` if you want to activate a trial period or `buy` if you want to buy a subscriptionn

Optional parameters

parameter	description
couponSTRING	coupon ID to be applied to the subscription
nonceSTRING	a unique disposable identifier used to identify the payment methods, this parameter is mandatory if a coupon code with 100% discount is not specified
paypalBOOLEAN	1 if PayPal was used to pay the subscription, 0 otherwise

Return values

parameter	description
added	1 if the subscription has been activated, 0 otherwise
nonce	unique identifier to be used where requested
ref	unique reference for the transaction to be used where requested

/plans/suggest

access: [READ]

This method suggests a plan suitable for the number of events generated by the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/suggest

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "estimated_events_per_month": 350000,
    "suggested_plan": {
      "id": "5520b73b606d0616273c5c8822b73fc3",
      "name": "business",
      "annually_cost": 135,
      "monthly_cost": 169,
      "events_per_month": 500000,
      "tracking_links": 100000,
      "stats_permanency_days": 730,
      "max_users": 30,
      "max_brands": 70,
      "has_smart_balancer": 1,
      "has_split_testing": 1,
      "has_smart_redirector": 1,
      "max_qrcode_templates": 100,
      "max_projects": "",
      "has_conversions": 1,
      "has_timed_urls": 1,
      "force_brand_on_ctas": 0,
      "has_watchdog_ping": 1,
      "has_watchdog_advanced": 1,
      "number_of_ctas": "",
      "max_banners": "",
      "custom_domains": 30,
      "email_support": 1,
      "priority_email_support": 1,
      "has_security_monitor": 1,
      "has_cfm": 1,
      "has_custom_aliases": 1,
      "has_masking": 1,
      "has_jotbar": 1,
      "has_custom_logo_in_reports": 1,
      "has_custom_css_cta": 1,
      "has_setup_assistance_and_training": 0,
      "has_custom_invoicing": 0,
      "has_enterprise_sla": 0,
      "has_customizations_and_integrations": 0,
      "has_digital_marketing_advice": 0,
      "has_minipages": 1,
      "has_deeplinks": 1,
      "has_easydeeplinks": 1,
      "has_preview": 1,
      "public_name": "Business",
      "has_utm_builder": 1,
      "max_utm_templates": 30,
      "has_remarketing": "",
      "has_whatsapp": 1,
      "has_instaurl": 0,
      "has_selfdestruction": 0,
      "is_monthly": 1,
      "status": "green",
      "trial_left_days": 30,
      "events": "",
      "is_monitored": 1,
      "email_sent": 0,
      "subscription_status": "ACTIVE",
      "subscription_creation": "2018-08-13T23:16:14+02:00",
      "subscription_next_billing_date": "2018-12-27T11:58:57+01:00",
      "subscription_billing_end_date": "2018-12-27T11:58:57+01:00",
      "subscription_never_expires": 1,
      "subscription_trial_period": 0,
      "subscription_first_billing_date": "2018-12-27T11:58:57+01:00",
      "subscription_balance": 0,
      "max_gdpr_templates": 10
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/suggest?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <estimated_events_per_month>350000</estimated_events_per_month>  
    <suggested_plan>
      <id>5520b73b606d0616273c5c8822b73fc3</id>  
      <name>business</name>  
      <annually_cost>135</annually_cost>  
      <monthly_cost>169</monthly_cost>  
      <events_per_month>500000</events_per_month>  
      <tracking_links>100000</tracking_links>  
      <stats_permanency_days>730</stats_permanency_days>  
      <max_users>30</max_users>  
      <max_brands>70</max_brands>  
      <has_smart_balancer>1</has_smart_balancer>  
      <has_split_testing>1</has_split_testing>  
      <has_smart_redirector>1</has_smart_redirector>  
      <max_qrcode_templates>100</max_qrcode_templates>  
      <max_projects></max_projects>  
      <has_conversions>1</has_conversions>  
      <has_timed_urls>1</has_timed_urls>  
      <force_brand_on_ctas>0</force_brand_on_ctas>  
      <has_watchdog_ping>1</has_watchdog_ping>  
      <has_watchdog_advanced>1</has_watchdog_advanced>  
      <number_of_ctas></number_of_ctas>  
      <max_banners></max_banners>  
      <custom_domains>30</custom_domains>  
      <email_support>1</email_support>  
      <priority_email_support>1</priority_email_support>  
      <has_security_monitor>1</has_security_monitor>  
      <has_cfm>1</has_cfm>  
      <has_custom_aliases>1</has_custom_aliases>  
      <has_masking>1</has_masking>  
      <has_jotbar>1</has_jotbar>  
      <has_custom_logo_in_reports>1</has_custom_logo_in_reports>  
      <has_custom_css_cta>1</has_custom_css_cta>  
      <has_setup_assistance_and_training>0</has_setup_assistance_and_training>  
      <has_custom_invoicing>0</has_custom_invoicing>  
      <has_enterprise_sla>0</has_enterprise_sla>  
      <has_customizations_and_integrations>0</has_customizations_and_integrations>  
      <has_digital_marketing_advice>0</has_digital_marketing_advice>  
      <has_minipages>1</has_minipages>  
      <has_deeplinks>1</has_deeplinks>  
      <has_easydeeplinks>1</has_easydeeplinks>  
      <has_preview>1</has_preview>  
      <public_name>Business</public_name>  
      <has_utm_builder>1</has_utm_builder>  
      <max_utm_templates>30</max_utm_templates>  
      <has_remarketing></has_remarketing>  
      <has_whatsapp>1</has_whatsapp>  
      <has_instaurl>0</has_instaurl>  
      <has_selfdestruction>0</has_selfdestruction>  
      <is_monthly>1</is_monthly>  
      <status>green</status>  
      <trial_left_days>30</trial_left_days>  
      <events></events>  
      <is_monitored>1</is_monitored>  
      <email_sent>0</email_sent>  
      <subscription_status>ACTIVE</subscription_status>  
      <subscription_creation>2018-08-13T23:16:14+02:00</subscription_creation>  
      <subscription_next_billing_date>2018-12-27T11:58:57+01:00</subscription_next_billing_date>  
      <subscription_billing_end_date>2018-12-27T11:58:57+01:00</subscription_billing_end_date>  
      <subscription_never_expires>1</subscription_never_expires>  
      <subscription_trial_period>0</subscription_trial_period>  
      <subscription_first_billing_date>2018-12-27T11:58:57+01:00</subscription_first_billing_date>  
      <subscription_balance>0</subscription_balance>  
      <max_gdpr_templates>10</max_gdpr_templates>  
    </suggested_plan>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/suggest?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_estimated_events_per_month=350000
result_suggested_plan_id=5520b73b606d0616273c5c8822b73fc3
result_suggested_plan_name=business
result_suggested_plan_annually_cost=135
result_suggested_plan_monthly_cost=169
result_suggested_plan_events_per_month=500000
result_suggested_plan_tracking_links=100000
result_suggested_plan_stats_permanency_days=730
result_suggested_plan_max_users=30
result_suggested_plan_max_brands=70
result_suggested_plan_has_smart_balancer=1
result_suggested_plan_has_split_testing=1
result_suggested_plan_has_smart_redirector=1
result_suggested_plan_max_qrcode_templates=100
result_suggested_plan_max_projects=
result_suggested_plan_has_conversions=1
result_suggested_plan_has_timed_urls=1
result_suggested_plan_force_brand_on_ctas=0
result_suggested_plan_has_watchdog_ping=1
result_suggested_plan_has_watchdog_advanced=1
result_suggested_plan_number_of_ctas=
result_suggested_plan_max_banners=
result_suggested_plan_custom_domains=30
result_suggested_plan_email_support=1
result_suggested_plan_priority_email_support=1
result_suggested_plan_has_security_monitor=1
result_suggested_plan_has_cfm=1
result_suggested_plan_has_custom_aliases=1
result_suggested_plan_has_masking=1
result_suggested_plan_has_jotbar=1
result_suggested_plan_has_custom_logo_in_reports=1
result_suggested_plan_has_custom_css_cta=1
result_suggested_plan_has_setup_assistance_and_training=0
result_suggested_plan_has_custom_invoicing=0
result_suggested_plan_has_enterprise_sla=0
result_suggested_plan_has_customizations_and_integrations=0
result_suggested_plan_has_digital_marketing_advice=0
result_suggested_plan_has_minipages=1
result_suggested_plan_has_deeplinks=1
result_suggested_plan_has_easydeeplinks=1
result_suggested_plan_has_preview=1
result_suggested_plan_public_name=Business
result_suggested_plan_has_utm_builder=1
result_suggested_plan_max_utm_templates=30
result_suggested_plan_has_remarketing=
result_suggested_plan_has_whatsapp=1
result_suggested_plan_has_instaurl=0
result_suggested_plan_has_selfdestruction=0
result_suggested_plan_is_monthly=1
result_suggested_plan_status=green
result_suggested_plan_trial_left_days=30
result_suggested_plan_events=
result_suggested_plan_is_monitored=1
result_suggested_plan_email_sent=0
result_suggested_plan_subscription_status=ACTIVE
result_suggested_plan_subscription_creation=2018-08-13T23:16:14+02:00
result_suggested_plan_subscription_next_billing_date=2018-12-27T11:58:57+01:00
result_suggested_plan_subscription_billing_end_date=2018-12-27T11:58:57+01:00
result_suggested_plan_subscription_never_expires=1
result_suggested_plan_subscription_trial_period=0
result_suggested_plan_subscription_first_billing_date=2018-12-27T11:58:57+01:00
result_suggested_plan_subscription_balance=0
result_suggested_plan_max_gdpr_templates=10

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/suggest?format=plain

Query parameters

format = plain

Response

350000
5520b73b606d0616273c5c8822b73fc3
business
135
169
500000
100000
730
30
70
1
1
1
100

1
1
0
1
1


30
1
1
1
1
1
1
1
1
1
0
0
0
0
0
1
1
1
1
Business
1
30

1
0
0
1
green
30

1
0
ACTIVE
2018-08-13T23:16:14+02:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
1
0
2018-12-27T11:58:57+01:00
0
10

Return values

parameter	description
estimated_events_per_month	estimated events per month
suggested_plan	[OPTIONAL] array containing info for the suggested plan, it is returned only if this method can find a suitable plan for the user

/plans/update

access: [READ]

This method updates information about the user's plan. It should be called after a change of the user plan.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/update

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "new_plan": "Basic",
    "old_plan": "Basic"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/update?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <new_plan>Basic</new_plan>  
    <old_plan>Basic</old_plan>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/update?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_new_plan=Basic
result_old_plan=Basic

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/update?format=plain

Query parameters

format = plain

Response

Basic
Basic

Return values

parameter	description
new_plan	the new plan name for the user, it can be the equal to old_plan if no change takes place
old_plan	the old plan name for the user

/plans/vats

/plans/vats/property

access: [READ]

This method returns the list of available VAT treatments.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/plans/vats/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "ITALY_PRIVATE",
    "ITALY_BUSINESS",
    "INTRA_EU_PRIVATE",
    "INTRA_EU_BUSINESS",
    "EXTRA_EU_PRIVATE",
    "EXTRA_EU_BUSINESS"
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/plans/vats/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>ITALY_PRIVATE</i0>  
    <i1>ITALY_BUSINESS</i1>  
    <i2>INTRA_EU_PRIVATE</i2>  
    <i3>INTRA_EU_BUSINESS</i3>  
    <i4>EXTRA_EU_PRIVATE</i4>  
    <i5>EXTRA_EU_BUSINESS</i5>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/plans/vats/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=ITALY_PRIVATE
result_1=ITALY_BUSINESS
result_2=INTRA_EU_PRIVATE
result_3=INTRA_EU_BUSINESS
result_4=EXTRA_EU_PRIVATE
result_5=EXTRA_EU_BUSINESS

Example 4 (plain)

Request

https://joturl.com/a/i1/plans/vats/property?format=plain

Query parameters

format = plain

Response

ITALY_PRIVATE
ITALY_BUSINESS
INTRA_EU_PRIVATE
INTRA_EU_BUSINESS
EXTRA_EU_PRIVATE
EXTRA_EU_BUSINESS

Return values

parameter	description
[ARRAY]	array of available VAT treatment

/projects

/projects/add

access: [WRITE]

Add a project with a specified name.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1

Query parameters

              name = name for the project name
            client = this is a sample note
has_utm_parameters = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "b294c4c1bb47b9504f62e201c878376f",
    "name": "name for the project name",
    "client": "this is a sample note",
    "has_utm_parameters": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1&format=xml

Query parameters

              name = name for the project name
            client = this is a sample note
has_utm_parameters = 1
            format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>b294c4c1bb47b9504f62e201c878376f</id>  
    <name>name for the project name</name>  
    <client>this is a sample note</client>  
    <has_utm_parameters>1</has_utm_parameters>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1&format=txt

Query parameters

              name = name for the project name
            client = this is a sample note
has_utm_parameters = 1
            format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=b294c4c1bb47b9504f62e201c878376f
result_name=name for the project name
result_client=this is a sample note
result_has_utm_parameters=1

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1&format=plain

Query parameters

              name = name for the project name
            client = this is a sample note
has_utm_parameters = 1
            format = plain

Response

b294c4c1bb47b9504f62e201c878376f
name for the project name
this is a sample note
1

Required parameters

parameter	description	max length
nameSTRING	project name	255

Optional parameters

parameter	description	max length
clientSTRING	name of the client to whom the project is dedicated and/or the notes for the project	255
has_utm_parametersBOOLEAN	1 to enable the UTM view, 0 otherwise

Return values

parameter	description
client	echo back of the `client` parameter
id	ID of the project
name	echo back of the `name` parameter

/projects/count

access: [READ]

This method returns the number of user's projects.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 97
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>97</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=97

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
accountSTRING	if 1 this methods returns the total number of projects (other parameters are ignored)
end_dateSTRING	filter projects created up to this date (inclusive)
searchSTRING	filter projects by searching them
start_dateSTRING	filter projects created from this date (inclusive)
with_alertsBOOLEAN	filter projects with security alerts

Return values

parameter	description
count	number of projects

/projects/defaults

/projects/defaults/get

access: [READ]

Get a default setting for the project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/defaults/get?project_id=c4f394d249ce7584964b630c6fee7ed3&setting=default_tl

Query parameters

project_id = c4f394d249ce7584964b630c6fee7ed3
   setting = default_tl

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "value": "57d3158f2a3ca02f74a4c8208948ccf8"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/defaults/get?project_id=c4f394d249ce7584964b630c6fee7ed3&setting=default_tl&format=xml

Query parameters

project_id = c4f394d249ce7584964b630c6fee7ed3
   setting = default_tl
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <value>57d3158f2a3ca02f74a4c8208948ccf8</value>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/defaults/get?project_id=c4f394d249ce7584964b630c6fee7ed3&setting=default_tl&format=txt

Query parameters

project_id = c4f394d249ce7584964b630c6fee7ed3
   setting = default_tl
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_value=57d3158f2a3ca02f74a4c8208948ccf8

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/defaults/get?project_id=c4f394d249ce7584964b630c6fee7ed3&setting=default_tl&format=plain

Query parameters

project_id = c4f394d249ce7584964b630c6fee7ed3
   setting = default_tl
    format = plain

Response

57d3158f2a3ca02f74a4c8208948ccf8

Required parameters

parameter	description	max length
project_idID	ID of the project
settingSTRING	setting to obtain, see i1/projects/defaults/set for details	50

Return values

parameter	description
value	the value of the required setting

/projects/defaults/set

access: [WRITE]

Set/unset a default setting for the project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/defaults/set?project_id=6e56e96e75070648d4172f06bb20b9a0&setting=default_tl&value=06664f76e4a93fcc31c3310a55feddf4

Query parameters

project_id = 6e56e96e75070648d4172f06bb20b9a0
   setting = default_tl
     value = 06664f76e4a93fcc31c3310a55feddf4

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "set": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/defaults/set?project_id=6e56e96e75070648d4172f06bb20b9a0&setting=default_tl&value=06664f76e4a93fcc31c3310a55feddf4&format=xml

Query parameters

project_id = 6e56e96e75070648d4172f06bb20b9a0
   setting = default_tl
     value = 06664f76e4a93fcc31c3310a55feddf4
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <set>1</set>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/defaults/set?project_id=6e56e96e75070648d4172f06bb20b9a0&setting=default_tl&value=06664f76e4a93fcc31c3310a55feddf4&format=txt

Query parameters

project_id = 6e56e96e75070648d4172f06bb20b9a0
   setting = default_tl
     value = 06664f76e4a93fcc31c3310a55feddf4
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_set=1

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/defaults/set?project_id=6e56e96e75070648d4172f06bb20b9a0&setting=default_tl&value=06664f76e4a93fcc31c3310a55feddf4&format=plain

Query parameters

project_id = 6e56e96e75070648d4172f06bb20b9a0
   setting = default_tl
     value = 06664f76e4a93fcc31c3310a55feddf4
    format = plain

Response

Required parameters

parameter	description	max length
project_idID	ID of the project
settingSTRING	setting to be set/unset, settings available: `default_tl`, `default_domain`	50

Optional parameters

parameter	description	max length
valueID	the value to be setted, empty to unset	50

Return values

parameter	description
set	1 on set, 0 otherwise

/projects/delete

access: [WRITE]

This method deletes a set of projects using the ids. Return 1 if the operation succeeds or 0 otherwise.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/delete?ids=36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3

Query parameters

ids = 36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/delete?ids=36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3&format=xml

Query parameters

   ids = 36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/delete?ids=36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3&format=txt

Query parameters

   ids = 36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/delete?ids=36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3&format=plain

Query parameters

   ids = 36a232a97f692e7f32ad5e8d2acad007,4c0f08c4aea09a2d8b9cca8fbadfff00,19df99b3a73247fcbf8dfc6b8b78efe3
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/projects/delete?ids=0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880

Query parameters

ids = 0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": [
      "3747f807a1e5844e5734e31bf85b8688",
      "76b269b9c834cb0471c71f835177d880"
    ],
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/projects/delete?ids=0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880&format=xml

Query parameters

   ids = 0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>
      <i0>3747f807a1e5844e5734e31bf85b8688</i0>  
      <i1>76b269b9c834cb0471c71f835177d880</i1>  
    </ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/projects/delete?ids=0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880&format=txt

Query parameters

   ids = 0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=3747f807a1e5844e5734e31bf85b8688
result_ids_1=76b269b9c834cb0471c71f835177d880
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/projects/delete?ids=0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880&format=plain

Query parameters

   ids = 0defd533d51ed0a10c5c9dbf93ee78a5,3747f807a1e5844e5734e31bf85b8688,76b269b9c834cb0471c71f835177d880
format = plain

Response

3747f807a1e5844e5734e31bf85b8688
76b269b9c834cb0471c71f835177d880
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of project IDs to be deleted

Return values

parameter	description
deleted	number of deleted projects
ids	[OPTIONAL] list of project IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/projects/edit

access: [WRITE]

Edit a project data for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/edit?id=2c6c9ac86d34fc159d3d1efd20d50b18&name=new+name+for+the+project&client=new+notes+for+the+project

Query parameters

    id = 2c6c9ac86d34fc159d3d1efd20d50b18
  name = new name for the project
client = new notes for the project

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "2c6c9ac86d34fc159d3d1efd20d50b18",
    "name": "new name for the project",
    "client": "new notes for the project"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/edit?id=2c6c9ac86d34fc159d3d1efd20d50b18&name=new+name+for+the+project&client=new+notes+for+the+project&format=xml

Query parameters

    id = 2c6c9ac86d34fc159d3d1efd20d50b18
  name = new name for the project
client = new notes for the project
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>2c6c9ac86d34fc159d3d1efd20d50b18</id>  
    <name>new name for the project</name>  
    <client>new notes for the project</client>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/edit?id=2c6c9ac86d34fc159d3d1efd20d50b18&name=new+name+for+the+project&client=new+notes+for+the+project&format=txt

Query parameters

    id = 2c6c9ac86d34fc159d3d1efd20d50b18
  name = new name for the project
client = new notes for the project
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=2c6c9ac86d34fc159d3d1efd20d50b18
result_name=new name for the project
result_client=new notes for the project

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/edit?id=2c6c9ac86d34fc159d3d1efd20d50b18&name=new+name+for+the+project&client=new+notes+for+the+project&format=plain

Query parameters

    id = 2c6c9ac86d34fc159d3d1efd20d50b18
  name = new name for the project
client = new notes for the project
format = plain

Response

2c6c9ac86d34fc159d3d1efd20d50b18
new name for the project
new notes for the project

Required parameters

parameter	description
idID	ID of the project

Optional parameters

parameter	description	max length
clientSTRING	new name of the client to whom the project is dedicated and/or new notes for the project	255
has_utm_parametersBOOLEAN	1 to enable the UTM view, 0 otherwise
nameSTRING	new name for the project	255

Return values

parameter	description
client	[OPTIONAL] echo back of the name of the client to whom the project is dedicated and/or the notes for the project
has_utm_parameters	[OPTIONAL] echo back of `has_utm_parameters` parameter
id	ID of the project
name	[OPTIONAL] echo back of the name of the project

/projects/info

access: [READ]

This method returns information on a project, the returned information depends on input parameter fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/info?id=d48c0392210f0326e0081d1a99df45fa&fields=name,id

Query parameters

    id = d48c0392210f0326e0081d1a99df45fa
fields = name,id

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "project 1",
    "id": "d48c0392210f0326e0081d1a99df45fa"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/info?id=d48c0392210f0326e0081d1a99df45fa&fields=name,id&format=xml

Query parameters

    id = d48c0392210f0326e0081d1a99df45fa
fields = name,id
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>project 1</name>  
    <id>d48c0392210f0326e0081d1a99df45fa</id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/info?id=d48c0392210f0326e0081d1a99df45fa&fields=name,id&format=txt

Query parameters

    id = d48c0392210f0326e0081d1a99df45fa
fields = name,id
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=project 1
result_id=d48c0392210f0326e0081d1a99df45fa

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/info?id=d48c0392210f0326e0081d1a99df45fa&fields=name,id&format=plain

Query parameters

    id = d48c0392210f0326e0081d1a99df45fa
fields = name,id
format = plain

Response

project 1
d48c0392210f0326e0081d1a99df45fa

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: name, client, id, creation, urls_count, conversions_visits, remarketings_visits, ctas_visits, qrcodes_visits, unique_visits, visits, has_utm_parameters, is_default
idID	ID of the project

Return values

parameter	description
client	[OPTIONAL] name of the client to whom the project is dedicated and/or the notes for the project
conversions_visits	[OPTIONAL] number of conversions clicks on tracking links in the project
creation	[OPTIONAL] date of creation of the project
ctas_visits	[OPTIONAL] number of CTA clicks on tracking links in the project
has_utm_parameters	[OPTIONAL] 1 if the project has UTM view enabled, 0 otherwise
id	[OPTIONAL] ID of the project
is_default	[OPTIONAL] 1 if it is the `default` project, 0 otherwise
name	[OPTIONAL] name of the project
qrcodes_visits	[OPTIONAL] number of visits on tracking links in the project coming from QR codes
remarketings_visits	[OPTIONAL] number of remarketings clicks on tracking links in the project
unique_visits	[OPTIONAL] number of unique visits on tracking links in the project
urls_count	[OPTIONAL] number of tracking links in the project
visits	[OPTIONAL] number of visits on tracking links in the project

/projects/jotbars

/projects/jotbars/edit

access: [WRITE]

Set a jotbar option for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/jotbars/edit?id=d636026ffdd39d81a3070105f76a84db&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D

Query parameters

                   id = d636026ffdd39d81a3070105f76a84db
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/jotbars/edit?id=d636026ffdd39d81a3070105f76a84db&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=xml

Query parameters

                   id = d636026ffdd39d81a3070105f76a84db
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
               format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/jotbars/edit?id=d636026ffdd39d81a3070105f76a84db&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=txt

Query parameters

                   id = d636026ffdd39d81a3070105f76a84db
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
               format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/jotbars/edit?id=d636026ffdd39d81a3070105f76a84db&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=plain

Query parameters

                   id = d636026ffdd39d81a3070105f76a84db
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
               format = plain

Response

Required parameters

parameter	description
idID	ID of the project
languagesARRAY	comma-separated list of the languages selected for the jotbar, the jotbar will be shown to the user in the language the user has chosen in his/hers browser, if the user has an unsupported language the default language will be used (i.e., default_language if not empty, user_default_language otherwise)

Optional parameters

parameter	description
default_languageSTRING	default language within languages, empty or `null` to inherit the configuration from the account-level settings
infoJSON	JSON containing page_title, description_title, description, questions_title, questions for each language in languages, see i1/projects/jotbars/info for details on info
logoSTRING	it can be:

0 to disable logo
the URL of the logo to be shown
empty or null to inherit the configuration from the account-level settings logo_urlSTRING|when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo show_feedbackSTRING|1 to show feedback, 0 to do not show it, empty or null to inherit the configuration from the account-level settings templateSTRING|position of the jotbar, empty or null to inherit the configuration from the account-level settings, for available positions see i1/jotbars/property template_sizeSTRING|dimension of the jotbar, empty or null to inherit the configuration from the account-level settings,for available dimensions see i1/jotbars/property

Return values

parameter	description
updated	1 on success, 0 otherwise

/projects/jotbars/info

access: [READ]

Get jotbar information for the project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/jotbars/info?id=d039d2ab13080e17fab48e4167c88987

Query parameters

id = d039d2ab13080e17fab48e4167c88987

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "logo": "https:\/\/joturl.com\/logo.svg",
    "logo_url": "https:\/\/joturl.com\/",
    "template": "right",
    "template_size": "big",
    "show_feedback": null,
    "languages": "en,it",
    "default_language": "",
    "user_default_language": "en",
    "info": {
      "en": {
        "page_title": "English page title",
        "description_title": null,
        "description": "<p>[EN] HTML description<\/p>",
        "questions_title": null,
        "questions": "<p>[EN] HTML questions<\/p>"
      },
      "it": {
        "page_title": "Titolo pagina in italiano",
        "description_title": null,
        "description": "<p>[IT] HTML description<\/p>",
        "questions_title": null,
        "questions": "<p>[IT] HTML questions<\/p>"
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/jotbars/info?id=d039d2ab13080e17fab48e4167c88987&format=xml

Query parameters

    id = d039d2ab13080e17fab48e4167c88987
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <logo>https://joturl.com/logo.svg</logo>  
    <logo_url>https://joturl.com/</logo_url>  
    <template>right</template>  
    <template_size>big</template_size>  
    <show_feedback></show_feedback>  
    <languages>en,it</languages>  
    <default_language></default_language>  
    <user_default_language>en</user_default_language>  
    <info>
      <en>
        <page_title>English page title</page_title>  
        <description_title></description_title>  
        <description><[CDATA[&lt;p&gt;[EN] HTML description&lt;/p&gt;]]></description>  
        <questions_title></questions_title>  
        <questions><[CDATA[&lt;p&gt;[EN] HTML questions&lt;/p&gt;]]></questions>  
      </en>  
      <it>
        <page_title>Titolo pagina in italiano</page_title>  
        <description_title></description_title>  
        <description><[CDATA[&lt;p&gt;[IT] HTML description&lt;/p&gt;]]></description>  
        <questions_title></questions_title>  
        <questions><[CDATA[&lt;p&gt;[IT] HTML questions&lt;/p&gt;]]></questions>  
      </it>  
    </info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/jotbars/info?id=d039d2ab13080e17fab48e4167c88987&format=txt

Query parameters

    id = d039d2ab13080e17fab48e4167c88987
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_logo=https://joturl.com/logo.svg
result_logo_url=https://joturl.com/
result_template=right
result_template_size=big
result_show_feedback=
result_languages=en,it
result_default_language=
result_user_default_language=en
result_info_en_page_title=English page title
result_info_en_description_title=
result_info_en_description=&lt;p&gt;[EN] HTML description&lt;/p&gt;
result_info_en_questions_title=
result_info_en_questions=&lt;p&gt;[EN] HTML questions&lt;/p&gt;
result_info_it_page_title=Titolo pagina in italiano
result_info_it_description_title=
result_info_it_description=&lt;p&gt;[IT] HTML description&lt;/p&gt;
result_info_it_questions_title=
result_info_it_questions=&lt;p&gt;[IT] HTML questions&lt;/p&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/jotbars/info?id=d039d2ab13080e17fab48e4167c88987&format=plain

Query parameters

    id = d039d2ab13080e17fab48e4167c88987
format = plain

Response

https://joturl.com/logo.svg
https://joturl.com/
right
big

en,it

en
English page title

&lt;p&gt;[EN] HTML description&lt;/p&gt;

&lt;p&gt;[EN] HTML questions&lt;/p&gt;
Titolo pagina in italiano

&lt;p&gt;[IT] HTML description&lt;/p&gt;

&lt;p&gt;[IT] HTML questions&lt;/p&gt;

Required parameters

parameter	description
idID	ID of the project

Return values

parameter	description
default_language	default language within languages, empty or `null` to inherit the configuration from the account-level settings
info	for each language in languages, it contains page_title, description_title, description, questions_title, questions, see the following notes for details
languages	comma-separated list of the languages selected for the jotbar, the jotbar will be shown to the user in the language the user has chosen in his/hers browser, if the user has an unsupported language the default language will be used (i.e., default_language if not empty, user_default_language otherwise)
logo	it can be:

0 to disable logo
the URL of the logo to be shown
empty or null to inherit the configuration from the account-level settings logo_url|when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo show_feedback|1 to show feedback, 0 to do not show it, empty or null to inherit the configuration from the account-level settings template|position of the jotbar, empty or null to inherit the configuration from the account-level settings, for available positions see i1/jotbars/property template_size|dimension of the jotbar, empty or null to inherit the configuration from the account-level settings,for available dimensions see i1/jotbars/property user_default_language|account-level default language

/projects/languages

/projects/languages/list

access: [READ]

This method returns a list of available languages for specific options (e.g., jotBar) of a project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/languages/list?id=765e9f841cbd5d55c8da1db575d2b91c

Query parameters

id = 765e9f841cbd5d55c8da1db575d2b91c

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "languages": [
      {
        "name": "en",
        "label": "English"
      },
      {
        "name": "it",
        "label": "Italiano"
      }
    ],
    "selected": [
      "en",
      "it"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/languages/list?id=765e9f841cbd5d55c8da1db575d2b91c&format=xml

Query parameters

    id = 765e9f841cbd5d55c8da1db575d2b91c
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <languages>
      <i0>
        <name>en</name>  
        <label>English</label>  
      </i0>  
      <i1>
        <name>it</name>  
        <label>Italiano</label>  
      </i1>  
    </languages>  
    <selected>
      <i0>en</i0>  
      <i1>it</i1>  
    </selected>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/languages/list?id=765e9f841cbd5d55c8da1db575d2b91c&format=txt

Query parameters

    id = 765e9f841cbd5d55c8da1db575d2b91c
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_languages_0_name=en
result_languages_0_label=English
result_languages_1_name=it
result_languages_1_label=Italiano
result_selected_0=en
result_selected_1=it

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/languages/list?id=765e9f841cbd5d55c8da1db575d2b91c&format=plain

Query parameters

    id = 765e9f841cbd5d55c8da1db575d2b91c
format = plain

Response

en
English
it
Italiano
en
it

Required parameters

parameter	description
idID	ID of the project

Return values

parameter	description
languages	available languages
selected	array of names of enabled languages

/projects/list

access: [READ]

This method returns a list of projects data, specified in a comma separated input called fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/list?fields=name,id

Query parameters

fields = name,id

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "name": "project 1",
        "id": "9b65d24c1a4074e6a6f9abef62336666"
      },
      {
        "name": "project 2",
        "id": "2d60192d57d99d754befa1cacb826605"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/list?fields=name,id&format=xml

Query parameters

fields = name,id
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <name>project 1</name>  
        <id>9b65d24c1a4074e6a6f9abef62336666</id>  
      </i0>  
      <i1>
        <name>project 2</name>  
        <id>2d60192d57d99d754befa1cacb826605</id>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/list?fields=name,id&format=txt

Query parameters

fields = name,id
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_name=project 1
result_data_0_id=9b65d24c1a4074e6a6f9abef62336666
result_data_1_name=project 2
result_data_1_id=2d60192d57d99d754befa1cacb826605

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/list?fields=name,id&format=plain

Query parameters

fields = name,id
format = plain

Response

project 1
9b65d24c1a4074e6a6f9abef62336666
project 2
2d60192d57d99d754befa1cacb826605

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: client, conversions_visits, creation, ctas_visits, has_utm_parameters, id, name, qrcodes_visits, remarketings_visits, unique_visits, urls_count, visits, is_default, count

Optional parameters

parameter	description
creatorSTRING	filter projects by creator, available values: `ID`, `all`, `me`, `others`, only available for administrator users, see notes for details
end_dateSTRING	filter projects created up to this date (inclusive)
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: client, conversions_visits, creation, ctas_visits, has_utm_parameters, id, name, qrcodes_visits, remarketings_visits, unique_visits, urls_count, visits, is_default
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position
start_dateSTRING	filter projects created from this date (inclusive)
subuser_idID	ID of the team member, when passed the field `has_access` is returned for each project, `has_access = 1` if the team member has access to the project, `has_access = 0` otherwise
whereSTRING	to be used in conjunction with search, specifies where to search and it can be `both`, `projects` or `links`; `where = projects`: search for projects matching the name or the notes (default); `where = links`: search for tracking links matching the short url or the destination URL `where = both`: search for both tracking links and projects;
with_alertsBOOLEAN	filter projects with security alerts

Return values

parameter	description
count	[OPTIONAL] total number of projects, returned only if count is passed in fields
data	array containing required information on projects the user has access to

Available fields in the data array:

name: name of the project
client: name of the client to whom the project is dedicated and/or the notes for the project
id: ID of the project
creation: date of creation of the project
urls_count: number of tracking links in the project
conversions_visits: number of conversions clicks on tracking links in the project
remarketings_visits: number of remarketings clicks on tracking links in the project
ctas_visits: number of CTA clicks on tracking links in the project
qrcodes_visits: number of visits on tracking links in the project coming from QR codes
unique_visits: number of unique visits on tracking links in the project
visits: number of visits on tracking links in the project
has_utm_parameters: 1 if the project has UTM view enabled, 0 otherwise
is_default: 1 if it is the default project, 0 otherwise

/projects/options

/projects/options/info

access: [READ]

Returns the list of available options for a specific project. Further, this method returns the exclusion list and active options.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/options/info?id=ce75b825e053d608bf3f76b14a800a10

Query parameters

id = ce75b825e053d608bf3f76b14a800a10

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "options": [
      "users",
      "jotbar",
      "defaults"
    ],
    "exclusions": [],
    "disabled": [],
    "active": [
      "defaults"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/options/info?id=ce75b825e053d608bf3f76b14a800a10&format=xml

Query parameters

    id = ce75b825e053d608bf3f76b14a800a10
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <options>
      <i0>users</i0>  
      <i1>jotbar</i1>  
      <i2>defaults</i2>  
    </options>  
    <exclusions>

    </exclusions>  
    <disabled>

    </disabled>  
    <active>
      <i0>defaults</i0>  
    </active>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/options/info?id=ce75b825e053d608bf3f76b14a800a10&format=txt

Query parameters

    id = ce75b825e053d608bf3f76b14a800a10
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_options_0=users
result_options_1=jotbar
result_options_2=defaults
result_exclusions=
result_disabled=
result_active_0=defaults

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/options/info?id=ce75b825e053d608bf3f76b14a800a10&format=plain

Query parameters

    id = ce75b825e053d608bf3f76b14a800a10
format = plain

Response

users
jotbar
defaults


defaults

Required parameters

parameter	description
idID	ID of the project

Return values

parameter	description
active	currently active options for the project
disabled	disabled options for the project
exclusions	exclusion map between options, a list of pairs (option, list of incompatible options)
options	available options for the project

/projects/subusers

/projects/subusers/grant

access: [WRITE]

Grants access to the project to specified team members.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/subusers/grant?id=88bb6178cc47a607c83b377e9494558d&add_ids=2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25&delete_ids=cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9

Query parameters

        id = 88bb6178cc47a607c83b377e9494558d
   add_ids = 2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25
delete_ids = cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 3,
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/subusers/grant?id=88bb6178cc47a607c83b377e9494558d&add_ids=2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25&delete_ids=cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9&format=xml

Query parameters

        id = 88bb6178cc47a607c83b377e9494558d
   add_ids = 2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25
delete_ids = cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>3</added>  
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/subusers/grant?id=88bb6178cc47a607c83b377e9494558d&add_ids=2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25&delete_ids=cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9&format=txt

Query parameters

        id = 88bb6178cc47a607c83b377e9494558d
   add_ids = 2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25
delete_ids = cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=3
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/subusers/grant?id=88bb6178cc47a607c83b377e9494558d&add_ids=2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25&delete_ids=cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9&format=plain

Query parameters

        id = 88bb6178cc47a607c83b377e9494558d
   add_ids = 2ec39777c3bb347fc2717eca68b1ead5,c8d51ba2eae085f3b1b40e4d7a5b8e3b,e91d1109d19c33bb8a68becaf1819c25
delete_ids = cfa448c8ecefd9fffe6a93984ca0d811,ab20a099f688c26e6d068cf9a4877032,5cf7e928d62a2a883f5dabaa48b8feb9
    format = plain

Response

3
3

Required parameters

parameter	description
idID	ID of the project

Optional parameters

parameter	description
add_idsARRAY_OF_IDS	comma-separated list of team members to grant access to the project
delete_idsARRAY_OF_IDS	comma-separated list of team members to deny access to the project

Return values

parameter	description
added	number of team members who have been granted access to the project
deleted	number of team members who were denied access to the project

/projects/watchdogs

/projects/watchdogs/alerts

/projects/watchdogs/alerts/delete

access: [WRITE]

Reset watchdog alerts for a given array of project IDs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb

Query parameters

ids = 7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 9,
    "ids": [
      "7d334e01aea951ca32921baa8b01803b",
      "3f1b894253dce96289dd0e076b60e1a9",
      "ebf02cc1d31a5657be1e9e3217f2b6bb"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb&format=xml

Query parameters

   ids = 7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>9</count>  
    <ids>
      <i0>7d334e01aea951ca32921baa8b01803b</i0>  
      <i1>3f1b894253dce96289dd0e076b60e1a9</i1>  
      <i2>ebf02cc1d31a5657be1e9e3217f2b6bb</i2>  
    </ids>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb&format=txt

Query parameters

   ids = 7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=9
result_ids_0=7d334e01aea951ca32921baa8b01803b
result_ids_1=3f1b894253dce96289dd0e076b60e1a9
result_ids_2=ebf02cc1d31a5657be1e9e3217f2b6bb

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb&format=plain

Query parameters

   ids = 7d334e01aea951ca32921baa8b01803b,3f1b894253dce96289dd0e076b60e1a9,ebf02cc1d31a5657be1e9e3217f2b6bb
format = plain

Response

9
7d334e01aea951ca32921baa8b01803b
3f1b894253dce96289dd0e076b60e1a9
ebf02cc1d31a5657be1e9e3217f2b6bb

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of project IDs

Return values

parameter	description
count	number of resetted alerts, a maximum of 10000 alerts will be processed
ids	array containing IDs passed in the ids input parameter

/projects/webhooks

/projects/webhooks/info

access: [READ]

This method return information on a webhook.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/webhooks/info?id=4a160f2f8ef12c6dd4ab9fbcce857279

Query parameters

id = 4a160f2f8ef12c6dd4ab9fbcce857279

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "4a160f2f8ef12c6dd4ab9fbcce857279",
    "url": "https:\/\/my.custom.webhook\/",
    "type": "custom",
    "info": [],
    "notes": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/webhooks/info?id=4a160f2f8ef12c6dd4ab9fbcce857279&format=xml

Query parameters

    id = 4a160f2f8ef12c6dd4ab9fbcce857279
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>4a160f2f8ef12c6dd4ab9fbcce857279</id>  
    <url>https://my.custom.webhook/</url>  
    <type>custom</type>  
    <info>

    </info>  
    <notes></notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/webhooks/info?id=4a160f2f8ef12c6dd4ab9fbcce857279&format=txt

Query parameters

    id = 4a160f2f8ef12c6dd4ab9fbcce857279
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=4a160f2f8ef12c6dd4ab9fbcce857279
result_url=https://my.custom.webhook/
result_type=custom
result_info=
result_notes=

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/webhooks/info?id=4a160f2f8ef12c6dd4ab9fbcce857279&format=plain

Query parameters

    id = 4a160f2f8ef12c6dd4ab9fbcce857279
format = plain

Response

4a160f2f8ef12c6dd4ab9fbcce857279
https://my.custom.webhook/
custom

Required parameters

parameter	description
idID	ID of the project from which to remove the webhook

Return values

parameter	description
id	echo back of the `id` input parameter
info	extended info of the webhook
notes	notes for the webhook
type	webhook type, see i1/ctas/webhooks/property for details
url	URL of the webhook

/projects/webhooks/property

access: [READ]

Return available webhook types and their parameters.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier

Query parameters

types = custom,zapier

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "custom": {
        "name": "Custom webhook",
        "private": 0,
        "url_required": 1,
        "info": {
          "home": "https:\/\/joturl.zendesk.com\/hc\/en-us\/articles\/360012882199",
          "logo": "data:image\/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg=="
        },
        "parameters": [
          {
            "name": "fields",
            "type": "json",
            "maxlength": 2000,
            "description": "couples key\/values",
            "mandatory": 0,
            "example": "{\"source\":\"joturl\",\"test\":1}"
          }
        ]
      },
      "zapier": {
        "name": "Zapier",
        "private": 1,
        "url_required": 0,
        "info": {
          "home": "https:\/\/zapier.com\/",
          "logo": "https:\/\/cdn.zapier.com\/zapier\/images\/logos\/zapier-logo.png"
        },
        "parameters": []
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier&format=xml

Query parameters

 types = custom,zapier
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <custom>
        <name>Custom webhook</name>  
        <private>0</private>  
        <url_required>1</url_required>  
        <info>
          <home>https://joturl.zendesk.com/hc/en-us/articles/360012882199</home>  
          <logo>data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==</logo>  
        </info>  
        <parameters>
          <i0>
            <name>fields</name>  
            <type>json</type>  
            <maxlength>2000</maxlength>  
            <description>couples key/values</description>  
            <mandatory>0</mandatory>  
            <example>{"source":"joturl","test":1}</example>  
          </i0>  
        </parameters>  
      </custom>  
      <zapier>
        <name>Zapier</name>  
        <private>1</private>  
        <url_required>0</url_required>  
        <info>
          <home>https://zapier.com/</home>  
          <logo>https://cdn.zapier.com/zapier/images/logos/zapier-logo.png</logo>  
        </info>  
        <parameters>

        </parameters>  
      </zapier>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier&format=txt

Query parameters

 types = custom,zapier
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_custom_name=Custom webhook
result_data_custom_private=0
result_data_custom_url_required=1
result_data_custom_info_home=https://joturl.zendesk.com/hc/en-us/articles/360012882199
result_data_custom_info_logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
result_data_custom_parameters_0_name=fields
result_data_custom_parameters_0_type=json
result_data_custom_parameters_0_maxlength=2000
result_data_custom_parameters_0_description=couples key/values
result_data_custom_parameters_0_mandatory=0
result_data_custom_parameters_0_example={"source":"joturl","test":1}
result_data_zapier_name=Zapier
result_data_zapier_private=1
result_data_zapier_url_required=0
result_data_zapier_info_home=https://zapier.com/
result_data_zapier_info_logo=https://cdn.zapier.com/zapier/images/logos/zapier-logo.png
result_data_zapier_parameters=

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier&format=plain

Query parameters

 types = custom,zapier
format = plain

Response

Custom webhook
0
1
https://joturl.zendesk.com/hc/en-us/articles/360012882199
data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
fields
json
2000
couples key/values
0
{"source":"joturl","test":1}
Zapier
1
0
https://zapier.com/
https://cdn.zapier.com/zapier/images/logos/zapier-logo.png

Optional parameters

parameter	description
typesSTRING	comma-separated list of webhook types to be returned, if empty all types are returned, available types: `custom`, `zapier`

Return values

parameter	description
data	array containing information on webhook parameters by type

Check the following tables for information on webhook parameters by type.

Custom webhook type = custom

name	description	help	mandatory	type	max length	example
fields	couples key/values		No	json	2000	{"source":"joturl","test":1}

Zapier type = zapier

This type of webhook cannot be directly subscribed, please use our Zapier integration.

access: [WRITE]

This method add a webhook subscription to a project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/webhooks/subscribe?id=4c623b6cf618ffa5ac76ff2c6d1bad57&url=https%3A%2F%2Fjoturl.com%2F

Query parameters

 id = 4c623b6cf618ffa5ac76ff2c6d1bad57
url = https://joturl.com/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/webhooks/subscribe?id=4c623b6cf618ffa5ac76ff2c6d1bad57&url=https%3A%2F%2Fjoturl.com%2F&format=xml

Query parameters

    id = 4c623b6cf618ffa5ac76ff2c6d1bad57
   url = https://joturl.com/
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/webhooks/subscribe?id=4c623b6cf618ffa5ac76ff2c6d1bad57&url=https%3A%2F%2Fjoturl.com%2F&format=txt

Query parameters

    id = 4c623b6cf618ffa5ac76ff2c6d1bad57
   url = https://joturl.com/
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/webhooks/subscribe?id=4c623b6cf618ffa5ac76ff2c6d1bad57&url=https%3A%2F%2Fjoturl.com%2F&format=plain

Query parameters

    id = 4c623b6cf618ffa5ac76ff2c6d1bad57
   url = https://joturl.com/
format = plain

Response

Required parameters

parameter	description
idID	ID of the project to which to add the webhook
typeSTRING	webhook type, allowed types: `custom`, `zapier`

Optional parameters

parameter	description	max length
infoJSON	info to be used with the webhook (e.g., an API key), see below for details
notesSTRING	notes for the webhook	4000
unsubscribeBOOLEAN	1 to unsubscribe from the current webhook (if any) and subscribe to the new one
urlSTRING	URL of the webhook, required for types: `custom`, `zapier`	4000

Return values

parameter	description
added	1 on success, 0 otherwise

/projects/webhooks/test

access: [WRITE]

This endpoint sends test data to a project webhook.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/webhooks/test?id=6f288aafc62cc5d816c8f5d8eff35eb6

Query parameters

id = 6f288aafc62cc5d816c8f5d8eff35eb6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ok": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/webhooks/test?id=6f288aafc62cc5d816c8f5d8eff35eb6&format=xml

Query parameters

    id = 6f288aafc62cc5d816c8f5d8eff35eb6
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ok>1</ok>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/webhooks/test?id=6f288aafc62cc5d816c8f5d8eff35eb6&format=txt

Query parameters

    id = 6f288aafc62cc5d816c8f5d8eff35eb6
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/webhooks/test?id=6f288aafc62cc5d816c8f5d8eff35eb6&format=plain

Query parameters

    id = 6f288aafc62cc5d816c8f5d8eff35eb6
format = plain

Response

Required parameters

parameter	description
idID	ID of the project associated with the webhook

Return values

parameter	description
ok	1 on success, otherwise an error is returned

/projects/webhooks/unsubscribe

access: [WRITE]

This method removes a webhook subscription to a project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=36159230c90c227fc778a3e45c222d41

Query parameters

id = 36159230c90c227fc778a3e45c222d41

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "removed": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=36159230c90c227fc778a3e45c222d41&format=xml

Query parameters

    id = 36159230c90c227fc778a3e45c222d41
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <removed>1</removed>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=36159230c90c227fc778a3e45c222d41&format=txt

Query parameters

    id = 36159230c90c227fc778a3e45c222d41
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_removed=1

Example 4 (plain)

Request

https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=36159230c90c227fc778a3e45c222d41&format=plain

Query parameters

    id = 36159230c90c227fc778a3e45c222d41
format = plain

Response

Required parameters

parameter	description
idID	ID of the project from which to remove the webhook

Return values

parameter	description
removed	1 on success, 0 otherwise

/provinces

/provinces/list

access: [READ]

This method returns a list of available Italian provinces.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/provinces/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "provinces": [
      {
        "label": "Agrigento",
        "code": "AG"
      },
      {
        "label": "Alessandria",
        "code": "AL"
      },
      {
        "label": "Ancona",
        "code": "AN"
      },
      {
        "label": "Aosta",
        "code": "AO"
      },
      {
        "label": "Arezzo",
        "code": "AR"
      },
      {
        "label": "Ascoli Piceno",
        "code": "AP"
      },
      {
        "label": "Asti",
        "code": "AT"
      },
      {
        "label": "Avellino",
        "code": "AV"
      },
      {
        "label": "Barletta-Andria-Trani",
        "code": "BT"
      },
      {
        "label": "Belluno",
        "code": "BL"
      },
      {
        "label": "Benevento",
        "code": "BN"
      },
      {
        "label": "Bergamo",
        "code": "BG"
      },
      {
        "label": "Biella",
        "code": "BI"
      },
      {
        "label": "Bolzano",
        "code": "BZ"
      },
      {
        "label": "Brescia",
        "code": "BS"
      },
      {
        "label": "Brindisi",
        "code": "BR"
      },
      {
        "label": "Caltanissetta",
        "code": "CL"
      },
      {
        "label": "Campobasso",
        "code": "CB"
      },
      {
        "label": "Caserta",
        "code": "CE"
      },
      {
        "label": "Catanzaro",
        "code": "CZ"
      },
      {
        "label": "Chieti",
        "code": "CH"
      },
      {
        "label": "Como",
        "code": "CO"
      },
      {
        "label": "Cosenza",
        "code": "CS"
      },
      {
        "label": "Cremona",
        "code": "CR"
      },
      {
        "label": "Crotone",
        "code": "KR"
      },
      {
        "label": "Cuneo",
        "code": "CN"
      },
      {
        "label": "Enna",
        "code": "EN"
      },
      {
        "label": "Fermo",
        "code": "FM"
      },
      {
        "label": "Ferrara",
        "code": "FE"
      },
      {
        "label": "Foggia",
        "code": "FG"
      },
      {
        "label": "Forlì-Cesena",
        "code": "FC"
      },
      {
        "label": "Frosinone",
        "code": "FR"
      },
      {
        "label": "Gorizia",
        "code": "GO"
      },
      {
        "label": "Grosseto",
        "code": "GR"
      },
      {
        "label": "Imperia",
        "code": "IM"
      },
      {
        "label": "Isernia",
        "code": "IS"
      },
      {
        "label": "L'Aquila",
        "code": "AQ"
      },
      {
        "label": "LaSpezia",
        "code": "SP"
      },
      {
        "label": "Latina",
        "code": "LT"
      },
      {
        "label": "Lecce",
        "code": "LE"
      },
      {
        "label": "Lecco",
        "code": "LC"
      },
      {
        "label": "Livorno",
        "code": "LI"
      },
      {
        "label": "Lodi",
        "code": "LO"
      },
      {
        "label": "Lucca",
        "code": "LU"
      },
      {
        "label": "Macerata",
        "code": "MC"
      },
      {
        "label": "Mantova",
        "code": "MN"
      },
      {
        "label": "Massa-Carrara",
        "code": "MS"
      },
      {
        "label": "Matera",
        "code": "MT"
      },
      {
        "label": "Modena",
        "code": "MO"
      },
      {
        "label": "Monzae Brianza",
        "code": "MB"
      },
      {
        "label": "Novara",
        "code": "NO"
      },
      {
        "label": "Nuoro",
        "code": "NU"
      },
      {
        "label": "Oristano",
        "code": "OR"
      },
      {
        "label": "Padova",
        "code": "PD"
      },
      {
        "label": "Parma",
        "code": "PR"
      },
      {
        "label": "Pavia",
        "code": "PV"
      },
      {
        "label": "Perugia",
        "code": "PG"
      },
      {
        "label": "Pesaro e Urbino",
        "code": "PU"
      },
      {
        "label": "Pescara",
        "code": "PE"
      },
      {
        "label": "Piacenza",
        "code": "PC"
      },
      {
        "label": "Pisa",
        "code": "PI"
      },
      {
        "label": "Pistoia",
        "code": "PT"
      },
      {
        "label": "Pordenone",
        "code": "PN"
      },
      {
        "label": "Potenza",
        "code": "PZ"
      },
      {
        "label": "Prato",
        "code": "PO"
      },
      {
        "label": "Ragusa",
        "code": "RG"
      },
      {
        "label": "Ravenna",
        "code": "RA"
      },
      {
        "label": "Reggio Emilia",
        "code": "RE"
      },
      {
        "label": "Rieti",
        "code": "RI"
      },
      {
        "label": "Rimini",
        "code": "RN"
      },
      {
        "label": "Rovigo",
        "code": "RO"
      },
      {
        "label": "Salerno",
        "code": "SA"
      },
      {
        "label": "Sassari",
        "code": "SS"
      },
      {
        "label": "Savona",
        "code": "SV"
      },
      {
        "label": "Siena",
        "code": "SI"
      },
      {
        "label": "Siracusa",
        "code": "SR"
      },
      {
        "label": "Sondrio",
        "code": "SO"
      },
      {
        "label": "Sud Sardegna",
        "code": "SU"
      },
      {
        "label": "Taranto",
        "code": "TA"
      },
      {
        "label": "Teramo",
        "code": "TE"
      },
      {
        "label": "Terni",
        "code": "TR"
      },
      {
        "label": "Trapani",
        "code": "TP"
      },
      {
        "label": "Trento",
        "code": "TN"
      },
      {
        "label": "Treviso",
        "code": "TV"
      },
      {
        "label": "Trieste",
        "code": "TS"
      },
      {
        "label": "Udine",
        "code": "UD"
      },
      {
        "label": "Varese",
        "code": "VA"
      },
      {
        "label": "Verbano-Cusio-Ossola",
        "code": "VB"
      },
      {
        "label": "Vercelli",
        "code": "VC"
      },
      {
        "label": "Verona",
        "code": "VR"
      },
      {
        "label": "Vibo Valentia",
        "code": "VV"
      },
      {
        "label": "Vicenza",
        "code": "VI"
      },
      {
        "label": "Viterbo",
        "code": "VT"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/provinces/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <provinces>
      <i0>
        <label>Agrigento</label>  
        <code>AG</code>  
      </i0>  
      <i1>
        <label>Alessandria</label>  
        <code>AL</code>  
      </i1>  
      <i2>
        <label>Ancona</label>  
        <code>AN</code>  
      </i2>  
      <i3>
        <label>Aosta</label>  
        <code>AO</code>  
      </i3>  
      <i4>
        <label>Arezzo</label>  
        <code>AR</code>  
      </i4>  
      <i5>
        <label>Ascoli Piceno</label>  
        <code>AP</code>  
      </i5>  
      <i6>
        <label>Asti</label>  
        <code>AT</code>  
      </i6>  
      <i7>
        <label>Avellino</label>  
        <code>AV</code>  
      </i7>  
      <i8>
        <label>Barletta-Andria-Trani</label>  
        <code>BT</code>  
      </i8>  
      <i9>
        <label>Belluno</label>  
        <code>BL</code>  
      </i9>  
      <i10>
        <label>Benevento</label>  
        <code>BN</code>  
      </i10>  
      <i11>
        <label>Bergamo</label>  
        <code>BG</code>  
      </i11>  
      <i12>
        <label>Biella</label>  
        <code>BI</code>  
      </i12>  
      <i13>
        <label>Bolzano</label>  
        <code>BZ</code>  
      </i13>  
      <i14>
        <label>Brescia</label>  
        <code>BS</code>  
      </i14>  
      <i15>
        <label>Brindisi</label>  
        <code>BR</code>  
      </i15>  
      <i16>
        <label>Caltanissetta</label>  
        <code>CL</code>  
      </i16>  
      <i17>
        <label>Campobasso</label>  
        <code>CB</code>  
      </i17>  
      <i18>
        <label>Caserta</label>  
        <code>CE</code>  
      </i18>  
      <i19>
        <label>Catanzaro</label>  
        <code>CZ</code>  
      </i19>  
      <i20>
        <label>Chieti</label>  
        <code>CH</code>  
      </i20>  
      <i21>
        <label>Como</label>  
        <code>CO</code>  
      </i21>  
      <i22>
        <label>Cosenza</label>  
        <code>CS</code>  
      </i22>  
      <i23>
        <label>Cremona</label>  
        <code>CR</code>  
      </i23>  
      <i24>
        <label>Crotone</label>  
        <code>KR</code>  
      </i24>  
      <i25>
        <label>Cuneo</label>  
        <code>CN</code>  
      </i25>  
      <i26>
        <label>Enna</label>  
        <code>EN</code>  
      </i26>  
      <i27>
        <label>Fermo</label>  
        <code>FM</code>  
      </i27>  
      <i28>
        <label>Ferrara</label>  
        <code>FE</code>  
      </i28>  
      <i29>
        <label>Foggia</label>  
        <code>FG</code>  
      </i29>  
      <i30>
        <label><[CDATA[Forl&igrave;-Cesena]]></label>  
        <code>FC</code>  
      </i30>  
      <i31>
        <label>Frosinone</label>  
        <code>FR</code>  
      </i31>  
      <i32>
        <label>Gorizia</label>  
        <code>GO</code>  
      </i32>  
      <i33>
        <label>Grosseto</label>  
        <code>GR</code>  
      </i33>  
      <i34>
        <label>Imperia</label>  
        <code>IM</code>  
      </i34>  
      <i35>
        <label>Isernia</label>  
        <code>IS</code>  
      </i35>  
      <i36>
        <label>L'Aquila</label>  
        <code>AQ</code>  
      </i36>  
      <i37>
        <label>LaSpezia</label>  
        <code>SP</code>  
      </i37>  
      <i38>
        <label>Latina</label>  
        <code>LT</code>  
      </i38>  
      <i39>
        <label>Lecce</label>  
        <code>LE</code>  
      </i39>  
      <i40>
        <label>Lecco</label>  
        <code>LC</code>  
      </i40>  
      <i41>
        <label>Livorno</label>  
        <code>LI</code>  
      </i41>  
      <i42>
        <label>Lodi</label>  
        <code>LO</code>  
      </i42>  
      <i43>
        <label>Lucca</label>  
        <code>LU</code>  
      </i43>  
      <i44>
        <label>Macerata</label>  
        <code>MC</code>  
      </i44>  
      <i45>
        <label>Mantova</label>  
        <code>MN</code>  
      </i45>  
      <i46>
        <label>Massa-Carrara</label>  
        <code>MS</code>  
      </i46>  
      <i47>
        <label>Matera</label>  
        <code>MT</code>  
      </i47>  
      <i48>
        <label>Modena</label>  
        <code>MO</code>  
      </i48>  
      <i49>
        <label>Monzae Brianza</label>  
        <code>MB</code>  
      </i49>  
      <i50>
        <label>Novara</label>  
        <code>NO</code>  
      </i50>  
      <i51>
        <label>Nuoro</label>  
        <code>NU</code>  
      </i51>  
      <i52>
        <label>Oristano</label>  
        <code>OR</code>  
      </i52>  
      <i53>
        <label>Padova</label>  
        <code>PD</code>  
      </i53>  
      <i54>
        <label>Parma</label>  
        <code>PR</code>  
      </i54>  
      <i55>
        <label>Pavia</label>  
        <code>PV</code>  
      </i55>  
      <i56>
        <label>Perugia</label>  
        <code>PG</code>  
      </i56>  
      <i57>
        <label>Pesaro e Urbino</label>  
        <code>PU</code>  
      </i57>  
      <i58>
        <label>Pescara</label>  
        <code>PE</code>  
      </i58>  
      <i59>
        <label>Piacenza</label>  
        <code>PC</code>  
      </i59>  
      <i60>
        <label>Pisa</label>  
        <code>PI</code>  
      </i60>  
      <i61>
        <label>Pistoia</label>  
        <code>PT</code>  
      </i61>  
      <i62>
        <label>Pordenone</label>  
        <code>PN</code>  
      </i62>  
      <i63>
        <label>Potenza</label>  
        <code>PZ</code>  
      </i63>  
      <i64>
        <label>Prato</label>  
        <code>PO</code>  
      </i64>  
      <i65>
        <label>Ragusa</label>  
        <code>RG</code>  
      </i65>  
      <i66>
        <label>Ravenna</label>  
        <code>RA</code>  
      </i66>  
      <i67>
        <label>Reggio Emilia</label>  
        <code>RE</code>  
      </i67>  
      <i68>
        <label>Rieti</label>  
        <code>RI</code>  
      </i68>  
      <i69>
        <label>Rimini</label>  
        <code>RN</code>  
      </i69>  
      <i70>
        <label>Rovigo</label>  
        <code>RO</code>  
      </i70>  
      <i71>
        <label>Salerno</label>  
        <code>SA</code>  
      </i71>  
      <i72>
        <label>Sassari</label>  
        <code>SS</code>  
      </i72>  
      <i73>
        <label>Savona</label>  
        <code>SV</code>  
      </i73>  
      <i74>
        <label>Siena</label>  
        <code>SI</code>  
      </i74>  
      <i75>
        <label>Siracusa</label>  
        <code>SR</code>  
      </i75>  
      <i76>
        <label>Sondrio</label>  
        <code>SO</code>  
      </i76>  
      <i77>
        <label>Sud Sardegna</label>  
        <code>SU</code>  
      </i77>  
      <i78>
        <label>Taranto</label>  
        <code>TA</code>  
      </i78>  
      <i79>
        <label>Teramo</label>  
        <code>TE</code>  
      </i79>  
      <i80>
        <label>Terni</label>  
        <code>TR</code>  
      </i80>  
      <i81>
        <label>Trapani</label>  
        <code>TP</code>  
      </i81>  
      <i82>
        <label>Trento</label>  
        <code>TN</code>  
      </i82>  
      <i83>
        <label>Treviso</label>  
        <code>TV</code>  
      </i83>  
      <i84>
        <label>Trieste</label>  
        <code>TS</code>  
      </i84>  
      <i85>
        <label>Udine</label>  
        <code>UD</code>  
      </i85>  
      <i86>
        <label>Varese</label>  
        <code>VA</code>  
      </i86>  
      <i87>
        <label>Verbano-Cusio-Ossola</label>  
        <code>VB</code>  
      </i87>  
      <i88>
        <label>Vercelli</label>  
        <code>VC</code>  
      </i88>  
      <i89>
        <label>Verona</label>  
        <code>VR</code>  
      </i89>  
      <i90>
        <label>Vibo Valentia</label>  
        <code>VV</code>  
      </i90>  
      <i91>
        <label>Vicenza</label>  
        <code>VI</code>  
      </i91>  
      <i92>
        <label>Viterbo</label>  
        <code>VT</code>  
      </i92>  
    </provinces>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/provinces/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_provinces_0_label=Agrigento
result_provinces_0_code=AG
result_provinces_1_label=Alessandria
result_provinces_1_code=AL
result_provinces_2_label=Ancona
result_provinces_2_code=AN
result_provinces_3_label=Aosta
result_provinces_3_code=AO
result_provinces_4_label=Arezzo
result_provinces_4_code=AR
result_provinces_5_label=Ascoli Piceno
result_provinces_5_code=AP
result_provinces_6_label=Asti
result_provinces_6_code=AT
result_provinces_7_label=Avellino
result_provinces_7_code=AV
result_provinces_8_label=Barletta-Andria-Trani
result_provinces_8_code=BT
result_provinces_9_label=Belluno
result_provinces_9_code=BL
result_provinces_10_label=Benevento
result_provinces_10_code=BN
result_provinces_11_label=Bergamo
result_provinces_11_code=BG
result_provinces_12_label=Biella
result_provinces_12_code=BI
result_provinces_13_label=Bolzano
result_provinces_13_code=BZ
result_provinces_14_label=Brescia
result_provinces_14_code=BS
result_provinces_15_label=Brindisi
result_provinces_15_code=BR
result_provinces_16_label=Caltanissetta
result_provinces_16_code=CL
result_provinces_17_label=Campobasso
result_provinces_17_code=CB
result_provinces_18_label=Caserta
result_provinces_18_code=CE
result_provinces_19_label=Catanzaro
result_provinces_19_code=CZ
result_provinces_20_label=Chieti
result_provinces_20_code=CH
result_provinces_21_label=Como
result_provinces_21_code=CO
result_provinces_22_label=Cosenza
result_provinces_22_code=CS
result_provinces_23_label=Cremona
result_provinces_23_code=CR
result_provinces_24_label=Crotone
result_provinces_24_code=KR
result_provinces_25_label=Cuneo
result_provinces_25_code=CN
result_provinces_26_label=Enna
result_provinces_26_code=EN
result_provinces_27_label=Fermo
result_provinces_27_code=FM
result_provinces_28_label=Ferrara
result_provinces_28_code=FE
result_provinces_29_label=Foggia
result_provinces_29_code=FG
result_provinces_30_label=Forl&igrave;-Cesena
result_provinces_30_code=FC
result_provinces_31_label=Frosinone
result_provinces_31_code=FR
result_provinces_32_label=Gorizia
result_provinces_32_code=GO
result_provinces_33_label=Grosseto
result_provinces_33_code=GR
result_provinces_34_label=Imperia
result_provinces_34_code=IM
result_provinces_35_label=Isernia
result_provinces_35_code=IS
result_provinces_36_label=L'Aquila
result_provinces_36_code=AQ
result_provinces_37_label=LaSpezia
result_provinces_37_code=SP
result_provinces_38_label=Latina
result_provinces_38_code=LT
result_provinces_39_label=Lecce
result_provinces_39_code=LE
result_provinces_40_label=Lecco
result_provinces_40_code=LC
result_provinces_41_label=Livorno
result_provinces_41_code=LI
result_provinces_42_label=Lodi
result_provinces_42_code=LO
result_provinces_43_label=Lucca
result_provinces_43_code=LU
result_provinces_44_label=Macerata
result_provinces_44_code=MC
result_provinces_45_label=Mantova
result_provinces_45_code=MN
result_provinces_46_label=Massa-Carrara
result_provinces_46_code=MS
result_provinces_47_label=Matera
result_provinces_47_code=MT
result_provinces_48_label=Modena
result_provinces_48_code=MO
result_provinces_49_label=Monzae Brianza
result_provinces_49_code=MB
result_provinces_50_label=Novara
result_provinces_50_code=NO
result_provinces_51_label=Nuoro
result_provinces_51_code=NU
result_provinces_52_label=Oristano
result_provinces_52_code=OR
result_provinces_53_label=Padova
result_provinces_53_code=PD
result_provinces_54_label=Parma
result_provinces_54_code=PR
result_provinces_55_label=Pavia
result_provinces_55_code=PV
result_provinces_56_label=Perugia
result_provinces_56_code=PG
result_provinces_57_label=Pesaro e Urbino
result_provinces_57_code=PU
result_provinces_58_label=Pescara
result_provinces_58_code=PE
result_provinces_59_label=Piacenza
result_provinces_59_code=PC
result_provinces_60_label=Pisa
result_provinces_60_code=PI
result_provinces_61_label=Pistoia
result_provinces_61_code=PT
result_provinces_62_label=Pordenone
result_provinces_62_code=PN
result_provinces_63_label=Potenza
result_provinces_63_code=PZ
result_provinces_64_label=Prato
result_provinces_64_code=PO
result_provinces_65_label=Ragusa
result_provinces_65_code=RG
result_provinces_66_label=Ravenna
result_provinces_66_code=RA
result_provinces_67_label=Reggio Emilia
result_provinces_67_code=RE
result_provinces_68_label=Rieti
result_provinces_68_code=RI
result_provinces_69_label=Rimini
result_provinces_69_code=RN
result_provinces_70_label=Rovigo
result_provinces_70_code=RO
result_provinces_71_label=Salerno
result_provinces_71_code=SA
result_provinces_72_label=Sassari
result_provinces_72_code=SS
result_provinces_73_label=Savona
result_provinces_73_code=SV
result_provinces_74_label=Siena
result_provinces_74_code=SI
result_provinces_75_label=Siracusa
result_provinces_75_code=SR
result_provinces_76_label=Sondrio
result_provinces_76_code=SO
result_provinces_77_label=Sud Sardegna
result_provinces_77_code=SU
result_provinces_78_label=Taranto
result_provinces_78_code=TA
result_provinces_79_label=Teramo
result_provinces_79_code=TE
result_provinces_80_label=Terni
result_provinces_80_code=TR
result_provinces_81_label=Trapani
result_provinces_81_code=TP
result_provinces_82_label=Trento
result_provinces_82_code=TN
result_provinces_83_label=Treviso
result_provinces_83_code=TV
result_provinces_84_label=Trieste
result_provinces_84_code=TS
result_provinces_85_label=Udine
result_provinces_85_code=UD
result_provinces_86_label=Varese
result_provinces_86_code=VA
result_provinces_87_label=Verbano-Cusio-Ossola
result_provinces_87_code=VB
result_provinces_88_label=Vercelli
result_provinces_88_code=VC
result_provinces_89_label=Verona
result_provinces_89_code=VR
result_provinces_90_label=Vibo Valentia
result_provinces_90_code=VV
result_provinces_91_label=Vicenza
result_provinces_91_code=VI
result_provinces_92_label=Viterbo
result_provinces_92_code=VT

Example 4 (plain)

Request

https://joturl.com/a/i1/provinces/list?format=plain

Query parameters

format = plain

Response

Agrigento
AG
Alessandria
AL
Ancona
AN
Aosta
AO
Arezzo
AR
Ascoli Piceno
AP
Asti
AT
Avellino
AV
Barletta-Andria-Trani
BT
Belluno
BL
Benevento
BN
Bergamo
BG
Biella
BI
Bolzano
BZ
Brescia
BS
Brindisi
BR
Caltanissetta
CL
Campobasso
CB
Caserta
CE
Catanzaro
CZ
Chieti
CH
Como
CO
Cosenza
CS
Cremona
CR
Crotone
KR
Cuneo
CN
Enna
EN
Fermo
FM
Ferrara
FE
Foggia
FG
Forl&igrave;-Cesena
FC
Frosinone
FR
Gorizia
GO
Grosseto
GR
Imperia
IM
Isernia
IS
L'Aquila
AQ
LaSpezia
SP
Latina
LT
Lecce
LE
Lecco
LC
Livorno
LI
Lodi
LO
Lucca
LU
Macerata
MC
Mantova
MN
Massa-Carrara
MS
Matera
MT
Modena
MO
Monzae Brianza
MB
Novara
NO
Nuoro
NU
Oristano
OR
Padova
PD
Parma
PR
Pavia
PV
Perugia
PG
Pesaro e Urbino
PU
Pescara
PE
Piacenza
PC
Pisa
PI
Pistoia
PT
Pordenone
PN
Potenza
PZ
Prato
PO
Ragusa
RG
Ravenna
RA
Reggio Emilia
RE
Rieti
RI
Rimini
RN
Rovigo
RO
Salerno
SA
Sassari
SS
Savona
SV
Siena
SI
Siracusa
SR
Sondrio
SO
Sud Sardegna
SU
Taranto
TA
Teramo
TE
Terni
TR
Trapani
TP
Trento
TN
Treviso
TV
Trieste
TS
Udine
UD
Varese
VA
Verbano-Cusio-Ossola
VB
Vercelli
VC
Verona
VR
Vibo Valentia
VV
Vicenza
VI
Viterbo
VT

Return values

parameter	description
provinces	list of available Italian provinces

/qrcodes

/qrcodes/add

access: [WRITE]

Add a QR code template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=eef6ffb96e9fdffe5dcf81c0440f74c6&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=a8072f1e6a533843652cedbfc41b1321&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0

Query parameters

            name = QR code template
           shape = square
        bg_color = FFFFFF00
       bg_img_id = eef6ffb96e9fdffe5dcf81c0440f74c6
       bg_flip_v = 0
       bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
        fg_color = 000000FF
       fg_img_id = a8072f1e6a533843652cedbfc41b1321
       fg_flip_v = 0
       fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "ea738602bff4555d47800a727655549a",
    "name": "QR code template"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=eef6ffb96e9fdffe5dcf81c0440f74c6&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=a8072f1e6a533843652cedbfc41b1321&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0&format=xml

Query parameters

            name = QR code template
           shape = square
        bg_color = FFFFFF00
       bg_img_id = eef6ffb96e9fdffe5dcf81c0440f74c6
       bg_flip_v = 0
       bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
        fg_color = 000000FF
       fg_img_id = a8072f1e6a533843652cedbfc41b1321
       fg_flip_v = 0
       fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
          format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>ea738602bff4555d47800a727655549a</id>  
    <name>QR code template</name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=eef6ffb96e9fdffe5dcf81c0440f74c6&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=a8072f1e6a533843652cedbfc41b1321&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0&format=txt

Query parameters

            name = QR code template
           shape = square
        bg_color = FFFFFF00
       bg_img_id = eef6ffb96e9fdffe5dcf81c0440f74c6
       bg_flip_v = 0
       bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
        fg_color = 000000FF
       fg_img_id = a8072f1e6a533843652cedbfc41b1321
       fg_flip_v = 0
       fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
          format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=ea738602bff4555d47800a727655549a
result_name=QR code template

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=eef6ffb96e9fdffe5dcf81c0440f74c6&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=a8072f1e6a533843652cedbfc41b1321&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0&format=plain

Query parameters

            name = QR code template
           shape = square
        bg_color = FFFFFF00
       bg_img_id = eef6ffb96e9fdffe5dcf81c0440f74c6
       bg_flip_v = 0
       bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
        fg_color = 000000FF
       fg_img_id = a8072f1e6a533843652cedbfc41b1321
       fg_flip_v = 0
       fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
          format = plain

Response

ea738602bff4555d47800a727655549a
QR code template

Required parameters

parameter	description	max length
nameSTRING	QR code template name	50

Optional parameters

parameter	description
bg_brand_idID	NA
bg_colorSTRING	See i1/qrcodes/list for details
bg_flip_hSTRING	See i1/qrcodes/list for details
bg_flip_vSTRING	See i1/qrcodes/list for details
bg_img_idID	See i1/qrcodes/list for details
bg_rslider_valueSTRING	See i1/qrcodes/list for details
bg_sslider_valueSTRING	See i1/qrcodes/list for details
bg_tslider_valueSTRING	See i1/qrcodes/list for details
fg_brand_idID	NA
fg_colorSTRING	See i1/qrcodes/list for details
fg_flip_hSTRING	See i1/qrcodes/list for details
fg_flip_vSTRING	See i1/qrcodes/list for details
fg_img_idID	See i1/qrcodes/list for details
fg_rslider_valueSTRING	See i1/qrcodes/list for details
fg_sslider_valueSTRING	See i1/qrcodes/list for details
fg_tslider_valueSTRING	See i1/qrcodes/list for details
shapeSTRING	See i1/qrcodes/list for details

Return values

parameter	description
id	ID of the QR code template
name	echo back of the input parameter name

/qrcodes/count

access: [READ]

This method returns the number of defined QR code templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters QR code templates to be extracted by searching them

Return values

parameter	description
count	number of (filtered) QR code templates

/qrcodes/delete

access: [WRITE]

This method deletes a set of QR code templates by using their IDs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453

Query parameters

ids = 1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453&format=xml

Query parameters

   ids = 1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453&format=txt

Query parameters

   ids = 1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453&format=plain

Query parameters

   ids = 1fc7b9a7ff9275c6e704fd62a2f3b87e,3c6ad0d3cd1e48ead17d818be247b060,6b6708084f88d42bf8fe9afa86132453
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b

Query parameters

ids = 75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b&format=xml

Query parameters

   ids = 75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b&format=txt

Query parameters

   ids = 75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/qrcodes/delete?ids=75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b&format=plain

Query parameters

   ids = 75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700,07e59cac03bf042eef21f9321a97cf7b
format = plain

Response

75c4fdf4780797c84f3b356cd2f3a7e8,e478c0d93b8d65319249903ca93e0700
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of QR code template IDs to be deleted

Return values

parameter	description
deleted	number of deleted QR code templates
ids	[OPTIONAL] list of QR code template IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/qrcodes/edit

access: [WRITE]

Edit a QR code template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/edit?id=e9f7c1a09c9ca4acde642187b826d2f4&name=new+name+for+the+QR+code+template

Query parameters

  id = e9f7c1a09c9ca4acde642187b826d2f4
name = new name for the QR code template

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "e9f7c1a09c9ca4acde642187b826d2f4",
    "name": "new name for the QR code template"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/edit?id=e9f7c1a09c9ca4acde642187b826d2f4&name=new+name+for+the+QR+code+template&format=xml

Query parameters

    id = e9f7c1a09c9ca4acde642187b826d2f4
  name = new name for the QR code template
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>e9f7c1a09c9ca4acde642187b826d2f4</id>  
    <name>new name for the QR code template</name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/edit?id=e9f7c1a09c9ca4acde642187b826d2f4&name=new+name+for+the+QR+code+template&format=txt

Query parameters

    id = e9f7c1a09c9ca4acde642187b826d2f4
  name = new name for the QR code template
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=e9f7c1a09c9ca4acde642187b826d2f4
result_name=new name for the QR code template

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/edit?id=e9f7c1a09c9ca4acde642187b826d2f4&name=new+name+for+the+QR+code+template&format=plain

Query parameters

    id = e9f7c1a09c9ca4acde642187b826d2f4
  name = new name for the QR code template
format = plain

Response

e9f7c1a09c9ca4acde642187b826d2f4
new name for the QR code template

Required parameters

parameter	description
idID	ID of the QR code template

Optional parameters

parameter	description	max length
bg_brand_idID	NA
bg_colorSTRING	See i1/qrcodes/list for details
bg_flip_hSTRING	See i1/qrcodes/list for details
bg_flip_vSTRING	See i1/qrcodes/list for details
bg_img_idID	See i1/qrcodes/list for details
bg_rslider_valueSTRING	See i1/qrcodes/list for details
bg_sslider_valueSTRING	See i1/qrcodes/list for details
bg_tslider_valueSTRING	See i1/qrcodes/list for details
fg_brand_idID	NA
fg_colorSTRING	See i1/qrcodes/list for details
fg_flip_hSTRING	See i1/qrcodes/list for details
fg_flip_vSTRING	See i1/qrcodes/list for details
fg_img_idID	See i1/qrcodes/list for details
fg_rslider_valueSTRING	See i1/qrcodes/list for details
fg_sslider_valueSTRING	See i1/qrcodes/list for details
fg_tslider_valueSTRING	See i1/qrcodes/list for details
nameSTRING	See i1/qrcodes/list for details	50
shapeSTRING	See i1/qrcodes/list for details

Return values

parameter	description
id	ID of the QR code template
name	echo back of the input parameter name

/qrcodes/info

access: [READ]

This method returns information specified in a comma separated input called fields about a Qr code template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "d03ddbe316d7df05f2ca95f58a7a574a",
    "name": "QR code template",
    "shape": "square",
    "bg_color": "FFFFFF00",
    "bg_img_id": "d676b9e8a362a23ef1f6ed6e280fbd30",
    "bg_flip_v": 0,
    "bg_flip_h": 0,
    "bg_sslider_value": 0,
    "bg_rslider_value": 0,
    "bg_tslider_value": 0,
    "fg_color": "000000FF",
    "fg_img_id": "cbda23551b8ee4f2c271297a1d6031c7",
    "fg_flip_v": 0,
    "fg_flip_h": 0,
    "fg_sslider_value": 72,
    "fg_rslider_value": 0,
    "fg_tslider_value": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=xml

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>d03ddbe316d7df05f2ca95f58a7a574a</id>  
    <name>QR code template</name>  
    <shape>square</shape>  
    <bg_color>FFFFFF00</bg_color>  
    <bg_img_id>d676b9e8a362a23ef1f6ed6e280fbd30</bg_img_id>  
    <bg_flip_v>0</bg_flip_v>  
    <bg_flip_h>0</bg_flip_h>  
    <bg_sslider_value>0</bg_sslider_value>  
    <bg_rslider_value>0</bg_rslider_value>  
    <bg_tslider_value>0</bg_tslider_value>  
    <fg_color>000000FF</fg_color>  
    <fg_img_id>cbda23551b8ee4f2c271297a1d6031c7</fg_img_id>  
    <fg_flip_v>0</fg_flip_v>  
    <fg_flip_h>0</fg_flip_h>  
    <fg_sslider_value>72</fg_sslider_value>  
    <fg_rslider_value>0</fg_rslider_value>  
    <fg_tslider_value>0</fg_tslider_value>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=txt

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=d03ddbe316d7df05f2ca95f58a7a574a
result_name=QR code template
result_shape=square
result_bg_color=FFFFFF00
result_bg_img_id=d676b9e8a362a23ef1f6ed6e280fbd30
result_bg_flip_v=0
result_bg_flip_h=0
result_bg_sslider_value=0
result_bg_rslider_value=0
result_bg_tslider_value=0
result_fg_color=000000FF
result_fg_img_id=cbda23551b8ee4f2c271297a1d6031c7
result_fg_flip_v=0
result_fg_flip_h=0
result_fg_sslider_value=72
result_fg_rslider_value=0
result_fg_tslider_value=0

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=plain

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = plain

Response

d03ddbe316d7df05f2ca95f58a7a574a
QR code template
square
FFFFFF00
d676b9e8a362a23ef1f6ed6e280fbd30
0
0
0
0
0
000000FF
cbda23551b8ee4f2c271297a1d6031c7
0
0
72
0
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, see i1/qrcodes/list for details
idID	ID of the QR code template

Return values

parameter	description
bg_color	[OPTIONAL] returned only if bg_color is passed in fields
bg_flip_h	[OPTIONAL] returned only if bg_flip_h is passed in fields
bg_flip_v	[OPTIONAL] returned only if bg_flip_v is passed in fields
bg_img_id	[OPTIONAL] returned only if bg_img_id is passed in fields
bg_rslider_value	[OPTIONAL] returned only if bg_rslider_value is passed in fields
bg_sslider_value	[OPTIONAL] returned only if bg_sslider_value is passed in fields
bg_tslider_value	[OPTIONAL] returned only if bg_tslider_value is passed in fields
fg_color	[OPTIONAL] returned only if fg_color is passed in fields
fg_flip_h	[OPTIONAL] returned only if fg_flip_h is passed in fields
fg_flip_v	[OPTIONAL] returned only if fg_flip_v is passed in fields
fg_img_id	[OPTIONAL] returned only if fg_img_id is passed in fields
fg_rslider_value	[OPTIONAL] returned only if fg_rslider_value is passed in fields
fg_sslider_value	[OPTIONAL] returned only if fg_sslider_value is passed in fields
fg_tslider_value	[OPTIONAL] returned only if fg_tslider_value is passed in fields
id	[OPTIONAL] returned only if id is passed in fields
name	[OPTIONAL] returned only if name is passed in fields
shape	[OPTIONAL] returned only if shape is passed in fields

/qrcodes/list

access: [READ]

This method returns a list of user's Qr code templates, specified in a comma separated input called fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "id": "44081407dd9556b12f884f92eab66a1f",
        "name": "QR code template",
        "shape": "square",
        "bg_color": "FFFFFF00",
        "bg_img_id": "a18b7ead2fa9d8f013593ddb5c03b09e",
        "bg_flip_v": 0,
        "bg_flip_h": 0,
        "bg_sslider_value": 0,
        "bg_rslider_value": 0,
        "bg_tslider_value": 0,
        "fg_color": "000000FF",
        "fg_img_id": "7fb1c39244ef8502b015a48bb6a34b41",
        "fg_flip_v": 0,
        "fg_flip_h": 0,
        "fg_sslider_value": 72,
        "fg_rslider_value": 0,
        "fg_tslider_value": 0
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=xml

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <id>44081407dd9556b12f884f92eab66a1f</id>  
        <name>QR code template</name>  
        <shape>square</shape>  
        <bg_color>FFFFFF00</bg_color>  
        <bg_img_id>a18b7ead2fa9d8f013593ddb5c03b09e</bg_img_id>  
        <bg_flip_v>0</bg_flip_v>  
        <bg_flip_h>0</bg_flip_h>  
        <bg_sslider_value>0</bg_sslider_value>  
        <bg_rslider_value>0</bg_rslider_value>  
        <bg_tslider_value>0</bg_tslider_value>  
        <fg_color>000000FF</fg_color>  
        <fg_img_id>7fb1c39244ef8502b015a48bb6a34b41</fg_img_id>  
        <fg_flip_v>0</fg_flip_v>  
        <fg_flip_h>0</fg_flip_h>  
        <fg_sslider_value>72</fg_sslider_value>  
        <fg_rslider_value>0</fg_rslider_value>  
        <fg_tslider_value>0</fg_tslider_value>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=txt

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=44081407dd9556b12f884f92eab66a1f
result_data_0_name=QR code template
result_data_0_shape=square
result_data_0_bg_color=FFFFFF00
result_data_0_bg_img_id=a18b7ead2fa9d8f013593ddb5c03b09e
result_data_0_bg_flip_v=0
result_data_0_bg_flip_h=0
result_data_0_bg_sslider_value=0
result_data_0_bg_rslider_value=0
result_data_0_bg_tslider_value=0
result_data_0_fg_color=000000FF
result_data_0_fg_img_id=7fb1c39244ef8502b015a48bb6a34b41
result_data_0_fg_flip_v=0
result_data_0_fg_flip_h=0
result_data_0_fg_sslider_value=72
result_data_0_fg_rslider_value=0
result_data_0_fg_tslider_value=0

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=plain

Query parameters

fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = plain

Response

1
44081407dd9556b12f884f92eab66a1f
QR code template
square
FFFFFF00
a18b7ead2fa9d8f013593ddb5c03b09e
0
0
0
0
0
000000FF
7fb1c39244ef8502b015a48bb6a34b41
0
0
72
0
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, bg_color, bg_img_id, fg_color, id, fg_img_id, params, name, shape

Optional parameters

parameter	description
lengthINTEGER	extracts this number of QR code templates (maxmimum allowed: 100)
orderbyARRAY	orders QR code templates by field, available fields: bg_color, bg_img_id, fg_color, id, fg_img_id, params, name, shape
searchSTRING	filters QR code templates to be extracted by searching them
sortSTRING	sorts QR code templates in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract QR code templates from this position
typesSTRING	NA

Return values

parameter	description
data	array containing information on the QR code templates, returned information depends on the fields parameter.

Available fields in the data array:

id: ID of the QR code template
name: QR code profile name
shape: QR code module shape, see i1/qrcodes/property for details
bg_color: QR code background color (hex format red, green, blue, transparency: RRGGBBAA)
bg_img_id: ID of the background image
bg_flip_v: 1 if the background image is flipped vertically
bg_flip_h: 1 if the background image is flipped horizontally
bg_sslider_value: background image scale [0-100%]
bg_rslider_value: background image rotation [0-359 deg]
bg_tslider_value: background image transparency [0=totally opaque - 100=totally transparent]
fg_color: QR code modules color (hex format red, green, blue, transparency: RRGGBBAA )
fg_img_id: ID of the foreground image
fg_flip_v: 1 if the foreground image is flipped vertically
fg_flip_h: 1 if the foreground image is flipped horizontally
fg_sslider_value: foreground image scale [0-100%]
fg_rslider_value: foreground image rotation [0-359 deg]
fg_tslider_value: foreground image transparency [0=totally opaque - 100=totally transparent]

See i1/qrcodes/property for details on shape.

/qrcodes/preview

access: [READ]

This method returns a preview of a QR codes.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/preview?size=big&id=568070816187c8e2e7119be8391e471a

Query parameters

size = big
  id = 568070816187c8e2e7119be8391e471a

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "img": "data:image\/png;base64,NjdhMGYzMGQ3NDIzNTk0N2E3YWE3MTM2YzVkMmJmNjM="
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/preview?size=big&id=568070816187c8e2e7119be8391e471a&format=xml

Query parameters

  size = big
    id = 568070816187c8e2e7119be8391e471a
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <img>data:image/png;base64,NjdhMGYzMGQ3NDIzNTk0N2E3YWE3MTM2YzVkMmJmNjM=</img>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/preview?size=big&id=568070816187c8e2e7119be8391e471a&format=txt

Query parameters

  size = big
    id = 568070816187c8e2e7119be8391e471a
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_img=data:image/png;base64,NjdhMGYzMGQ3NDIzNTk0N2E3YWE3MTM2YzVkMmJmNjM=

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/preview?size=big&id=568070816187c8e2e7119be8391e471a&format=plain

Query parameters

  size = big
    id = 568070816187c8e2e7119be8391e471a
format = plain

Response

data:image/png;base64,NjdhMGYzMGQ3NDIzNTk0N2E3YWE3MTM2YzVkMmJmNjM=

Optional parameters

parameter	description
bg_brand_idID	NA
bg_colorSTRING	QR code background color, see i1/qrcodes/list for details, this parameter is ignored if id is passed
bg_flip_hSTRING	1 if the background image is flipped horizontally
bg_flip_vSTRING	1 if the background image is flipped vertically
bg_img_idID	ID of the background image, see i1/qrcodes/list for details, this parameter is ignored if id is passed
bg_rslider_valueSTRING	background image rotation [0-359 deg]
bg_sslider_valueSTRING	background image scale [0-100%]
bg_tslider_valueSTRING	background image transparency [0=totally opaque - 100=totally transparent]
checkBOOLEAN	1 to check if the QR code is readable, default value `check = 0`
customizationBOOLEAN	1 if the QR code preview should be generated using bg_color, fg_color, shape, fg_img_id, bg_img_id, bg_flip_v, bg_flip_h, bg_sslider_value, bg_rslider_value, bg_tslider_value, fg_flip_v, fg_flip_h, fg_sslider_value, fg_rslider_value, fg_tslider_value; this parameter is ignored if id is passed
downloadBOOLEAN	1 to force the download of the QR code to be started by this method, default value `download = 0`
fg_brand_idID	NA
fg_colorSTRING	QR code modules color, see i1/qrcodes/list for details, this parameter is ignored if id is passed
fg_flip_hSTRING	1 if the foreground image is flipped horizontally
fg_flip_vSTRING	1 if the foreground image is flipped vertically
fg_img_idID	ID of the foreground image (logo), see i1/qrcodes/list for details, this parameter is ignored if id is passed
fg_rslider_valueSTRING	foreground image rotation [0-359 deg]
fg_sslider_valueSTRING	foreground image scale [0-100%]
fg_tslider_valueSTRING	foreground image transparency [0=totally opaque - 100=totally transparent]
idID	ID of the QR code template to use for the preview
return_imageBOOLEAN	1 to return the QR code binary data regardless the `format` input parameter, it is useful to show QR codes on the user interface, default value `return_image = 0`
shapeSTRING	QR code module shape, see i1/qrcodes/list for details, this parameter is ignored if id is passed
sizeSTRING	size for the preview to be generated, see i1/qrcodes/property for available sizes, default value `type = small`
typeSTRING	image type for the preview to be generated, see i1/qrcodes/property for available types, default value `type = png`
urlURL	URL to which the QR code points, default value: http://joturl.com

Return values

parameter	description
[BINARY DATA]	[OPTIONAL] binary data representing the QR code image are returned only if `download = 1` or `return_image = 1`
check	[OPTIONAL] 1 if the QR code is readable, 0 otherwise, returned only if `check = 1`, `download = 0` and `return_image = 0`
check_hint	[OPTIONAL] 0 if the QR is not readable, 1 if the QR code is readable, 2 or higher if the QR might be difficult to read, the higher the number returned in this parameter, the more difficult the QR code is to read; returned only if `check = 1`, `download = 0` and `return_image = 0`
img	[OPTIONAL] base64 of the data representing the QR code image, returned only if `download = 0` and `return_image = 0`

/qrcodes/property

access: [READ]

This method returns a list of property of QR codes.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "shapes": [
      "square",
      "rsquare",
      "rrsquare",
      "rhombus",
      "ldiamond",
      "rdiamond",
      "dot",
      "rndsquare"
    ],
    "types": [
      "svg",
      "jpg"
    ],
    "sizes": [
      "small",
      "medium",
      "big"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <shapes>
      <i0>square</i0>  
      <i1>rsquare</i1>  
      <i2>rrsquare</i2>  
      <i3>rhombus</i3>  
      <i4>ldiamond</i4>  
      <i5>rdiamond</i5>  
      <i6>dot</i6>  
      <i7>rndsquare</i7>  
    </shapes>  
    <types>
      <i0>svg</i0>  
      <i1>jpg</i1>  
    </types>  
    <sizes>
      <i0>small</i0>  
      <i1>medium</i1>  
      <i2>big</i2>  
    </sizes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_shapes_0=square
result_shapes_1=rsquare
result_shapes_2=rrsquare
result_shapes_3=rhombus
result_shapes_4=ldiamond
result_shapes_5=rdiamond
result_shapes_6=dot
result_shapes_7=rndsquare
result_types_0=svg
result_types_1=jpg
result_sizes_0=small
result_sizes_1=medium
result_sizes_2=big

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/property?format=plain

Query parameters

format = plain

Response

square
rsquare
rrsquare
rhombus
ldiamond
rdiamond
dot
rndsquare
svg
jpg
small
medium
big

Return values

parameter	description
shapes	available shapes for the QR code modules
sizes	available sizes for the QR code
types	available image types for the QR code

/qrcodes/urls

/qrcodes/urls/count

access: [READ]

This method returns the number of tracking link associated to a specific QR code template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=0d5572dc4daf9d6738151d4c0c4b675e

Query parameters

qrcode_id = 0d5572dc4daf9d6738151d4c0c4b675e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 6
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=0d5572dc4daf9d6738151d4c0c4b675e&format=xml

Query parameters

qrcode_id = 0d5572dc4daf9d6738151d4c0c4b675e
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>6</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=0d5572dc4daf9d6738151d4c0c4b675e&format=txt

Query parameters

qrcode_id = 0d5572dc4daf9d6738151d4c0c4b675e
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=6

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=0d5572dc4daf9d6738151d4c0c4b675e&format=plain

Query parameters

qrcode_id = 0d5572dc4daf9d6738151d4c0c4b675e
   format = plain

Response

Required parameters

parameter	description
qrcode_idID	ID of the QR code template

Optional parameters

parameter	description
searchSTRING	filters tracking links to be extracted by searching them

Return values

parameter	description
count	number of (filtered) tracking links associated to the QR code template

/qrcodes/urls/list

access: [READ]

This method returns a list of tracking link associated to a specific QR code template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=6468f68d12f8e24efa009697b215d85d

Query parameters

   fields = id,short_url
qrcode_id = 6468f68d12f8e24efa009697b215d85d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "683bdf45f67434a68a169d636b370bdf",
        "short_url": "http:\/\/jo.my\/c89d059"
      },
      {
        "id": "981de1bce7ef10172ed75333a5ac9c8a",
        "short_url": "http:\/\/jo.my\/241bcf5e"
      },
      {
        "id": "9c7fb85705f7eae3560a102f57619bc8",
        "short_url": "http:\/\/jo.my\/79e35cb6"
      },
      {
        "id": "c508d7c47fcb9c418e3d30a6ed5e7380",
        "short_url": "http:\/\/jo.my\/e16a4e6f"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=6468f68d12f8e24efa009697b215d85d&format=xml

Query parameters

   fields = id,short_url
qrcode_id = 6468f68d12f8e24efa009697b215d85d
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>683bdf45f67434a68a169d636b370bdf</id>  
        <short_url>http://jo.my/c89d059</short_url>  
      </i0>  
      <i1>
        <id>981de1bce7ef10172ed75333a5ac9c8a</id>  
        <short_url>http://jo.my/241bcf5e</short_url>  
      </i1>  
      <i2>
        <id>9c7fb85705f7eae3560a102f57619bc8</id>  
        <short_url>http://jo.my/79e35cb6</short_url>  
      </i2>  
      <i3>
        <id>c508d7c47fcb9c418e3d30a6ed5e7380</id>  
        <short_url>http://jo.my/e16a4e6f</short_url>  
      </i3>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=6468f68d12f8e24efa009697b215d85d&format=txt

Query parameters

   fields = id,short_url
qrcode_id = 6468f68d12f8e24efa009697b215d85d
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=683bdf45f67434a68a169d636b370bdf
result_data_0_short_url=http://jo.my/c89d059
result_data_1_id=981de1bce7ef10172ed75333a5ac9c8a
result_data_1_short_url=http://jo.my/241bcf5e
result_data_2_id=9c7fb85705f7eae3560a102f57619bc8
result_data_2_short_url=http://jo.my/79e35cb6
result_data_3_id=c508d7c47fcb9c418e3d30a6ed5e7380
result_data_3_short_url=http://jo.my/e16a4e6f

Example 4 (plain)

Request

https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=6468f68d12f8e24efa009697b215d85d&format=plain

Query parameters

   fields = id,short_url
qrcode_id = 6468f68d12f8e24efa009697b215d85d
   format = plain

Response

http://jo.my/c89d059
http://jo.my/241bcf5e
http://jo.my/79e35cb6
http://jo.my/e16a4e6f

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: id, notes, short_url, long_url, project_id, project_name, domain_id, domain_host, count
qrcode_idID	ID of the QR code template

Optional parameters

parameter	description
lengthINTEGER	extracts this number of tracking links (maxmimum allowed: 100)
orderbyARRAY	orders tracking links by field, available fields: id, notes, short_url, long_url, project_id, project_name, domain_id, domain_host, count
searchSTRING	filters tracking links to be extracted by searching them
sortSTRING	sorts tracking links in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract tracking links from this position

Return values

parameter	description
data	array containing information on the tracking links, the returned information depends on the fields parameter.

/remarketings

/remarketings/add

access: [WRITE]

Add a remarketing pixel for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2

Query parameters

        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "71636c766251733639686861436d496d58426c464f773d3d",
    "name": "FB remarketing pixel",
    "notes": "this is a simple note",
    "code_type": "facebook",
    "code_id": "132434",
    "code_html": "",
    "gdpr_id": "7522395a6a22633061376e672161356b3153613638213d3d",
    "gdpr_enabled": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=xml

Query parameters

        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>71636c766251733639686861436d496d58426c464f773d3d</id>  
    <name>FB remarketing pixel</name>  
    <notes>this is a simple note</notes>  
    <code_type>facebook</code_type>  
    <code_id>132434</code_id>  
    <code_html></code_html>  
    <gdpr_id>7522395a6a22633061376e672161356b3153613638213d3d</gdpr_id>  
    <gdpr_enabled>2</gdpr_enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=txt

Query parameters

        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=71636c766251733639686861436d496d58426c464f773d3d
result_name=FB remarketing pixel
result_notes=this is a simple note
result_code_type=facebook
result_code_id=132434
result_code_html=
result_gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d
result_gdpr_enabled=2

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=plain

Query parameters

        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
      format = plain

Response

71636c766251733639686861436d496d58426c464f773d3d
FB remarketing pixel
this is a simple note
facebook
132434

7522395a6a22633061376e672161356b3153613638213d3d
2

Required parameters

parameter	description	max length
nameSTRING	remarketing pixel name	100

Optional parameters

parameter	description	max length
code_htmlHTML	HTML code for custom remarketing script	4000
code_idSTRING	pixel ID	255
code_typeENUM	pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter
gdpr_enabledINTEGER	0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used
gdpr_idID	ID of the GDPR template associated with this remarketing pixel
notesSTRING	remarketing pixel notes	128

Return values

parameter	description
code_html	[OPTIONAL] HTML code for custom remarketing script, returned only if _codehtml is passed
code_id	[OPTIONAL] pixel ID, returned only if _codeid is passed
code_type	[OPTIONAL] pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter, returned only if _codetype is passed
gdpr_enabled	[OPTIONAL] 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used, returned only if _gdprenabled is passed
gdpr_id	[OPTIONAL] ID of the GDPR template associated with this remarketing pixel, returned only if _gdprid is passed
id	[OPTIONAL] remarketing pixel (internal) ID, returned only if id is passed
name	[OPTIONAL] remarketing pixel name, returned only if name is passed

/remarketings/count

access: [READ]

This method returns the number of defined remarketing pixels.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 8
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>8</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/remarketings/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/remarketings/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/remarketings/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/remarketings/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	count items by searching them
typesARRAY	filters list by code type(s), it can be empty, all or a comma separated list of these codes: facebook, twitter, linkedin, pinterest, bing, google_analytics, google_adwords, google_tag_manager, manychat, quora, adroll, snapchat, tiktok, reddit, custom

Return values

parameter	description
count	number of remarketing pixels (filtered by search if passed)

/remarketings/delete

access: [WRITE]

This method deletes a set of remarketing pixels by using their IDs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/delete?ids=7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef

Query parameters

ids = 7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/delete?ids=7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef&format=xml

Query parameters

   ids = 7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/delete?ids=7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef&format=txt

Query parameters

   ids = 7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/delete?ids=7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef&format=plain

Query parameters

   ids = 7dfa0e0cdb878560678d1d47b8a024fc,a36b952fce06f76c109c93e408d4fc86,7267898eeb310f5734d8b93429a817ef
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/remarketings/delete?ids=afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22

Query parameters

ids = afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/remarketings/delete?ids=afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22&format=xml

Query parameters

   ids = afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/remarketings/delete?ids=afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22&format=txt

Query parameters

   ids = afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/remarketings/delete?ids=afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22&format=plain

Query parameters

   ids = afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad,5aedf374d5540b5f64f7180d0bfcba22
format = plain

Response

afcdbe932d5875c7c2b6d6b30504d3c5,79cf0fbfe4502072981889e7644109ad
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of remarketing pixel IDs to be deleted

Return values

parameter	description
deleted	number of deleted remarketing pixels
ids	[OPTIONAL] list of remarketing pixel IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/remarketings/edit

access: [WRITE]

Edit fields of a remarketing pixel.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2

Query parameters

          id = 306663506735386e622f69266e366a586d6b722552513d3d
        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "306663506735386e622f69266e366a586d6b722552513d3d",
    "name": "FB remarketing pixel",
    "notes": "this is a simple note",
    "code_type": "facebook",
    "code_id": "132434",
    "code_html": "",
    "gdpr_id": "7522395a6a22633061376e672161356b3153613638213d3d",
    "gdpr_enabled": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=xml

Query parameters

          id = 306663506735386e622f69266e366a586d6b722552513d3d
        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>306663506735386e622f69266e366a586d6b722552513d3d</id>  
    <name>FB remarketing pixel</name>  
    <notes>this is a simple note</notes>  
    <code_type>facebook</code_type>  
    <code_id>132434</code_id>  
    <code_html></code_html>  
    <gdpr_id>7522395a6a22633061376e672161356b3153613638213d3d</gdpr_id>  
    <gdpr_enabled>2</gdpr_enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=txt

Query parameters

          id = 306663506735386e622f69266e366a586d6b722552513d3d
        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=306663506735386e622f69266e366a586d6b722552513d3d
result_name=FB remarketing pixel
result_notes=this is a simple note
result_code_type=facebook
result_code_id=132434
result_code_html=
result_gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d
result_gdpr_enabled=2

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel&notes=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=plain

Query parameters

          id = 306663506735386e622f69266e366a586d6b722552513d3d
        name = FB remarketing pixel
       notes = this is a simple note
   code_type = facebook
     code_id = 132434
   code_html = 
     gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
      format = plain

Response

306663506735386e622f69266e366a586d6b722552513d3d
FB remarketing pixel
this is a simple note
facebook
132434

7522395a6a22633061376e672161356b3153613638213d3d
2

Required parameters

parameter	description
idID	remarketing pixel (internal) ID

Optional parameters

parameter	description	max length
code_htmlHTML	HTML code for custom remarketing script	4000
code_idSTRING	pixel ID	255
code_typeENUM	pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter
gdpr_enabledINTEGER	0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used
gdpr_idID	ID of the GDPR template associated with this remarketing pixel
nameSTRING	remarketing pixel name	100
notesSTRING	remarketing pixel notes	128

Return values

parameter	description
code_html	[OPTIONAL] HTML code for custom remarketing script, returned only if _codehtml is passed
code_id	[OPTIONAL] pixel ID, returned only if _codeid is passed
code_type	[OPTIONAL] pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter, returned only if _codetype is passed
gdpr_enabled	[OPTIONAL] 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used, returned only if _gdprenabled is passed
gdpr_id	[OPTIONAL] ID of the GDPR template associated with this remarketing pixel, returned only if _gdprid is passed
id	[OPTIONAL] remarketing pixel (internal) ID, returned only if id is passed
name	[OPTIONAL] remarketing pixel name, returned only if name is passed
notes	[OPTIONAL] remarketing pixel notes, returned only if notes is passed

/remarketings/info

access: [READ]

This method returns information on a remarketing pixel, the returned information are that passed in the fields param (a comma separated list).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "clicks": 31234,
    "code_id": "132434",
    "code_type": "facebook",
    "creation": "2018-06-06 23:25:31.703",
    "gdpr_enabled": 1,
    "gdpr_id": "",
    "id": "306663506735386e622f69266e366a586d6b722552513d3d",
    "name": "FB remarketing pixel",
    "notes": "this is a simple note",
    "performance": ".000000000000"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=xml

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <clicks>31234</clicks>  
    <code_id>132434</code_id>  
    <code_type>facebook</code_type>  
    <creation>2018-06-06 23:25:31.703</creation>  
    <gdpr_enabled>1</gdpr_enabled>  
    <gdpr_id></gdpr_id>  
    <id>306663506735386e622f69266e366a586d6b722552513d3d</id>  
    <name>FB remarketing pixel</name>  
    <notes>this is a simple note</notes>  
    <performance>.000000000000</performance>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=txt

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_clicks=31234
result_code_id=132434
result_code_type=facebook
result_creation=2018-06-06 23:25:31.703
result_gdpr_enabled=1
result_gdpr_id=
result_id=306663506735386e622f69266e366a586d6b722552513d3d
result_name=FB remarketing pixel
result_notes=this is a simple note
result_performance=.000000000000

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=plain

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = plain

Response

31234
132434
facebook
2018-06-06 23:25:31.703
1

306663506735386e622f69266e366a586d6b722552513d3d
FB remarketing pixel
this is a simple note
.000000000000

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: clicks, code_id, code_type, creation, gdpr_enabled, gdpr_id, code_html, id, name, notes, performance, count
idID	ID of the remarketing pixel

Return values

parameter	description
clicks	click generated on the remarketing pixel
code_id	pixel ID
code_type	pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter
creation	creation date time (e.g., 2018-06-06 23:25:31.703)
gdpr_enabled	0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used
gdpr_id	ID of the GDPR template associated with this remarketing pixel
id	remarketing pixel (internal) ID
name	remarketing pixel name
notes	remarketing pixel notes
performance	performance meter of this remarking code, 0 if the remarketing pixel has 0 clicks or if is was created by less than 3 hours, otherwise it is the average number of clicks per hour

/remarketings/list

access: [READ]

This method returns a list of remarking code's data, specified in a comma separated input called fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "clicks": 31234,
        "code_id": "132434",
        "user_retargeting_code_html": "",
        "code_type": "facebook",
        "creation": "2018-06-06 23:25:31.703",
        "gdpr_enabled": 1,
        "gdpr_id": "",
        "id": "306663506735386e622f69266e366a586d6b722552513d3d",
        "name": "FB remarketing pixel",
        "notes": "this is a simple note",
        "performance": ".000000000000"
      },
      {
        "clicks": 123,
        "code_id": "4568468",
        "user_retargeting_code_html": "",
        "code_type": "twitter",
        "creation": "2017-01-18 13:28:42.543",
        "gdpr_enabled": 1,
        "gdpr_id": "",
        "id": "806668506785886e642f69466e866a586d6b744552518d8d",
        "name": "TW remarketing pixel",
        "notes": "",
        "performance": ".000000000000"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=xml

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <clicks>31234</clicks>  
        <code_id>132434</code_id>  
        <user_retargeting_code_html></user_retargeting_code_html>  
        <code_type>facebook</code_type>  
        <creation>2018-06-06 23:25:31.703</creation>  
        <gdpr_enabled>1</gdpr_enabled>  
        <gdpr_id></gdpr_id>  
        <id>306663506735386e622f69266e366a586d6b722552513d3d</id>  
        <name>FB remarketing pixel</name>  
        <notes>this is a simple note</notes>  
        <performance>.000000000000</performance>  
      </i0>  
      <i1>
        <clicks>123</clicks>  
        <code_id>4568468</code_id>  
        <user_retargeting_code_html></user_retargeting_code_html>  
        <code_type>twitter</code_type>  
        <creation>2017-01-18 13:28:42.543</creation>  
        <gdpr_enabled>1</gdpr_enabled>  
        <gdpr_id></gdpr_id>  
        <id>806668506785886e642f69466e866a586d6b744552518d8d</id>  
        <name>TW remarketing pixel</name>  
        <notes></notes>  
        <performance>.000000000000</performance>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=txt

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_clicks=31234
result_data_0_code_id=132434
result_data_0_user_retargeting_code_html=
result_data_0_code_type=facebook
result_data_0_creation=2018-06-06 23:25:31.703
result_data_0_gdpr_enabled=1
result_data_0_gdpr_id=
result_data_0_id=306663506735386e622f69266e366a586d6b722552513d3d
result_data_0_name=FB remarketing pixel
result_data_0_notes=this is a simple note
result_data_0_performance=.000000000000
result_data_1_clicks=123
result_data_1_code_id=4568468
result_data_1_user_retargeting_code_html=
result_data_1_code_type=twitter
result_data_1_creation=2017-01-18 13:28:42.543
result_data_1_gdpr_enabled=1
result_data_1_gdpr_id=
result_data_1_id=806668506785886e642f69466e866a586d6b744552518d8d
result_data_1_name=TW remarketing pixel
result_data_1_notes=
result_data_1_performance=.000000000000

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=plain

Query parameters

fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = plain

Response

31234
132434

facebook
2018-06-06 23:25:31.703
1

306663506735386e622f69266e366a586d6b722552513d3d
FB remarketing pixel
this is a simple note
.000000000000
123
4568468

twitter
2017-01-18 13:28:42.543
1

806668506785886e642f69466e866a586d6b744552518d8d
TW remarketing pixel

.000000000000

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: clicks, code_id, code_type, creation, gdpr_enabled, gdpr_id, code_html, id, name, notes, performance, count

Optional parameters

parameter	description
lengthINTEGER	extracts this number of remarketing pixels (maxmimum allowed: 100)
orderbyARRAY	orders remarketing pixels by field, available fields: clicks, code_id, code_type, creation, gdpr_enabled, gdpr_id, code_html, id, name, notes, performance, count
searchSTRING	filters remarketing pixels to be extracted by searching them
sortSTRING	sorts remarketing pixels in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract remarketing pixels from this position
typesARRAY	filters list by code type(s), it can be empty, all or a comma separated list of these codes: facebook, twitter, linkedin, pinterest, bing, google_analytics, google_adwords, google_tag_manager, manychat, quora, adroll, snapchat, tiktok, reddit, custom

Return values

parameter	description
data	array containing required information on remarketing pixels

Available fields in the data array:

clicks: click generated on the remarketing pixel
code_id: pixel ID
code_html: HTML code for custom remarketing script
user_retargeting_code_html: HTML code for custom remarketing script
code_type: pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter
creation: creation date time (e.g., 2018-06-06 23:25:31.703)
gdpr_enabled: 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used
gdpr_id: ID of the GDPR template associated with this remarketing pixel
id: remarketing pixel (internal) ID
name: remarketing pixel name
notes: remarketing pixel notes
performance: performance meter of this remarking code, 0 if the remarketing pixel has 0 clicks or if is was created by less than 3 hours, otherwise it is the average number of clicks per hour

/remarketings/property

access: [READ]

This method returns a list of supported remarketing pixels.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "adroll": {
      "enabled": 1,
      "label": "Adroll Pixel",
      "title": "Advertiser ID|Pixel ID",
      "helper": "",
      "abbr": "AR"
    },
    "bing": {
      "enabled": 1,
      "label": "Bing Universal Event Tracking",
      "title": "UET Pixel ID",
      "helper": "",
      "abbr": "BNG"
    },
    "custom": {
      "enabled": 1,
      "label": "Custom remarketing code",
      "title": "Remarketing code (including opening and closing tags)",
      "helper": "",
      "abbr": "CSTM"
    },
    "facebook": {
      "enabled": 1,
      "label": "Facebook Pixel",
      "title": "Pixel ID",
      "helper": "",
      "abbr": "FB"
    },
    "google_adwords": {
      "enabled": 1,
      "label": "AdWords tag for websites",
      "title": "Conversion ID",
      "helper": "",
      "abbr": "ADWS"
    },
    "google_analytics": {
      "enabled": 1,
      "label": "Google Analytics Tracking code",
      "title": "Tracking ID",
      "helper": "",
      "abbr": "GA"
    },
    "google_tag_manager": {
      "enabled": 1,
      "label": "Google Tag Manager",
      "title": "GTM ID",
      "helper": "",
      "abbr": "GTAG"
    },
    "linkedin": {
      "enabled": 1,
      "label": "LinkedIn Insight Tag",
      "title": "Partner ID (linkedin_data_partner_id)",
      "helper": "",
      "abbr": "LI"
    },
    "manychat": {
      "enabled": 1,
      "label": "ManyChat Pixel\/Widget",
      "title": "Pixel\/Widget ID",
      "helper": "",
      "abbr": "MC"
    },
    "pinterest": {
      "enabled": 1,
      "label": "Pinterest Conversion Tag",
      "title": "Pinterest Pixel ID",
      "helper": "",
      "abbr": "PIN"
    },
    "quora": {
      "enabled": 1,
      "label": "Quora Pixel ID",
      "title": "Pixel ID",
      "helper": "",
      "abbr": "Q"
    },
    "reddit": {
      "enabled": 1,
      "label": "Reddit Pixel",
      "title": "ID Inserzionista",
      "helper": "",
      "abbr": "R"
    },
    "snapchat": {
      "enabled": 1,
      "label": "Snapchat Pixel",
      "title": "Pixel ID",
      "helper": "",
      "abbr": "SC"
    },
    "tiktok": {
      "enabled": 1,
      "label": "TikTok Pixel",
      "title": "Pixel ID",
      "helper": "",
      "abbr": "TT"
    },
    "twitter": {
      "enabled": 1,
      "label": "Twitter conversion tracking",
      "title": "Website Tag ID",
      "helper": "",
      "abbr": "TW"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <adroll>
      <enabled>1</enabled>  
      <label>Adroll Pixel</label>  
      <title>Advertiser ID|Pixel ID</title>  
      <helper></helper>  
      <abbr>AR</abbr>  
    </adroll>  
    <bing>
      <enabled>1</enabled>  
      <label>Bing Universal Event Tracking</label>  
      <title>UET Pixel ID</title>  
      <helper></helper>  
      <abbr>BNG</abbr>  
    </bing>  
    <custom>
      <enabled>1</enabled>  
      <label>Custom remarketing code</label>  
      <title>Remarketing code (including opening and closing tags)</title>  
      <helper></helper>  
      <abbr>CSTM</abbr>  
    </custom>  
    <facebook>
      <enabled>1</enabled>  
      <label>Facebook Pixel</label>  
      <title>Pixel ID</title>  
      <helper></helper>  
      <abbr>FB</abbr>  
    </facebook>  
    <google_adwords>
      <enabled>1</enabled>  
      <label>AdWords tag for websites</label>  
      <title>Conversion ID</title>  
      <helper></helper>  
      <abbr>ADWS</abbr>  
    </google_adwords>  
    <google_analytics>
      <enabled>1</enabled>  
      <label>Google Analytics Tracking code</label>  
      <title>Tracking ID</title>  
      <helper></helper>  
      <abbr>GA</abbr>  
    </google_analytics>  
    <google_tag_manager>
      <enabled>1</enabled>  
      <label>Google Tag Manager</label>  
      <title>GTM ID</title>  
      <helper></helper>  
      <abbr>GTAG</abbr>  
    </google_tag_manager>  
    <linkedin>
      <enabled>1</enabled>  
      <label>LinkedIn Insight Tag</label>  
      <title>Partner ID (linkedin_data_partner_id)</title>  
      <helper></helper>  
      <abbr>LI</abbr>  
    </linkedin>  
    <manychat>
      <enabled>1</enabled>  
      <label>ManyChat Pixel/Widget</label>  
      <title>Pixel/Widget ID</title>  
      <helper></helper>  
      <abbr>MC</abbr>  
    </manychat>  
    <pinterest>
      <enabled>1</enabled>  
      <label>Pinterest Conversion Tag</label>  
      <title>Pinterest Pixel ID</title>  
      <helper></helper>  
      <abbr>PIN</abbr>  
    </pinterest>  
    <quora>
      <enabled>1</enabled>  
      <label>Quora Pixel ID</label>  
      <title>Pixel ID</title>  
      <helper></helper>  
      <abbr>Q</abbr>  
    </quora>  
    <reddit>
      <enabled>1</enabled>  
      <label>Reddit Pixel</label>  
      <title>ID Inserzionista</title>  
      <helper></helper>  
      <abbr>R</abbr>  
    </reddit>  
    <snapchat>
      <enabled>1</enabled>  
      <label>Snapchat Pixel</label>  
      <title>Pixel ID</title>  
      <helper></helper>  
      <abbr>SC</abbr>  
    </snapchat>  
    <tiktok>
      <enabled>1</enabled>  
      <label>TikTok Pixel</label>  
      <title>Pixel ID</title>  
      <helper></helper>  
      <abbr>TT</abbr>  
    </tiktok>  
    <twitter>
      <enabled>1</enabled>  
      <label>Twitter conversion tracking</label>  
      <title>Website Tag ID</title>  
      <helper></helper>  
      <abbr>TW</abbr>  
    </twitter>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_adroll_enabled=1
result_adroll_label=Adroll Pixel
result_adroll_title=Advertiser ID|Pixel ID
result_adroll_helper=
result_adroll_abbr=AR
result_bing_enabled=1
result_bing_label=Bing Universal Event Tracking
result_bing_title=UET Pixel ID
result_bing_helper=
result_bing_abbr=BNG
result_custom_enabled=1
result_custom_label=Custom remarketing code
result_custom_title=Remarketing code (including opening and closing tags)
result_custom_helper=
result_custom_abbr=CSTM
result_facebook_enabled=1
result_facebook_label=Facebook Pixel
result_facebook_title=Pixel ID
result_facebook_helper=
result_facebook_abbr=FB
result_google_adwords_enabled=1
result_google_adwords_label=AdWords tag for websites
result_google_adwords_title=Conversion ID
result_google_adwords_helper=
result_google_adwords_abbr=ADWS
result_google_analytics_enabled=1
result_google_analytics_label=Google Analytics Tracking code
result_google_analytics_title=Tracking ID
result_google_analytics_helper=
result_google_analytics_abbr=GA
result_google_tag_manager_enabled=1
result_google_tag_manager_label=Google Tag Manager
result_google_tag_manager_title=GTM ID
result_google_tag_manager_helper=
result_google_tag_manager_abbr=GTAG
result_linkedin_enabled=1
result_linkedin_label=LinkedIn Insight Tag
result_linkedin_title=Partner ID (linkedin_data_partner_id)
result_linkedin_helper=
result_linkedin_abbr=LI
result_manychat_enabled=1
result_manychat_label=ManyChat Pixel/Widget
result_manychat_title=Pixel/Widget ID
result_manychat_helper=
result_manychat_abbr=MC
result_pinterest_enabled=1
result_pinterest_label=Pinterest Conversion Tag
result_pinterest_title=Pinterest Pixel ID
result_pinterest_helper=
result_pinterest_abbr=PIN
result_quora_enabled=1
result_quora_label=Quora Pixel ID
result_quora_title=Pixel ID
result_quora_helper=
result_quora_abbr=Q
result_reddit_enabled=1
result_reddit_label=Reddit Pixel
result_reddit_title=ID Inserzionista
result_reddit_helper=
result_reddit_abbr=R
result_snapchat_enabled=1
result_snapchat_label=Snapchat Pixel
result_snapchat_title=Pixel ID
result_snapchat_helper=
result_snapchat_abbr=SC
result_tiktok_enabled=1
result_tiktok_label=TikTok Pixel
result_tiktok_title=Pixel ID
result_tiktok_helper=
result_tiktok_abbr=TT
result_twitter_enabled=1
result_twitter_label=Twitter conversion tracking
result_twitter_title=Website Tag ID
result_twitter_helper=
result_twitter_abbr=TW

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/property?format=plain

Query parameters

format = plain

Response

1
Adroll Pixel
Advertiser ID|Pixel ID

AR
1
Bing Universal Event Tracking
UET Pixel ID

BNG
1
Custom remarketing code
Remarketing code (including opening and closing tags)

CSTM
1
Facebook Pixel
Pixel ID

FB
1
AdWords tag for websites
Conversion ID

ADWS
1
Google Analytics Tracking code
Tracking ID

GA
1
Google Tag Manager
GTM ID

GTAG
1
LinkedIn Insight Tag
Partner ID (linkedin_data_partner_id)

LI
1
ManyChat Pixel/Widget
Pixel/Widget ID

MC
1
Pinterest Conversion Tag
Pinterest Pixel ID

PIN
1
Quora Pixel ID
Pixel ID

Q
1
Reddit Pixel
ID Inserzionista

R
1
Snapchat Pixel
Pixel ID

SC
1
TikTok Pixel
Pixel ID

TT
1
Twitter conversion tracking
Website Tag ID

TW

Return values

parameter	description
data	array containing supported remarketing pixels

/remarketings/urls

/remarketings/urls/count

access: [READ]

This method returns the number of user's tracking links linked to a remarketing pixel.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/urls/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 8
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/urls/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>8</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/urls/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/urls/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/remarketings/urls/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/remarketings/urls/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/remarketings/urls/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/remarketings/urls/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Required parameters

parameter	description
remarketing_idID	remarketing pixel (internal) ID

Optional parameters

parameter	description
searchSTRING	count tracking links by searching them

Return values

parameter	description
count	number of tracking links (filtered by search if passed)

/remarketings/urls/list

access: [READ]

This method returns a list of user's tracking links data linked to a remarketing pixel.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits

Query parameters

fields = count,id,project_name,long_url,project_id,short_url,visits

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "75219589a96d868187abe25e4dfdcb49",
        "project_name": "project name 1",
        "long_url": "https:\/\/google.com\/",
        "project_id": "97f7afefbcb11176d93a5408ebf00ad2",
        "short_url": "https:\/\/my.domain.ext\/alias1",
        "visits": 1234
      },
      {
        "id": "6f440160ba79fde29494cb67d3dc1e5c",
        "project_name": "project name 2",
        "long_url": "https:\/\/google.com\/",
        "project_id": "816929761e09c510c9cdfa3315dd7d41",
        "short_url": "https:\/\/my.domain.ext\/alias2",
        "visits": 4321
      }
    ],
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits&format=xml

Query parameters

fields = count,id,project_name,long_url,project_id,short_url,visits
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>75219589a96d868187abe25e4dfdcb49</id>  
        <project_name>project name 1</project_name>  
        <long_url>https://google.com/</long_url>  
        <project_id>97f7afefbcb11176d93a5408ebf00ad2</project_id>  
        <short_url>https://my.domain.ext/alias1</short_url>  
        <visits>1234</visits>  
      </i0>  
      <i1>
        <id>6f440160ba79fde29494cb67d3dc1e5c</id>  
        <project_name>project name 2</project_name>  
        <long_url>https://google.com/</long_url>  
        <project_id>816929761e09c510c9cdfa3315dd7d41</project_id>  
        <short_url>https://my.domain.ext/alias2</short_url>  
        <visits>4321</visits>  
      </i1>  
    </data>  
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits&format=txt

Query parameters

fields = count,id,project_name,long_url,project_id,short_url,visits
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=75219589a96d868187abe25e4dfdcb49
result_data_0_project_name=project name 1
result_data_0_long_url=https://google.com/
result_data_0_project_id=97f7afefbcb11176d93a5408ebf00ad2
result_data_0_short_url=https://my.domain.ext/alias1
result_data_0_visits=1234
result_data_1_id=6f440160ba79fde29494cb67d3dc1e5c
result_data_1_project_name=project name 2
result_data_1_long_url=https://google.com/
result_data_1_project_id=816929761e09c510c9cdfa3315dd7d41
result_data_1_short_url=https://my.domain.ext/alias2
result_data_1_visits=4321
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits&format=plain

Query parameters

fields = count,id,project_name,long_url,project_id,short_url,visits
format = plain

Response

https://my.domain.ext/alias1
https://my.domain.ext/alias2
2

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: project_name, long_url, id, project_id, short_url, visits, count
remarketing_idID	remarketing pixel (internal) ID

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: project_name, long_url, id, project_id, short_url, visits, count
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	[OPTIONAL] total number of (filtered) urls, returned only if count is passed in fields
data	array containing information on the tracking link associated with the remarketing pixel

/ssos

/ssos/add

access: [WRITE]

Add a new Single sign-on (SSO) authentication configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ssos/add?id=fbd270cf8979e1aef61272e580997d25

Query parameters

id = fbd270cf8979e1aef61272e580997d25

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "fbd270cf8979e1aef61272e580997d25",
    "domain": "joturl.com",
    "entity_id": "https:\/\/sso.example.com\/saml2?idpid=f974rt36",
    "provider_url": "https:\/\/sso.example.com\/saml2\/ipd?idpid=f974rt36",
    "certificate": "-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----",
    "certificate_subject": "Example LLC",
    "certificate_issuer": "Example LLC",
    "certificate_valid_from": "2026-05-26 14:00:32",
    "certificate_valid_to": "2036-05-26 14:00:32",
    "certificate_key_bits": 2048,
    "domain_verification": "joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE",
    "domain_verified": 1,
    "enabled": 1,
    "sp_acs_url": "https:\/\/example.com\/saml\/acs",
    "sp_entity_id": "https:\/\/example.com\/saml\/metadata"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ssos/add?id=fbd270cf8979e1aef61272e580997d25&format=xml

Query parameters

    id = fbd270cf8979e1aef61272e580997d25
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>fbd270cf8979e1aef61272e580997d25</id>  
    <domain>joturl.com</domain>  
    <entity_id>https://sso.example.com/saml2?idpid=f974rt36</entity_id>  
    <provider_url>https://sso.example.com/saml2/ipd?idpid=f974rt36</provider_url>  
    <certificate>-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----</certificate>  
    <certificate_subject>Example LLC</certificate_subject>  
    <certificate_issuer>Example LLC</certificate_issuer>  
    <certificate_valid_from>2026-05-26 14:00:32</certificate_valid_from>  
    <certificate_valid_to>2036-05-26 14:00:32</certificate_valid_to>  
    <certificate_key_bits>2048</certificate_key_bits>  
    <domain_verification>joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE</domain_verification>  
    <domain_verified>1</domain_verified>  
    <enabled>1</enabled>  
    <sp_acs_url>https://example.com/saml/acs</sp_acs_url>  
    <sp_entity_id>https://example.com/saml/metadata</sp_entity_id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ssos/add?id=fbd270cf8979e1aef61272e580997d25&format=txt

Query parameters

    id = fbd270cf8979e1aef61272e580997d25
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=fbd270cf8979e1aef61272e580997d25
result_domain=joturl.com
result_entity_id=https://sso.example.com/saml2?idpid=f974rt36
result_provider_url=https://sso.example.com/saml2/ipd?idpid=f974rt36
result_certificate=-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----
result_certificate_subject=Example LLC
result_certificate_issuer=Example LLC
result_certificate_valid_from=2026-05-26 14:00:32
result_certificate_valid_to=2036-05-26 14:00:32
result_certificate_key_bits=2048
result_domain_verification=joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE
result_domain_verified=1
result_enabled=1
result_sp_acs_url=https://example.com/saml/acs
result_sp_entity_id=https://example.com/saml/metadata

Example 4 (plain)

Request

https://joturl.com/a/i1/ssos/add?id=fbd270cf8979e1aef61272e580997d25&format=plain

Query parameters

    id = fbd270cf8979e1aef61272e580997d25
format = plain

Response

fbd270cf8979e1aef61272e580997d25
joturl.com
https://sso.example.com/saml2?idpid=f974rt36
https://sso.example.com/saml2/ipd?idpid=f974rt36
-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----
Example LLC
Example LLC
2026-05-26 14:00:32
2036-05-26 14:00:32
2048
joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE
1
1
https://example.com/saml/acs
https://example.com/saml/metadata

Optional parameters

parameter	description	max length
certificateSTRING	Identity provider certificate, an X.509 certificate	8000
domainSTRING	SSO organization's email domain	850
entity_idSTRING	Issuer ID, this is also called an Entity ID	4000
idID	ID of the SSO configuration
provider_urlSTRING	Identity provider URL, this is also called a single sign-on URL or SAML endpoint.	4000

Return values

parameter	description
certificate	[OPTIONAL] Identity provider certificate, returned only if available
certificate_issuer	[OPTIONAL] Identity provider certificate issuer, returned only if available
certificate_key_bits	[OPTIONAL] Identity provider certificate key bits, returned only if available
certificate_subject	[OPTIONAL] Identity provider certificate subject, returned only if available
certificate_valid_from	[OPTIONAL] Identity provider certificate valid from (UTC), returned only if available
certificate_valid_to	[OPTIONAL] Identity provider certificate expiration (UTC), returned only if available
domain	domain associated with the SSO configuration
domain_verification	DNS verification string
domain_verified	1 if domain ownership has been verified, 0 otherwise
enabled	1 if SSO is enabled, 0 otherwise
entity_id	[OPTIONAL] Issuer ID, returned only if available
id	ID of the SSO configuration
provider_url	[OPTIONAL] Identity provider URL, returned only if available
sp_acs_url	[OPTIONAL] ACS URL to use to configure service provider (JotUrl) in Identity Provider configuration, returned only if SSO domain has been verified
sp_entity_id	[OPTIONAL] Entity ID URL to use to configure service provider (JotUrl) in Identity Provider configuration, returned only if SSO domain has been verified

This endpoint returns the current Single Sign-On (SSO) configuration state for the requesting domain.

The state machine follows a predefined flow, based on domain validation, Identity Provider (IdP) configuration, and activation status.

The response allows client applications to determine the next step required in the SSO setup process.

State Logic

The SSO state is determined by evaluating the configuration in the following order:

#	state	condition	next step
1	domain verification	a domain is set but not yet verified	the system is waiting for ownership verification (DNS)
2	set Identity Provider	the domain is verified, but the IdP configuration is incomplete	one or more mandatory parameters are missing: `entity_id`, `provider_url`, `certificate`, `certificate`
3	pending enabling	when the domain is verified, the IdP configuration is complete, but SSO has not been enabled yet	the system is ready but awaiting explicit activation
4	edit Identity Provider	when SSO is enabled and fully configured	the system is in “edit mode”, allowing administrators to update IdP details (every change requires a new activation)

NOTE: parameters sp_acs_url and sp_entity_id must be used to configure Single Sign-On (SSO) in your identity provider's web app.

/ssos/count

access: [READ]

This method returns the number of available SSO configurations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ssos/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ssos/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ssos/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/ssos/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/ssos/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/ssos/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/ssos/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/ssos/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	count SSO configurations by searching them

Return values

parameter	description
count	number of SSO configurations the user has access to (filtered by search if passed)

/ssos/delete

access: [WRITE]

Delete SSO configurations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ssos/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc

Query parameters

ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ssos/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=xml

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ssos/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=txt

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/ssos/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=plain

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/ssos/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143

Query parameters

ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/ssos/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=xml

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/ssos/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=txt

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/ssos/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=plain

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = plain

Response

334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of domain IDs to be deleted, max number of IDs in the list: 100

Return values

parameter	description
deleted	number of deleted SSO configurations
ids	[OPTIONAL] list of SSO configuration IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/ssos/disable

access: [WRITE]

Disable a Single sign-on (SSO) configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ssos/disable?id=59e38e6e3ed36ef8503257f09b834492

Query parameters

id = 59e38e6e3ed36ef8503257f09b834492

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "disabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ssos/disable?id=59e38e6e3ed36ef8503257f09b834492&format=xml

Query parameters

    id = 59e38e6e3ed36ef8503257f09b834492
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <disabled>1</disabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ssos/disable?id=59e38e6e3ed36ef8503257f09b834492&format=txt

Query parameters

    id = 59e38e6e3ed36ef8503257f09b834492
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_disabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/ssos/disable?id=59e38e6e3ed36ef8503257f09b834492&format=plain

Query parameters

    id = 59e38e6e3ed36ef8503257f09b834492
format = plain

Response

Optional parameters

parameter	description
idID	ID of the SSO configuration to be disabled

Return values

parameter	description
disabled	1 if SSO was disabled, 0 otherwise

/ssos/info

access: [READ]

This method returns information about an SSO configuration; the information returned is that passed in the fields parameter (a comma-separated list).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ssos/info?id=80d5a40e26237e8914fb07f3606ae593&fields=domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url

Query parameters

    id = 80d5a40e26237e8914fb07f3606ae593
fields = domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "80d5a40e26237e8914fb07f3606ae593",
    "domain": "joturl.com",
    "entity_id": "https:\/\/sso.example.com\/saml2?idpid=f974rt36",
    "provider_url": "https:\/\/sso.example.com\/saml2\/ipd?idpid=f974rt36",
    "certificate": "-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----",
    "certificate_subject": "Example LLC",
    "certificate_issuer": "Example LLC",
    "certificate_valid_from": "2026-05-26 14:00:32",
    "certificate_valid_to": "2036-05-26 14:00:32",
    "certificate_key_bits": 2048,
    "domain_verification": "joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE",
    "domain_verified": 1,
    "enabled": 1,
    "sp_acs_url": "https:\/\/example.com\/saml\/acs",
    "sp_entity_id": "https:\/\/example.com\/saml\/metadata"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ssos/info?id=80d5a40e26237e8914fb07f3606ae593&fields=domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url&format=xml

Query parameters

    id = 80d5a40e26237e8914fb07f3606ae593
fields = domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>80d5a40e26237e8914fb07f3606ae593</id>  
    <domain>joturl.com</domain>  
    <entity_id>https://sso.example.com/saml2?idpid=f974rt36</entity_id>  
    <provider_url>https://sso.example.com/saml2/ipd?idpid=f974rt36</provider_url>  
    <certificate>-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----</certificate>  
    <certificate_subject>Example LLC</certificate_subject>  
    <certificate_issuer>Example LLC</certificate_issuer>  
    <certificate_valid_from>2026-05-26 14:00:32</certificate_valid_from>  
    <certificate_valid_to>2036-05-26 14:00:32</certificate_valid_to>  
    <certificate_key_bits>2048</certificate_key_bits>  
    <domain_verification>joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE</domain_verification>  
    <domain_verified>1</domain_verified>  
    <enabled>1</enabled>  
    <sp_acs_url>https://example.com/saml/acs</sp_acs_url>  
    <sp_entity_id>https://example.com/saml/metadata</sp_entity_id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ssos/info?id=80d5a40e26237e8914fb07f3606ae593&fields=domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url&format=txt

Query parameters

    id = 80d5a40e26237e8914fb07f3606ae593
fields = domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=80d5a40e26237e8914fb07f3606ae593
result_domain=joturl.com
result_entity_id=https://sso.example.com/saml2?idpid=f974rt36
result_provider_url=https://sso.example.com/saml2/ipd?idpid=f974rt36
result_certificate=-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----
result_certificate_subject=Example LLC
result_certificate_issuer=Example LLC
result_certificate_valid_from=2026-05-26 14:00:32
result_certificate_valid_to=2036-05-26 14:00:32
result_certificate_key_bits=2048
result_domain_verification=joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE
result_domain_verified=1
result_enabled=1
result_sp_acs_url=https://example.com/saml/acs
result_sp_entity_id=https://example.com/saml/metadata

Example 4 (plain)

Request

https://joturl.com/a/i1/ssos/info?id=80d5a40e26237e8914fb07f3606ae593&fields=domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url&format=plain

Query parameters

    id = 80d5a40e26237e8914fb07f3606ae593
fields = domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url
format = plain

Response

80d5a40e26237e8914fb07f3606ae593
joturl.com
https://sso.example.com/saml2?idpid=f974rt36
https://sso.example.com/saml2/ipd?idpid=f974rt36
-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----
Example LLC
Example LLC
2026-05-26 14:00:32
2036-05-26 14:00:32
2048
joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE
1
1
https://example.com/saml/acs
https://example.com/saml/metadata

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: domain, domain_verification, domain_verified, enabled, entity_id, id, certificate, certificate_issuer, certificate_key_bits, certificate_subject, certificate_valid_from, certificate_valid_to, provider_url, sp_acs_url, sp_entity_id
idID	ID of the SSO configuration

Return values

parameter	description
certificate	[OPTIONAL] Identity provider certificate, returned only if available
certificate_issuer	[OPTIONAL] Identity provider certificate issuer, returned only if available
certificate_key_bits	[OPTIONAL] Identity provider certificate key bits, returned only if available
certificate_subject	[OPTIONAL] Identity provider certificate subject, returned only if available
certificate_valid_from	[OPTIONAL] Identity provider certificate valid from (UTC), returned only if available
certificate_valid_to	[OPTIONAL] Identity provider certificate expiration (UTC), returned only if available
domain	domain associated with the SSO configuration
domain_verification	DNS verification string
domain_verified	1 if domain ownership has been verified, 0 otherwise
enabled	1 if SSO is enabled, 0 otherwise
entity_id	[OPTIONAL] Issuer ID, returned only if available
id	ID of the SSO configuration
provider_url	[OPTIONAL] Identity provider URL, returned only if available
sp_acs_url	[OPTIONAL] ACS URL to use to configure service provider (JotUrl) in Identity Provider configuration, returned only if SSO domain has been verified
sp_entity_id	[OPTIONAL] Entity ID URL to use to configure service provider (JotUrl) in Identity Provider configuration, returned only if SSO domain has been verified

/ssos/list

access: [READ]

This method returns a list of SSO configurations; the information returned is that passed in the fields parameter (a comma-separated list).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ssos/list?fields=count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count

Query parameters

fields = count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "49b1fb40da24aeed061c91515ef8d7b9",
        "domain": "joturl.com",
        "entity_id": "https:\/\/sso.example.com\/saml2?idpid=f974rt36",
        "provider_url": "https:\/\/sso.example.com\/saml2\/ipd?idpid=f974rt36",
        "certificate": "-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----",
        "certificate_subject": "Example LLC",
        "certificate_issuer": "Example LLC",
        "certificate_valid_from": "2026-05-26 14:00:32",
        "certificate_valid_to": "2036-05-26 14:00:32",
        "certificate_key_bits": 2048,
        "domain_verification": "joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE",
        "domain_verified": 1,
        "enabled": 1
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ssos/list?fields=count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count&format=xml

Query parameters

fields = count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>49b1fb40da24aeed061c91515ef8d7b9</id>  
        <domain>joturl.com</domain>  
        <entity_id>https://sso.example.com/saml2?idpid=f974rt36</entity_id>  
        <provider_url>https://sso.example.com/saml2/ipd?idpid=f974rt36</provider_url>  
        <certificate>-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----</certificate>  
        <certificate_subject>Example LLC</certificate_subject>  
        <certificate_issuer>Example LLC</certificate_issuer>  
        <certificate_valid_from>2026-05-26 14:00:32</certificate_valid_from>  
        <certificate_valid_to>2036-05-26 14:00:32</certificate_valid_to>  
        <certificate_key_bits>2048</certificate_key_bits>  
        <domain_verification>joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE</domain_verification>  
        <domain_verified>1</domain_verified>  
        <enabled>1</enabled>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/ssos/list?fields=count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count&format=txt

Query parameters

fields = count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=49b1fb40da24aeed061c91515ef8d7b9
result_data_0_domain=joturl.com
result_data_0_entity_id=https://sso.example.com/saml2?idpid=f974rt36
result_data_0_provider_url=https://sso.example.com/saml2/ipd?idpid=f974rt36
result_data_0_certificate=-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----
result_data_0_certificate_subject=Example LLC
result_data_0_certificate_issuer=Example LLC
result_data_0_certificate_valid_from=2026-05-26 14:00:32
result_data_0_certificate_valid_to=2036-05-26 14:00:32
result_data_0_certificate_key_bits=2048
result_data_0_domain_verification=joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE
result_data_0_domain_verified=1
result_data_0_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/ssos/list?fields=count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count&format=plain

Query parameters

fields = count,domain,domain_verification,domain_verified,enabled,entity_id,id,certificate,certificate_issuer,certificate_key_bits,certificate_subject,certificate_valid_from,certificate_valid_to,provider_url,count
format = plain

Response

49b1fb40da24aeed061c91515ef8d7b9
joturl.com
https://sso.example.com/saml2?idpid=f974rt36
https://sso.example.com/saml2/ipd?idpid=f974rt36
-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----
Example LLC
Example LLC
2026-05-26 14:00:32
2036-05-26 14:00:32
2048
joturl-verification=84FE4050F1A2E19B51128EA3F4CE82EB4EACFDBE0033CB244E28EF0585E530AE
1
1

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: domain, domain_verification, domain_verified, enabled, entity_id, id, certificate, certificate_issuer, certificate_key_bits, certificate_subject, certificate_valid_from, certificate_valid_to, provider_url, count

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: domain, domain_verification, domain_verified, enabled, entity_id, id, certificate, certificate_issuer, certificate_key_bits, certificate_subject, certificate_valid_from, certificate_valid_to, provider_url, count
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	[OPTIONAL] total number of SSO configurations, returned only if count is passed in fields
data	array containing required information on SSO configurations the user has access to

/stats

/stats/conversions

/stats/conversions/get

access: [READ]

This method returns information about stats.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=c31034df26c2c2e32c132a74d2768900&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13

Query parameters

conversion_id = c31034df26c2c2e32c132a74d2768900
       charts = tl_snapshot
   start_date = 2020-01-01
     end_date = 2020-10-13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "tl_snapshot": {
      "type": "line",
      "series": [
        "visits",
        "unique_visits",
        "mobile",
        "unique_mobile",
        "qrcode_scans"
      ],
      "types": {
        "x": "Ym",
        "count": "int"
      },
      "data": {
        "visits": {
          "2020-03": {
            "count": 2
          }
        },
        "unique_visits": {
          "2020-03": {
            "count": 0
          }
        },
        "mobile": {
          "2020-03": {
            "count": 0
          }
        },
        "unique_mobile": {
          "2020-03": {
            "count": 0
          }
        },
        "qrcode_scans": {
          "2020-03": {
            "count": 0
          }
        }
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=c31034df26c2c2e32c132a74d2768900&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13&format=xml

Query parameters

conversion_id = c31034df26c2c2e32c132a74d2768900
       charts = tl_snapshot
   start_date = 2020-01-01
     end_date = 2020-10-13
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <tl_snapshot>
      <type>line</type>  
      <series>
        <i0>visits</i0>  
        <i1>unique_visits</i1>  
        <i2>mobile</i2>  
        <i3>unique_mobile</i3>  
        <i4>qrcode_scans</i4>  
      </series>  
      <types>
        <x>Ym</x>  
        <count>int</count>  
      </types>  
      <data>
        <visits>
          <2020-03>
            <count>2</count>  
          </2020-03>  
        </visits>  
        <unique_visits>
          <2020-03>
            <count>0</count>  
          </2020-03>  
        </unique_visits>  
        <mobile>
          <2020-03>
            <count>0</count>  
          </2020-03>  
        </mobile>  
        <unique_mobile>
          <2020-03>
            <count>0</count>  
          </2020-03>  
        </unique_mobile>  
        <qrcode_scans>
          <2020-03>
            <count>0</count>  
          </2020-03>  
        </qrcode_scans>  
      </data>  
    </tl_snapshot>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=c31034df26c2c2e32c132a74d2768900&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13&format=txt

Query parameters

conversion_id = c31034df26c2c2e32c132a74d2768900
       charts = tl_snapshot
   start_date = 2020-01-01
     end_date = 2020-10-13
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_snapshot_type=line
result_tl_snapshot_series_0=visits
result_tl_snapshot_series_1=unique_visits
result_tl_snapshot_series_2=mobile
result_tl_snapshot_series_3=unique_mobile
result_tl_snapshot_series_4=qrcode_scans
result_tl_snapshot_types_x=Ym
result_tl_snapshot_types_count=int
result_tl_snapshot_data_visits_2020-03_count=2
result_tl_snapshot_data_unique_visits_2020-03_count=0
result_tl_snapshot_data_mobile_2020-03_count=0
result_tl_snapshot_data_unique_mobile_2020-03_count=0
result_tl_snapshot_data_qrcode_scans_2020-03_count=0

Example 4 (plain)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=c31034df26c2c2e32c132a74d2768900&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13&format=plain

Query parameters

conversion_id = c31034df26c2c2e32c132a74d2768900
       charts = tl_snapshot
   start_date = 2020-01-01
     end_date = 2020-10-13
       format = plain

Response

line
visits
unique_visits
mobile
unique_mobile
qrcode_scans
Ym
int
2
0
0
0
0

Example 5 (json)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=d334d543a0873212dee2a119bf6c826c&url_id=6615a74730fa13d8d19becbc863d7942&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13

Query parameters

conversion_id = d334d543a0873212dee2a119bf6c826c
       url_id = 6615a74730fa13d8d19becbc863d7942
       charts = tl_countries
   start_date = 2020-10-01
     end_date = 2020-10-13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "type": "doughnut",
    "series": [
      "countries"
    ],
    "types": {
      "count": "int"
    },
    "data": {
      "countries": {
        "Italia": {
          "count": 2
        }
      }
    },
    "table": {
      "Italia": {
        "visits": 2,
        "unique_visits": 0,
        "mobile": 0,
        "unique_mobile": 0,
        "qrcode_scans": 0
      }
    }
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=d334d543a0873212dee2a119bf6c826c&url_id=6615a74730fa13d8d19becbc863d7942&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13&format=xml

Query parameters

conversion_id = d334d543a0873212dee2a119bf6c826c
       url_id = 6615a74730fa13d8d19becbc863d7942
       charts = tl_countries
   start_date = 2020-10-01
     end_date = 2020-10-13
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <type>doughnut</type>  
    <series>
      <i0>countries</i0>  
    </series>  
    <types>
      <count>int</count>  
    </types>  
    <data>
      <countries>
        <Italia>
          <count>2</count>  
        </Italia>  
      </countries>  
    </data>  
    <table>
      <Italia>
        <visits>2</visits>  
        <unique_visits>0</unique_visits>  
        <mobile>0</mobile>  
        <unique_mobile>0</unique_mobile>  
        <qrcode_scans>0</qrcode_scans>  
      </Italia>  
    </table>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=d334d543a0873212dee2a119bf6c826c&url_id=6615a74730fa13d8d19becbc863d7942&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13&format=txt

Query parameters

conversion_id = d334d543a0873212dee2a119bf6c826c
       url_id = 6615a74730fa13d8d19becbc863d7942
       charts = tl_countries
   start_date = 2020-10-01
     end_date = 2020-10-13
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_type=doughnut
result_series_0=countries
result_types_count=int
result_data_countries_Italia_count=2
result_table_Italia_visits=2
result_table_Italia_unique_visits=0
result_table_Italia_mobile=0
result_table_Italia_unique_mobile=0
result_table_Italia_qrcode_scans=0

Example 8 (plain)

Request

https://joturl.com/a/i1/stats/conversions/get?conversion_id=d334d543a0873212dee2a119bf6c826c&url_id=6615a74730fa13d8d19becbc863d7942&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13&format=plain

Query parameters

conversion_id = d334d543a0873212dee2a119bf6c826c
       url_id = 6615a74730fa13d8d19becbc863d7942
       charts = tl_countries
   start_date = 2020-10-01
     end_date = 2020-10-13
       format = plain

Response

doughnut
countries
int
2
2
0
0
0
0

Required parameters

parameter	description
chartsARRAY	comma separated list of charts, for a detailed list of charts see i1/stats/conversions/info

Optional parameters

parameter	description
conversion_idID	ID of the conversion for which to extract statistics
end_dateDATE	extract statistics up to this date (included)
ep00_idID	filter conversion data by using the ID of the extended parameter ep00, see i1/conversions/codes/params/list for details
ep01_idID	filter conversion data by using the ID of the extended parameter ep01, see i1/conversions/codes/params/list for details
ep02_idID	filter conversion data by using the ID of the extended parameter ep02, see i1/conversions/codes/params/list for details
ep03_idID	filter conversion data by using the ID of the extended parameter ep03, see i1/conversions/codes/params/list for details
ep04_idID	filter conversion data by using the ID of the extended parameter ep04, see i1/conversions/codes/params/list for details
ep05_idID	filter conversion data by using the ID of the extended parameter ep05, see i1/conversions/codes/params/list for details
ep06_idID	filter conversion data by using the ID of the extended parameter ep06, see i1/conversions/codes/params/list for details
ep07_idID	filter conversion data by using the ID of the extended parameter ep07, see i1/conversions/codes/params/list for details
ep08_idID	filter conversion data by using the ID of the extended parameter ep08, see i1/conversions/codes/params/list for details
ep09_idID	filter conversion data by using the ID of the extended parameter ep09, see i1/conversions/codes/params/list for details
ep10_idID	filter conversion data by using the ID of the extended parameter ep10, see i1/conversions/codes/params/list for details
ep11_idID	filter conversion data by using the ID of the extended parameter ep11, see i1/conversions/codes/params/list for details
ep12_idID	filter conversion data by using the ID of the extended parameter ep12, see i1/conversions/codes/params/list for details
ep13_idID	filter conversion data by using the ID of the extended parameter ep13, see i1/conversions/codes/params/list for details
ep14_idID	filter conversion data by using the ID of the extended parameter ep14, see i1/conversions/codes/params/list for details
map_typeSTRING	used only when charts contains `tl_map`, see i1/stats/projects/get for details
param_idID	filter conversion data by using the ID of the parameter, see i1/conversions/codes/params/list for details
start_dateDATE	extract statistics from this date (included)
url_idID	ID of the tracking link for which to extract statistics

Return values

parameter	description
data	JSON object in the format {"chart": {[CHART INFO]}}

For each valid element passed in charts (e.g., summary_snapshot_value, tl_browsers), there will be a corresponding element in the output identified by chart (e.g., tl_browsers). The object {[CHART INFO]} has the following fields:

type: chart type, it can be line, map, doughnut
series: an array of the series in the output (e.g., ["visits","unique_visits","mobile","unique_mobile","qrcode_scans"])
types: object that describes the output types in the format "output_field": "output_type", a special case is output_field = x which describes the type of the values on the abscissa of the chart
data: output data in the format {"serie1":{"abscissa value 1":{"output_field1":"output_value1"}, ..., "abscissa value N":{"output_fieldN":"output_valueN"}}, ..., "serieM":{"abscissa value 1":{"output_field1":"output_value1"}, ..., "abscissa value N":{"output_fieldN":"output_valueN"}}}
table: only returned when type = doughnut, it contains items with the format {"abscissa value 1":{visits:V1,unique_visits:UV1,mobile:M1,unique_mobile:UM1,qrcode_scans:Q1}, ..., "abscissa value N":{visits:VN,unique_visits:UVN,mobile:MN,unique_mobile:UMN,qrcode_scans: QN}}
locations: only returned when type = map, it contains items with the format {{"count":[visits],"country":{"name":"[country name]","code":"[ISO 3166 country code]"}, "region":{"name":"[region name]"}, "city":{"name":"[city name]","latitude":[city latitude (float)],"longitude":[city longitude (float)]}}
markers: only returned when type = map, it contains items with the format [{"location":[index in the locations object], "isUnique":[1 if conversion for a non-returning user, 0 otherwise], "isQrCode":[1 if conversion from a QR code scan, 0 otherwise], "isMobile":[1 if conversion from a mobile devices, 0 otherwise], "count":[number of conversions], "ip":"[IPv4 address]"},...]
nodata: returned when no data is available (always equal to 1 if present).

Where:

visits: number of conversions
unique_visits: number of conversions coming from unique visitors
mobile: number of conversions coming from a mobile device
unique_mobile: number of conversions coming from unique visitors using a mobile device
qrcode_scans: number of conversions coming from QR code scans.

For available values for output_type see i1/stats/projects/get.

/stats/conversions/info

access: [READ]

This method returns information about stats.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=47356218fa00dc7565098bbe9c9a72a5&url_id=cf5279c763c68891fb29a0d927c7444f

Query parameters

conversion_id = 47356218fa00dc7565098bbe9c9a72a5
       url_id = cf5279c763c68891fb29a0d927c7444f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "tl_snapshot",
    "tl_map",
    "tl_countries",
    "tl_regions",
    "tl_cities",
    "tl_languages",
    "tl_referrers",
    "tl_devices",
    "tl_browsers",
    "tl_platforms",
    "tl_operating_systems",
    "tl_ips",
    "tl_bots",
    "tl_conversions",
    "tl_commissions"
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=47356218fa00dc7565098bbe9c9a72a5&url_id=cf5279c763c68891fb29a0d927c7444f&format=xml

Query parameters

conversion_id = 47356218fa00dc7565098bbe9c9a72a5
       url_id = cf5279c763c68891fb29a0d927c7444f
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>tl_snapshot</i0>  
    <i1>tl_map</i1>  
    <i2>tl_countries</i2>  
    <i3>tl_regions</i3>  
    <i4>tl_cities</i4>  
    <i5>tl_languages</i5>  
    <i6>tl_referrers</i6>  
    <i7>tl_devices</i7>  
    <i8>tl_browsers</i8>  
    <i9>tl_platforms</i9>  
    <i10>tl_operating_systems</i10>  
    <i11>tl_ips</i11>  
    <i12>tl_bots</i12>  
    <i13>tl_conversions</i13>  
    <i14>tl_commissions</i14>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=47356218fa00dc7565098bbe9c9a72a5&url_id=cf5279c763c68891fb29a0d927c7444f&format=txt

Query parameters

conversion_id = 47356218fa00dc7565098bbe9c9a72a5
       url_id = cf5279c763c68891fb29a0d927c7444f
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
result_13=tl_conversions
result_14=tl_commissions

Example 4 (plain)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=47356218fa00dc7565098bbe9c9a72a5&url_id=cf5279c763c68891fb29a0d927c7444f&format=plain

Query parameters

conversion_id = 47356218fa00dc7565098bbe9c9a72a5
       url_id = cf5279c763c68891fb29a0d927c7444f
       format = plain

Response

tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
tl_conversions
tl_commissions

Example 5 (json)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=5fd68c86050883a75672f7c15b74612d

Query parameters

conversion_id = 5fd68c86050883a75672f7c15b74612d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "tl_snapshot",
    "tl_map",
    "tl_countries",
    "tl_regions",
    "tl_cities",
    "tl_languages",
    "tl_referrers",
    "tl_devices",
    "tl_browsers",
    "tl_platforms",
    "tl_operating_systems",
    "tl_ips",
    "tl_bots",
    "summary_snapshot_value",
    "summary_snapshot_commission"
  ]
}

Example 6 (xml)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=5fd68c86050883a75672f7c15b74612d&format=xml

Query parameters

conversion_id = 5fd68c86050883a75672f7c15b74612d
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>tl_snapshot</i0>  
    <i1>tl_map</i1>  
    <i2>tl_countries</i2>  
    <i3>tl_regions</i3>  
    <i4>tl_cities</i4>  
    <i5>tl_languages</i5>  
    <i6>tl_referrers</i6>  
    <i7>tl_devices</i7>  
    <i8>tl_browsers</i8>  
    <i9>tl_platforms</i9>  
    <i10>tl_operating_systems</i10>  
    <i11>tl_ips</i11>  
    <i12>tl_bots</i12>  
    <i13>summary_snapshot_value</i13>  
    <i14>summary_snapshot_commission</i14>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=5fd68c86050883a75672f7c15b74612d&format=txt

Query parameters

conversion_id = 5fd68c86050883a75672f7c15b74612d
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
result_13=summary_snapshot_value
result_14=summary_snapshot_commission

Example 8 (plain)

Request

https://joturl.com/a/i1/stats/conversions/info?conversion_id=5fd68c86050883a75672f7c15b74612d&format=plain

Query parameters

conversion_id = 5fd68c86050883a75672f7c15b74612d
       format = plain

Response

tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
summary_snapshot_value
summary_snapshot_commission

Example 9 (json)

Request

https://joturl.com/a/i1/stats/conversions/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "summary_snapshot_value",
    "summary_snapshot_commission"
  ]
}

Example 10 (xml)

Request

https://joturl.com/a/i1/stats/conversions/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>summary_snapshot_value</i0>  
    <i1>summary_snapshot_commission</i1>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/stats/conversions/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot_value
result_1=summary_snapshot_commission

Example 12 (plain)

Request

https://joturl.com/a/i1/stats/conversions/info?format=plain

Query parameters

format = plain

Response

summary_snapshot_value
summary_snapshot_commission

Optional parameters

parameter	description
conversion_idID	ID of the conversion for which to extract statistics
url_idID	ID of the tracking link for which to extract statistics

Return values

parameter	description
data	array of available charts for the given `conversion_id` and `url_id`

Available charts and descriptions

chart	type	description	A	C	T
tl_snapshot	line	overview of the tracking link conversions, unique conversions, conversions from mobile devices, conversions from unique mobile devices, conversions from QR code scans, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_map	map	overview of the tracking link conversions, unique conversions, conversions from mobile devices, conversions from unique mobile devices, conversions from QR code scans, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_countries	doughnut	top 10 countries from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_regions	doughnut	top 10 regions from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_cities	doughnut	top 10 cities from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_languages	doughnut	first 10 languages of users who visited the CTA, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_referrers	doughnut	top 10 referrers, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_devices	doughnut	first 10 devices of users who visited the CTA, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_browsers	doughnut	first 10 browsers of users who visited the CTA, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_platforms	doughnut	first 10 platforms of users who visited the CTA, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_operating_systems	doughnut	first 10 operating systems of users who visited the CTA, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_ips	doughnut	top 10 IPs from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_bots	line	overview of the CTA visits from bots, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_conversions	line	it is an overview of tracking link conversions, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
tl_commissions	line	it is an overview of tracking link commissions, if `url_id` is not passed, it returns data relating to the conversion and all associated tracking links	-	`C`	`T`
summary_snapshot_value	line	account level overview of conversions and their values	`A`	-	-
summary_snapshot_commission	line	account level overview of conversions and their commissions	`A`	-	-

Where:

A: account level chart (requires neither conversion_id nor url_id)
C: chart for tracking links with associated conversions (requires only conversion_id)
T: chart available for tracking links (requires conversion_id and url_id)
the presence in the table of both C and T means that the chart can be used both for a conversion and for a tracking link; when url_id is not passed, the data returned is for all tracking links associated with the conversion identified by conversion_id.

/stats/ctas

/stats/ctas/get

access: [READ]

This method returns information about stats.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13

Query parameters

    charts = summary_snapshot
start_date = 2018-09-01
  end_date = 2020-10-13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "summary_snapshot": {
      "type": "line",
      "series": [
        "ctas_visits",
        "ctas_clicks"
      ],
      "types": {
        "x": "Ym",
        "visits": "int",
        "clicks": "int"
      },
      "data": {
        "ctas_visits": {
          "2018-09": {
            "visits": 27
          },
          "2019-03": {
            "visits": 27
          },
          "2020-02": {
            "visits": 8
          },
          "2020-03": {
            "visits": 6
          },
          "2020-05": {
            "visits": 17
          },
          "2020-10": {
            "visits": 17
          }
        },
        "ctas_clicks": {
          "2018-09": {
            "clicks": 2
          },
          "2019-03": {
            "clicks": 2
          },
          "2020-02": {
            "clicks": 1
          },
          "2020-03": {
            "clicks": 1
          },
          "2020-05": {
            "clicks": 9
          },
          "2020-10": {
            "clicks": 2
          }
        }
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13&format=xml

Query parameters

    charts = summary_snapshot
start_date = 2018-09-01
  end_date = 2020-10-13
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <summary_snapshot>
      <type>line</type>  
      <series>
        <i0>ctas_visits</i0>  
        <i1>ctas_clicks</i1>  
      </series>  
      <types>
        <x>Ym</x>  
        <visits>int</visits>  
        <clicks>int</clicks>  
      </types>  
      <data>
        <ctas_visits>
          <2018-09>
            <visits>27</visits>  
          </2018-09>  
          <2019-03>
            <visits>27</visits>  
          </2019-03>  
          <2020-02>
            <visits>8</visits>  
          </2020-02>  
          <2020-03>
            <visits>6</visits>  
          </2020-03>  
          <2020-05>
            <visits>17</visits>  
          </2020-05>  
          <2020-10>
            <visits>17</visits>  
          </2020-10>  
        </ctas_visits>  
        <ctas_clicks>
          <2018-09>
            <clicks>2</clicks>  
          </2018-09>  
          <2019-03>
            <clicks>2</clicks>  
          </2019-03>  
          <2020-02>
            <clicks>1</clicks>  
          </2020-02>  
          <2020-03>
            <clicks>1</clicks>  
          </2020-03>  
          <2020-05>
            <clicks>9</clicks>  
          </2020-05>  
          <2020-10>
            <clicks>2</clicks>  
          </2020-10>  
        </ctas_clicks>  
      </data>  
    </summary_snapshot>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13&format=txt

Query parameters

    charts = summary_snapshot
start_date = 2018-09-01
  end_date = 2020-10-13
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_summary_snapshot_type=line
result_summary_snapshot_series_0=ctas_visits
result_summary_snapshot_series_1=ctas_clicks
result_summary_snapshot_types_x=Ym
result_summary_snapshot_types_visits=int
result_summary_snapshot_types_clicks=int
result_summary_snapshot_data_ctas_visits_2018-09_visits=27
result_summary_snapshot_data_ctas_visits_2019-03_visits=27
result_summary_snapshot_data_ctas_visits_2020-02_visits=8
result_summary_snapshot_data_ctas_visits_2020-03_visits=6
result_summary_snapshot_data_ctas_visits_2020-05_visits=17
result_summary_snapshot_data_ctas_visits_2020-10_visits=17
result_summary_snapshot_data_ctas_clicks_2018-09_clicks=2
result_summary_snapshot_data_ctas_clicks_2019-03_clicks=2
result_summary_snapshot_data_ctas_clicks_2020-02_clicks=1
result_summary_snapshot_data_ctas_clicks_2020-03_clicks=1
result_summary_snapshot_data_ctas_clicks_2020-05_clicks=9
result_summary_snapshot_data_ctas_clicks_2020-10_clicks=2

Example 4 (plain)

Request

https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13&format=plain

Query parameters

    charts = summary_snapshot
start_date = 2018-09-01
  end_date = 2020-10-13
    format = plain

Response

line
ctas_visits
ctas_clicks
Ym
int
int
27
27
8
6
17
17
2
2
1
1
9
2

Example 5 (json)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=dc035a43cc68fc0a97cae886dce32899&url_id=652785159f98a59eb9ae7caa9a635d6c&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13

Query parameters

    cta_id = dc035a43cc68fc0a97cae886dce32899
    url_id = 652785159f98a59eb9ae7caa9a635d6c
    charts = tl_cities
start_date = 2020-10-01
  end_date = 2020-10-13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "tl_cities": {
      "type": "doughnut",
      "series": [
        "cities"
      ],
      "types": {
        "count": "int"
      },
      "data": {
        "cities": {
          "Akko": {
            "count": 2
          },
          "Florence": {
            "count": 2
          }
        }
      },
      "table": {
        "Akko": {
          "visits": 2,
          "unique_visits": 0,
          "mobile": 0,
          "unique_mobile": 0,
          "qrcode_scans": 0
        },
        "Florence": {
          "visits": 2,
          "unique_visits": 0,
          "mobile": 0,
          "unique_mobile": 0,
          "qrcode_scans": 0
        }
      }
    }
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=dc035a43cc68fc0a97cae886dce32899&url_id=652785159f98a59eb9ae7caa9a635d6c&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13&format=xml

Query parameters

    cta_id = dc035a43cc68fc0a97cae886dce32899
    url_id = 652785159f98a59eb9ae7caa9a635d6c
    charts = tl_cities
start_date = 2020-10-01
  end_date = 2020-10-13
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <tl_cities>
      <type>doughnut</type>  
      <series>
        <i0>cities</i0>  
      </series>  
      <types>
        <count>int</count>  
      </types>  
      <data>
        <cities>
          <Akko>
            <count>2</count>  
          </Akko>  
          <Florence>
            <count>2</count>  
          </Florence>  
        </cities>  
      </data>  
      <table>
        <Akko>
          <visits>2</visits>  
          <unique_visits>0</unique_visits>  
          <mobile>0</mobile>  
          <unique_mobile>0</unique_mobile>  
          <qrcode_scans>0</qrcode_scans>  
        </Akko>  
        <Florence>
          <visits>2</visits>  
          <unique_visits>0</unique_visits>  
          <mobile>0</mobile>  
          <unique_mobile>0</unique_mobile>  
          <qrcode_scans>0</qrcode_scans>  
        </Florence>  
      </table>  
    </tl_cities>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=dc035a43cc68fc0a97cae886dce32899&url_id=652785159f98a59eb9ae7caa9a635d6c&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13&format=txt

Query parameters

    cta_id = dc035a43cc68fc0a97cae886dce32899
    url_id = 652785159f98a59eb9ae7caa9a635d6c
    charts = tl_cities
start_date = 2020-10-01
  end_date = 2020-10-13
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_cities_type=doughnut
result_tl_cities_series_0=cities
result_tl_cities_types_count=int
result_tl_cities_data_cities_Akko_count=2
result_tl_cities_data_cities_Florence_count=2
result_tl_cities_table_Akko_visits=2
result_tl_cities_table_Akko_unique_visits=0
result_tl_cities_table_Akko_mobile=0
result_tl_cities_table_Akko_unique_mobile=0
result_tl_cities_table_Akko_qrcode_scans=0
result_tl_cities_table_Florence_visits=2
result_tl_cities_table_Florence_unique_visits=0
result_tl_cities_table_Florence_mobile=0
result_tl_cities_table_Florence_unique_mobile=0
result_tl_cities_table_Florence_qrcode_scans=0

Example 8 (plain)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=dc035a43cc68fc0a97cae886dce32899&url_id=652785159f98a59eb9ae7caa9a635d6c&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13&format=plain

Query parameters

    cta_id = dc035a43cc68fc0a97cae886dce32899
    url_id = 652785159f98a59eb9ae7caa9a635d6c
    charts = tl_cities
start_date = 2020-10-01
  end_date = 2020-10-13
    format = plain

Response

doughnut
cities
int
2
2
2
0
0
0
0
2
0
0
0
0

Example 9 (json)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=9fad4bc6bd1b3c40610a6a154315e55a&url_id=10102e18593c183665c9105174ea1aa7&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13

Query parameters

    cta_id = 9fad4bc6bd1b3c40610a6a154315e55a
    url_id = 10102e18593c183665c9105174ea1aa7
    charts = tl_ips
start_date = 2020-10-01
  end_date = 2020-10-13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "tl_ips": {
      "nodata": 1
    }
  }
}

Example 10 (xml)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=9fad4bc6bd1b3c40610a6a154315e55a&url_id=10102e18593c183665c9105174ea1aa7&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13&format=xml

Query parameters

    cta_id = 9fad4bc6bd1b3c40610a6a154315e55a
    url_id = 10102e18593c183665c9105174ea1aa7
    charts = tl_ips
start_date = 2020-10-01
  end_date = 2020-10-13
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <tl_ips>
      <nodata>1</nodata>  
    </tl_ips>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=9fad4bc6bd1b3c40610a6a154315e55a&url_id=10102e18593c183665c9105174ea1aa7&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13&format=txt

Query parameters

    cta_id = 9fad4bc6bd1b3c40610a6a154315e55a
    url_id = 10102e18593c183665c9105174ea1aa7
    charts = tl_ips
start_date = 2020-10-01
  end_date = 2020-10-13
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_ips_nodata=1

Example 12 (plain)

Request

https://joturl.com/a/i1/stats/ctas/get?cta_id=9fad4bc6bd1b3c40610a6a154315e55a&url_id=10102e18593c183665c9105174ea1aa7&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13&format=plain

Query parameters

    cta_id = 9fad4bc6bd1b3c40610a6a154315e55a
    url_id = 10102e18593c183665c9105174ea1aa7
    charts = tl_ips
start_date = 2020-10-01
  end_date = 2020-10-13
    format = plain

Response

Required parameters

parameter	description
chartsARRAY	comma separated list of charts, for a detailed list of charts see i1/stats/ctas/info

Optional parameters

parameter	description
cta_idID	ID of the CTA for which to extract statistics
end_dateDATE	extract statistics up to this date (included)
map_typeSTRING	used only when charts contains `tl_map`, see i1/stats/projects/get for details
start_dateDATE	extract statistics from this date (included)
url_idID	ID of the tracking link for which to extract statistics

Return values

parameter	description
data	JSON object in the format {"chart": {[CHART INFO]}}

For each valid element passed in charts (e.g., summary_snapshot, tl_browsers), there will be a corresponding element in the output identified by chart (e.g., tl_browsers). The object {[CHART INFO]} has the following fields:

type: chart type, it can be line, map, doughnut
series: an array of the series in the output (e.g., ["ctas_visits","ctas_clicks"])
types: object that describes the output types in the format "output_field": "output_type", a special case is output_field = x which describes the type of the values on the abscissa of the chart
data: output data in the format {"serie1":{"abscissa value 1":{"output_field1":"output_value1"}, ..., "abscissa value N":{"output_fieldN":"output_valueN"}}, ..., "serieM":{"abscissa value 1":{"output_field1":"output_value1"}, ..., "abscissa value N":{"output_fieldN":"output_valueN"}}}
table: only returned when type = doughnut, it contains items with the format {"abscissa value 1":{visits:V1,unique_visits:UV1,mobile:M1,unique_mobile:UM1,qrcode_scans:Q1}, ..., "abscissa value N":{visits:VN,unique_visits:UVN,mobile:MN,unique_mobile:UMN,qrcode_scans: QN}}
locations: only returned when type = map, it contains items with the format {{"count":[visits],"country":{"name":"[country name]","code":"[ISO 3166 country code]"}, "region":{"name":"[region name]"}, "city":{"name":"[city name]","latitude":[city latitude (float)],"longitude":[city longitude (float)]}}
markers: only returned when type = map, it contains items with the format [{"location":[index in the locations object], "isUnique":[1 if unique CTA conversion, 0 otherwise], "isQrCode":[1 if CTA conversion from QR code scan, 0 otherwise], "isMobile":[1 if CTA conversion from mobile devices, 0 otherwise], "count":[number of CTA conversions], "ip":"[IPv4 address]"},...], 'CTA conversion' means an action that user made with the CTA (e.g., click on the button)
nodata: returned when no data is available (always equal to 1 if present).

For available values for output_type see i1/stats/projects/get.

/stats/ctas/info

access: [READ]

This method returns information about stats.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=3c33aa212414ff810dd5341593b28a84&url_id=85de0222d266cfef239ec83a4a90fc0e

Query parameters

cta_id = 3c33aa212414ff810dd5341593b28a84
url_id = 85de0222d266cfef239ec83a4a90fc0e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "tl_snapshot",
    "tl_map",
    "tl_countries",
    "tl_regions",
    "tl_cities",
    "tl_languages",
    "tl_referrers",
    "tl_devices",
    "tl_browsers",
    "tl_platforms",
    "tl_operating_systems",
    "tl_ips",
    "tl_bots",
    "tl_ctas_conversions",
    "tl_ctas_metrics"
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=3c33aa212414ff810dd5341593b28a84&url_id=85de0222d266cfef239ec83a4a90fc0e&format=xml

Query parameters

cta_id = 3c33aa212414ff810dd5341593b28a84
url_id = 85de0222d266cfef239ec83a4a90fc0e
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>tl_snapshot</i0>  
    <i1>tl_map</i1>  
    <i2>tl_countries</i2>  
    <i3>tl_regions</i3>  
    <i4>tl_cities</i4>  
    <i5>tl_languages</i5>  
    <i6>tl_referrers</i6>  
    <i7>tl_devices</i7>  
    <i8>tl_browsers</i8>  
    <i9>tl_platforms</i9>  
    <i10>tl_operating_systems</i10>  
    <i11>tl_ips</i11>  
    <i12>tl_bots</i12>  
    <i13>tl_ctas_conversions</i13>  
    <i14>tl_ctas_metrics</i14>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=3c33aa212414ff810dd5341593b28a84&url_id=85de0222d266cfef239ec83a4a90fc0e&format=txt

Query parameters

cta_id = 3c33aa212414ff810dd5341593b28a84
url_id = 85de0222d266cfef239ec83a4a90fc0e
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
result_13=tl_ctas_conversions
result_14=tl_ctas_metrics

Example 4 (plain)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=3c33aa212414ff810dd5341593b28a84&url_id=85de0222d266cfef239ec83a4a90fc0e&format=plain

Query parameters

cta_id = 3c33aa212414ff810dd5341593b28a84
url_id = 85de0222d266cfef239ec83a4a90fc0e
format = plain

Response

tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
tl_ctas_conversions
tl_ctas_metrics

Example 5 (json)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=0079e9243fbf4bf600c3e6907a7bd7c6

Query parameters

cta_id = 0079e9243fbf4bf600c3e6907a7bd7c6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "summary_snapshot",
    "summary_conversions",
    "summary_commissions",
    "summary_ctas",
    "summary_cta_forms",
    "summary_cta_social_connects",
    "summary_clicks_to_destination",
    "tl_ctas_conversions",
    "tl_ctas_metrics"
  ]
}

Example 6 (xml)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=0079e9243fbf4bf600c3e6907a7bd7c6&format=xml

Query parameters

cta_id = 0079e9243fbf4bf600c3e6907a7bd7c6
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>summary_snapshot</i0>  
    <i1>summary_conversions</i1>  
    <i2>summary_commissions</i2>  
    <i3>summary_ctas</i3>  
    <i4>summary_cta_forms</i4>  
    <i5>summary_cta_social_connects</i5>  
    <i6>summary_clicks_to_destination</i6>  
    <i7>tl_ctas_conversions</i7>  
    <i8>tl_ctas_metrics</i8>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=0079e9243fbf4bf600c3e6907a7bd7c6&format=txt

Query parameters

cta_id = 0079e9243fbf4bf600c3e6907a7bd7c6
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
result_1=summary_conversions
result_2=summary_commissions
result_3=summary_ctas
result_4=summary_cta_forms
result_5=summary_cta_social_connects
result_6=summary_clicks_to_destination
result_7=tl_ctas_conversions
result_8=tl_ctas_metrics

Example 8 (plain)

Request

https://joturl.com/a/i1/stats/ctas/info?cta_id=0079e9243fbf4bf600c3e6907a7bd7c6&format=plain

Query parameters

cta_id = 0079e9243fbf4bf600c3e6907a7bd7c6
format = plain

Response

summary_snapshot
summary_conversions
summary_commissions
summary_ctas
summary_cta_forms
summary_cta_social_connects
summary_clicks_to_destination
tl_ctas_conversions
tl_ctas_metrics

Example 9 (json)

Request

https://joturl.com/a/i1/stats/ctas/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "summary_snapshot"
  ]
}

Example 10 (xml)

Request

https://joturl.com/a/i1/stats/ctas/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>summary_snapshot</i0>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/stats/ctas/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot

Example 12 (plain)

Request

https://joturl.com/a/i1/stats/ctas/info?format=plain

Query parameters

format = plain

Response

summary_snapshot

Optional parameters

parameter	description
cta_idID	ID of the CTA for which to extract statistics
url_idID	ID of the tracking link for which to extract statistics

Return values

parameter	description
data	array of available charts for the given `cta_id` and `url_id`

Available charts and descriptions

chart	type	description	A	CTA	T
tl_snapshot	line	overview of the tracking link conversions, unique conversions, conversions from mobile devices, conversions from unique mobile devices, conversions from QR code scans, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_map	map	overview on the world map of the tracking link conversions, unique conversions, conversions from mobile devices, conversions from unique mobile devices, conversions from QR code scans, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_countries	doughnut	top 10 countries from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_regions	doughnut	top 10 regions from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_cities	doughnut	top 10 cities from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_languages	doughnut	first 10 languages of users who visited the CTA, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_referrers	doughnut	top 10 referrers, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_devices	doughnut	first 10 devices of users who visited the CTA, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_browsers	doughnut	first 10 browsers of users who visited the CTA, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_platforms	doughnut	first 10 platforms of users who visited the CTA, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_operating_systems	doughnut	first 10 operating systems of users who visited the CTA, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_ips	doughnut	top 10 IPs from which visits to the CTA come, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_bots	line	overview of the CTA visits from bots, if `url_id` is not passed, it returns data relating to the CTA and all associated tracking links	-	`CTA`	`T`
tl_ctas_conversions	line	when `cta_id` and `url_id` are passed it is an overview of the CTA conversions associated to the specified tracking link , when only `cta_id` is passed it is an overview of CTA conversions (i.e., actions made on the CTA)	-	`CTA`	`T`
tl_ctas_metrics	line	when `cta_id` and `url_id` are passed it returns the CTA metrics related to the tracking link, when only `cta_id` is passed it returns the metrics of the CTA and all associated tracking links	-	`CTA`	`T`
summary_snapshot	line	account level overview of CTA conversions, unique conversions, conversions from mobile devices, conversions from unique mobile devices, conversions from QR code scans	`A`	-	-

Where:

A: account level chart (requires neither cta_id nor url_id)
CTA: chart for CTAs (requires only cta_id)
T: chart available for tracking links (requires cta_id and url_id)
the presence in the table of both CTA and T means that the chart can be used both for a CTA and for a tracking link; when url_id is not passed, the data returned is for all tracking links associated with the CTA identified by cta_id.

/stats/projects

/stats/projects/get

access: [READ]

This method returns the charts requested in the charts parameter.

Example 1 (json)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11

Query parameters

    charts = summary_snapshot
start_date = 2020-10-05
  end_date = 2020-10-11

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "summary_snapshot": {
      "type": "line",
      "series": [
        "visits",
        "unique_visits",
        "mobile",
        "unique_mobile",
        "qrcode_scans"
      ],
      "types": {
        "x": "Ymd",
        "count": "int"
      },
      "data": {
        "visits": {
          "2020-10-05": {
            "count": 2
          },
          ...: {
            "count": 3
          },
          "2020-10-11": {
            "count": 19
          }
        },
        "unique_visits": {
          "2020-10-05": {
            "count": 2
          },
          ...: {
            "count": 3
          },
          "2020-10-11": {
            "count": 5
          }
        },
        "mobile": {
          "2020-10-05": {
            "count": 0
          },
          ...: {
            "count": 2
          },
          "2020-10-11": {
            "count": 0
          }
        },
        "unique_mobile": {
          "2020-10-05": {
            "count": 0
          },
          ...: {
            "count": 2
          },
          "2020-10-11": {
            "count": 0
          }
        },
        "qrcode_scans": {
          "2020-10-05": {
            "count": 0
          },
          ...: {
            "count": 0
          },
          "2020-10-11": {
            "count": 0
          }
        }
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11&format=xml

Query parameters

    charts = summary_snapshot
start_date = 2020-10-05
  end_date = 2020-10-11
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <summary_snapshot>
      <type>line</type>  
      <series>
        <i0>visits</i0>  
        <i1>unique_visits</i1>  
        <i2>mobile</i2>  
        <i3>unique_mobile</i3>  
        <i4>qrcode_scans</i4>  
      </series>  
      <types>
        <x>Ymd</x>  
        <count>int</count>  
      </types>  
      <data>
        <visits>
          <2020-10-05>
            <count>2</count>  
          </2020-10-05>  
          <...>
            <count>3</count>  
          </...>  
          <2020-10-11>
            <count>19</count>  
          </2020-10-11>  
        </visits>  
        <unique_visits>
          <2020-10-05>
            <count>2</count>  
          </2020-10-05>  
          <...>
            <count>3</count>  
          </...>  
          <2020-10-11>
            <count>5</count>  
          </2020-10-11>  
        </unique_visits>  
        <mobile>
          <2020-10-05>
            <count>0</count>  
          </2020-10-05>  
          <...>
            <count>2</count>  
          </...>  
          <2020-10-11>
            <count>0</count>  
          </2020-10-11>  
        </mobile>  
        <unique_mobile>
          <2020-10-05>
            <count>0</count>  
          </2020-10-05>  
          <...>
            <count>2</count>  
          </...>  
          <2020-10-11>
            <count>0</count>  
          </2020-10-11>  
        </unique_mobile>  
        <qrcode_scans>
          <2020-10-05>
            <count>0</count>  
          </2020-10-05>  
          <...>
            <count>0</count>  
          </...>  
          <2020-10-11>
            <count>0</count>  
          </2020-10-11>  
        </qrcode_scans>  
      </data>  
    </summary_snapshot>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11&format=txt

Query parameters

    charts = summary_snapshot
start_date = 2020-10-05
  end_date = 2020-10-11
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_summary_snapshot_type=line
result_summary_snapshot_series_0=visits
result_summary_snapshot_series_1=unique_visits
result_summary_snapshot_series_2=mobile
result_summary_snapshot_series_3=unique_mobile
result_summary_snapshot_series_4=qrcode_scans
result_summary_snapshot_types_x=Ymd
result_summary_snapshot_types_count=int
result_summary_snapshot_data_visits_2020-10-05_count=2
result_summary_snapshot_data_visits_..._count=3
result_summary_snapshot_data_visits_2020-10-11_count=19
result_summary_snapshot_data_unique_visits_2020-10-05_count=2
result_summary_snapshot_data_unique_visits_..._count=3
result_summary_snapshot_data_unique_visits_2020-10-11_count=5
result_summary_snapshot_data_mobile_2020-10-05_count=0
result_summary_snapshot_data_mobile_..._count=2
result_summary_snapshot_data_mobile_2020-10-11_count=0
result_summary_snapshot_data_unique_mobile_2020-10-05_count=0
result_summary_snapshot_data_unique_mobile_..._count=2
result_summary_snapshot_data_unique_mobile_2020-10-11_count=0
result_summary_snapshot_data_qrcode_scans_2020-10-05_count=0
result_summary_snapshot_data_qrcode_scans_..._count=0
result_summary_snapshot_data_qrcode_scans_2020-10-11_count=0

Example 4 (plain)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11&format=plain

Query parameters

    charts = summary_snapshot
start_date = 2020-10-05
  end_date = 2020-10-11
    format = plain

Response

line
visits
unique_visits
mobile
unique_mobile
qrcode_scans
Ymd
int
2
3
19
2
3
5
0
2
0
0
2
0
0
0
0

Example 5 (json)

Request

https://joturl.com/a/i1/stats/projects/get?project_id=131a2a79425c68d13de2eed4505ab3b5&url_id=0df3371717deb115ade76dbc4cc01b23&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12

Query parameters

project_id = 131a2a79425c68d13de2eed4505ab3b5
    url_id = 0df3371717deb115ade76dbc4cc01b23
    charts = tl_browsers
start_date = 2017-10-12
  end_date = 2020-10-12

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "tl_browsers": {
      "type": "doughnut",
      "series": [
        "stats_browsers"
      ],
      "types": {
        "count": "int"
      },
      "data": {
        "stats_browsers": {
          "Internet Explorer": {
            "count": 15
          },
          "Mozilla": {
            "count": 14
          },
          ...: {
            "count": 13
          },
          "Internet Explorer Mobile": {
            "count": 4
          }
        }
      },
      "table": {
        "Internet Explorer": {
          "visits": 15,
          "unique_visits": 15,
          "mobile": 0,
          "unique_mobile": 0,
          "qrcode_scans": 0
        },
        "Mozilla": {
          "visits": 14,
          "unique_visits": 14,
          "mobile": 0,
          "unique_mobile": 0,
          "qrcode_scans": 0
        },
        ...: {
          "visits": 13,
          "unique_visits": 13,
          "mobile": 0,
          "unique_mobile": 0,
          "qrcode_scans": 0
        },
        "Internet Explorer Mobile": {
          "visits": 4,
          "unique_visits": 3,
          "mobile": 2,
          "unique_mobile": 1,
          "qrcode_scans": 1
        }
      }
    }
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/stats/projects/get?project_id=131a2a79425c68d13de2eed4505ab3b5&url_id=0df3371717deb115ade76dbc4cc01b23&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12&format=xml

Query parameters

project_id = 131a2a79425c68d13de2eed4505ab3b5
    url_id = 0df3371717deb115ade76dbc4cc01b23
    charts = tl_browsers
start_date = 2017-10-12
  end_date = 2020-10-12
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <tl_browsers>
      <type>doughnut</type>  
      <series>
        <i0>stats_browsers</i0>  
      </series>  
      <types>
        <count>int</count>  
      </types>  
      <data>
        <stats_browsers>
          <Internet Explorer>
            <count>15</count>  
          </Internet Explorer>  
          <Mozilla>
            <count>14</count>  
          </Mozilla>  
          <...>
            <count>13</count>  
          </...>  
          <Internet Explorer Mobile>
            <count>4</count>  
          </Internet Explorer Mobile>  
        </stats_browsers>  
      </data>  
      <table>
        <Internet Explorer>
          <visits>15</visits>  
          <unique_visits>15</unique_visits>  
          <mobile>0</mobile>  
          <unique_mobile>0</unique_mobile>  
          <qrcode_scans>0</qrcode_scans>  
        </Internet Explorer>  
        <Mozilla>
          <visits>14</visits>  
          <unique_visits>14</unique_visits>  
          <mobile>0</mobile>  
          <unique_mobile>0</unique_mobile>  
          <qrcode_scans>0</qrcode_scans>  
        </Mozilla>  
        <...>
          <visits>13</visits>  
          <unique_visits>13</unique_visits>  
          <mobile>0</mobile>  
          <unique_mobile>0</unique_mobile>  
          <qrcode_scans>0</qrcode_scans>  
        </...>  
        <Internet Explorer Mobile>
          <visits>4</visits>  
          <unique_visits>3</unique_visits>  
          <mobile>2</mobile>  
          <unique_mobile>1</unique_mobile>  
          <qrcode_scans>1</qrcode_scans>  
        </Internet Explorer Mobile>  
      </table>  
    </tl_browsers>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/stats/projects/get?project_id=131a2a79425c68d13de2eed4505ab3b5&url_id=0df3371717deb115ade76dbc4cc01b23&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12&format=txt

Query parameters

project_id = 131a2a79425c68d13de2eed4505ab3b5
    url_id = 0df3371717deb115ade76dbc4cc01b23
    charts = tl_browsers
start_date = 2017-10-12
  end_date = 2020-10-12
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_browsers_type=doughnut
result_tl_browsers_series_0=stats_browsers
result_tl_browsers_types_count=int
result_tl_browsers_data_stats_browsers_Internet Explorer_count=15
result_tl_browsers_data_stats_browsers_Mozilla_count=14
result_tl_browsers_data_stats_browsers_..._count=13
result_tl_browsers_data_stats_browsers_Internet Explorer Mobile_count=4
result_tl_browsers_table_Internet Explorer_visits=15
result_tl_browsers_table_Internet Explorer_unique_visits=15
result_tl_browsers_table_Internet Explorer_mobile=0
result_tl_browsers_table_Internet Explorer_unique_mobile=0
result_tl_browsers_table_Internet Explorer_qrcode_scans=0
result_tl_browsers_table_Mozilla_visits=14
result_tl_browsers_table_Mozilla_unique_visits=14
result_tl_browsers_table_Mozilla_mobile=0
result_tl_browsers_table_Mozilla_unique_mobile=0
result_tl_browsers_table_Mozilla_qrcode_scans=0
result_tl_browsers_table_..._visits=13
result_tl_browsers_table_..._unique_visits=13
result_tl_browsers_table_..._mobile=0
result_tl_browsers_table_..._unique_mobile=0
result_tl_browsers_table_..._qrcode_scans=0
result_tl_browsers_table_Internet Explorer Mobile_visits=4
result_tl_browsers_table_Internet Explorer Mobile_unique_visits=3
result_tl_browsers_table_Internet Explorer Mobile_mobile=2
result_tl_browsers_table_Internet Explorer Mobile_unique_mobile=1
result_tl_browsers_table_Internet Explorer Mobile_qrcode_scans=1

Example 8 (plain)

Request

https://joturl.com/a/i1/stats/projects/get?project_id=131a2a79425c68d13de2eed4505ab3b5&url_id=0df3371717deb115ade76dbc4cc01b23&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12&format=plain

Query parameters

project_id = 131a2a79425c68d13de2eed4505ab3b5
    url_id = 0df3371717deb115ade76dbc4cc01b23
    charts = tl_browsers
start_date = 2017-10-12
  end_date = 2020-10-12
    format = plain

Response

doughnut
stats_browsers
int
15
14
13
4
15
15
0
0
0
14
14
0
0
0
13
13
0
0
0
4
3
2
1
1

Example 9 (json)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11

Query parameters

    charts = summary_clicks_to_destination
start_date = 2017-10-12
  end_date = 2020-10-11

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": []
}

Example 10 (xml)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11&format=xml

Query parameters

    charts = summary_clicks_to_destination
start_date = 2017-10-12
  end_date = 2020-10-11
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>

  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11&format=txt

Query parameters

    charts = summary_clicks_to_destination
start_date = 2017-10-12
  end_date = 2020-10-11
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result=

Example 12 (plain)

Request

https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11&format=plain

Query parameters

    charts = summary_clicks_to_destination
start_date = 2017-10-12
  end_date = 2020-10-11
    format = plain

Response

Example 13 (json)

Request

https://joturl.com/a/i1/stats/projects/get?cta_id=d8aa970878b92a83e4245cdf9a858aca&url_id=4d68ffddf820c1bd3b5b595d0cf147de&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13

Query parameters

    cta_id = d8aa970878b92a83e4245cdf9a858aca
    url_id = 4d68ffddf820c1bd3b5b595d0cf147de
    charts = tl_referrers
start_date = 2020-10-01
  end_date = 2020-10-13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "tl_referrers": {
      "nodata": 1
    }
  }
}

Example 14 (xml)

Request

https://joturl.com/a/i1/stats/projects/get?cta_id=d8aa970878b92a83e4245cdf9a858aca&url_id=4d68ffddf820c1bd3b5b595d0cf147de&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13&format=xml

Query parameters

    cta_id = d8aa970878b92a83e4245cdf9a858aca
    url_id = 4d68ffddf820c1bd3b5b595d0cf147de
    charts = tl_referrers
start_date = 2020-10-01
  end_date = 2020-10-13
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <tl_referrers>
      <nodata>1</nodata>  
    </tl_referrers>  
  </result>  
</response>

Example 15 (txt)

Request

https://joturl.com/a/i1/stats/projects/get?cta_id=d8aa970878b92a83e4245cdf9a858aca&url_id=4d68ffddf820c1bd3b5b595d0cf147de&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13&format=txt

Query parameters

    cta_id = d8aa970878b92a83e4245cdf9a858aca
    url_id = 4d68ffddf820c1bd3b5b595d0cf147de
    charts = tl_referrers
start_date = 2020-10-01
  end_date = 2020-10-13
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_referrers_nodata=1

Example 16 (plain)

Request

https://joturl.com/a/i1/stats/projects/get?cta_id=d8aa970878b92a83e4245cdf9a858aca&url_id=4d68ffddf820c1bd3b5b595d0cf147de&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13&format=plain

Query parameters

    cta_id = d8aa970878b92a83e4245cdf9a858aca
    url_id = 4d68ffddf820c1bd3b5b595d0cf147de
    charts = tl_referrers
start_date = 2020-10-01
  end_date = 2020-10-13
    format = plain

Response

Required parameters

parameter	description
chartsARRAY	comma separated list of charts, for a detailed list of charts see i1/stats/projects/info

Optional parameters

parameter	description
end_dateDATE	extract statistics up to this date (included)
map_typeSTRING	used only when charts contains `tl_map`, see before for details
mu_idxINTEGER	only valid for tracking links with the InstaUrl option enabled, it allows you to specify the extraction of a specific URL: this value is the index of the corresponding URL in the option (in the same order in which they appear)
project_idID	ID of the project for which to extract statistics
start_dateDATE	extract statistics from this date (included)
url_idID	ID of the tracking link for which to extract statistics

Return values

parameter	description
data	JSON object in the format {"chart": {[CHART INFO]}}

type: chart type, it can be cloaking, line, doughnut, map, conversions
series: an array of the series in the output (e.g., ["visits","unique_visits","mobile","unique_mobile","qrcode_scans"])
types: object that describes the output types in the format "output_field": "output_type", a special case is output_field = x which describes the type of the values on the abscissa of the chart
data: output data in the format {"serie1":{"abscissa value 1":{"output_field1":"output_value1"}, ..., "abscissa value N":{"output_fieldN":"output_valueN"}}, ..., "serieM":{"abscissa value 1":{"output_field1":"output_value1"}, ..., "abscissa value N":{"output_fieldN":"output_valueN"}}}
table: only returned when type = doughnut, type = conversions or type = cloaking, when type = doughnut it contains items with the format {"abscissa value 1":{visits:V1,unique_visits:UV1,mobile:M1,unique_mobile:UM1,qrcode_scans:Q1}, ..., "abscissa value N":{visits:VN,unique_visits:UVN,mobile:MN,unique_mobile:UMN,qrcode_scans: QN}}, when type = conversions it contains items with the format {"abscissa value 1":{clicks:C1,value:V1,visits:I1,rate:R1}, ..., "abscissa value N":{clicks:CN,value:VN,visits:IN,rate:RN}} (clicks = conversions, value = conversion value, visits = number of visits, rate = conversion rate), when type = cloaking the charts dedicated to countries contain items with the format {"count":[visits],"country":{"name":"[country name]","code":"[ISO 3166 country code]"},
locations: only returned when type = map, it contains items with the format {{"count":[visits],"country":{"name":"[country name]","code":"[ISO 3166 country code]"}, "region":{"name":"[region name]"}, "city":{"name":"[city name]","latitude":[city latitude (float)],"longitude":[city longitude (float)]}}
markers: only returned when type = map, it contains items with the format [{"location":[index in the locations object], "isUnique":[1 if unique visit, 0 otherwise], "isQrCode":[1 if QR code scan, 0 otherwise], "isMobile":[1 if visits from mobile device, 0 otherwise], "count":[number of visits], "ip":"[IPv4 address]"},...]
nodata: returned when no data is available (always equal to 1 if present).

When type = cloaking the object {[CHART INFO]} has the following top fields:

blocked_visits: an object {[CHART INFO]} of blocked visits as above described (type = line),
not_blocked_visits: an object {[CHART INFO]} of not blocked visits as above described (type = line),
blocked_countries: an object {[CHART INFO]} of blocked countries as above described (type = table),
not_blocked_countries: an object {[CHART INFO]} of not blocked countries as above described (type = table).

Available values for output_type:

Ymd: date in the format year-month-day (2020-12-31)
Ym: date in the format year-month (2020-12)
cur: currency (float value)
number: float value
int: integer value

/stats/projects/info

access: [READ]

This method returns available charts for the given inputs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=1df69fcce668a1aaf970961d1ed12d97&url_id=2264da21fdcb1dc9e9027db29e8ff276

Query parameters

project_id = 1df69fcce668a1aaf970961d1ed12d97
    url_id = 2264da21fdcb1dc9e9027db29e8ff276

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "tl_snapshot",
    "tl_map",
    "tl_countries",
    "tl_regions",
    "tl_cities",
    "tl_languages",
    "tl_referrers",
    "tl_devices",
    "tl_browsers",
    "tl_platforms",
    "tl_operating_systems",
    "tl_ips",
    "tl_bots"
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=1df69fcce668a1aaf970961d1ed12d97&url_id=2264da21fdcb1dc9e9027db29e8ff276&format=xml

Query parameters

project_id = 1df69fcce668a1aaf970961d1ed12d97
    url_id = 2264da21fdcb1dc9e9027db29e8ff276
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>tl_snapshot</i0>  
    <i1>tl_map</i1>  
    <i2>tl_countries</i2>  
    <i3>tl_regions</i3>  
    <i4>tl_cities</i4>  
    <i5>tl_languages</i5>  
    <i6>tl_referrers</i6>  
    <i7>tl_devices</i7>  
    <i8>tl_browsers</i8>  
    <i9>tl_platforms</i9>  
    <i10>tl_operating_systems</i10>  
    <i11>tl_ips</i11>  
    <i12>tl_bots</i12>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=1df69fcce668a1aaf970961d1ed12d97&url_id=2264da21fdcb1dc9e9027db29e8ff276&format=txt

Query parameters

project_id = 1df69fcce668a1aaf970961d1ed12d97
    url_id = 2264da21fdcb1dc9e9027db29e8ff276
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots

Example 4 (plain)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=1df69fcce668a1aaf970961d1ed12d97&url_id=2264da21fdcb1dc9e9027db29e8ff276&format=plain

Query parameters

project_id = 1df69fcce668a1aaf970961d1ed12d97
    url_id = 2264da21fdcb1dc9e9027db29e8ff276
    format = plain

Response

tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots

Example 5 (json)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=72ddddd0b4a2515f7911662d62dcefaa

Query parameters

project_id = 72ddddd0b4a2515f7911662d62dcefaa

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "summary_snapshot",
    "summary_conversions",
    "summary_commissions",
    "summary_ctas",
    "summary_cta_forms",
    "summary_cta_social_connects",
    "summary_clicks_to_destination"
  ]
}

Example 6 (xml)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=72ddddd0b4a2515f7911662d62dcefaa&format=xml

Query parameters

project_id = 72ddddd0b4a2515f7911662d62dcefaa
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>summary_snapshot</i0>  
    <i1>summary_conversions</i1>  
    <i2>summary_commissions</i2>  
    <i3>summary_ctas</i3>  
    <i4>summary_cta_forms</i4>  
    <i5>summary_cta_social_connects</i5>  
    <i6>summary_clicks_to_destination</i6>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=72ddddd0b4a2515f7911662d62dcefaa&format=txt

Query parameters

project_id = 72ddddd0b4a2515f7911662d62dcefaa
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
result_1=summary_conversions
result_2=summary_commissions
result_3=summary_ctas
result_4=summary_cta_forms
result_5=summary_cta_social_connects
result_6=summary_clicks_to_destination

Example 8 (plain)

Request

https://joturl.com/a/i1/stats/projects/info?project_id=72ddddd0b4a2515f7911662d62dcefaa&format=plain

Query parameters

project_id = 72ddddd0b4a2515f7911662d62dcefaa
    format = plain

Response

summary_snapshot
summary_conversions
summary_commissions
summary_ctas
summary_cta_forms
summary_cta_social_connects
summary_clicks_to_destination

Example 9 (json)

Request

https://joturl.com/a/i1/stats/projects/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "summary_snapshot",
    "summary_conversions",
    "summary_commissions",
    "summary_ctas",
    "summary_cta_forms",
    "summary_cta_social_connects",
    "summary_clicks_to_destination",
    "summary_external_apis",
    "summary_short_domain_requests"
  ]
}

Example 10 (xml)

Request

https://joturl.com/a/i1/stats/projects/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>summary_snapshot</i0>  
    <i1>summary_conversions</i1>  
    <i2>summary_commissions</i2>  
    <i3>summary_ctas</i3>  
    <i4>summary_cta_forms</i4>  
    <i5>summary_cta_social_connects</i5>  
    <i6>summary_clicks_to_destination</i6>  
    <i7>summary_external_apis</i7>  
    <i8>summary_short_domain_requests</i8>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/stats/projects/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
result_1=summary_conversions
result_2=summary_commissions
result_3=summary_ctas
result_4=summary_cta_forms
result_5=summary_cta_social_connects
result_6=summary_clicks_to_destination
result_7=summary_external_apis
result_8=summary_short_domain_requests

Example 12 (plain)

Request

https://joturl.com/a/i1/stats/projects/info?format=plain

Query parameters

format = plain

Response

summary_snapshot
summary_conversions
summary_commissions
summary_ctas
summary_cta_forms
summary_cta_social_connects
summary_clicks_to_destination
summary_external_apis
summary_short_domain_requests

Optional parameters

parameter	description
project_idID	ID of the project for which to extract statistics
url_idID	ID of the tracking link for which to extract statistics

Return values

parameter	description
data	array of available charts for the given `project_id` and `url_id`

Available charts and descriptions

chart	type	description	A	P	T	C	I	K
cloaking_tl_snapshot	cloaking	overview of the main cloaking information (blocked/allowed visits by countries, bots, device type)	-	-	`T`	-	-	`K`
iu_tl_bots	line	overview of the tracking link visits from bots	-	-	`T`	-	`I`	-
iu_tl_browsers	doughnut	first 10 browsers of users who visited the tracking link	-	-	`T`	-	`I`	-
iu_tl_cities	doughnut	top 10 cities from which visits come	-	-	`T`	-	`I`	-
iu_tl_countries	doughnut	top 10 countries from which visits come	-	-	`T`	-	`I`	-
iu_tl_devices	doughnut	first 10 devices of users who visited the tracking link	-	-	`T`	-	`I`	-
iu_tl_ips	doughnut	top 10 IPs from which visits come	-	-	`T`	-	`I`	-
iu_tl_languages	doughnut	first 10 languages of users who visited the tracking link	-	-	`T`	-	`I`	-
iu_tl_map	map	overview on the world map of the tracking link visits, unique visits, mobile devices, unique visits from mobiles, QR code scans	-	-	`T`	-	`I`	-
iu_tl_operating_systems	doughnut	first 10 operating systems of users who visited the tracking link	-	-	`T`	-	`I`	-
iu_tl_platforms	doughnut	first 10 platforms of users who visited the tracking link	-	-	`T`	-	`I`	-
iu_tl_referrers	doughnut	top 10 referrers	-	-	`T`	-	`I`	-
iu_tl_regions	doughnut	top 10 regions from which visits come	-	-	`T`	-	`I`	-
iu_tl_snapshot	line	overview of the tracking link visits, unique visits, mobile devices, unique visits from mobiles, QR code scans	-	-	`T`	-	`I`	-
summary_clicks_to_destination	line	overview of the project/account clicks to destination (CTA)	`A`	`P`	-	-	-	-
summary_commissions	line	overview of the project/account commissions	`A`	`P`	-	-	-	-
summary_conversions	line	overview of the project/account conversions	`A`	`P`	-	-	-	-
summary_cta_forms	line	overview of the project/account collected data by form CTAs	`A`	`P`	-	-	-	-
summary_cta_social_connects	line	overview of the project/account collected data by Optin/Optin XL CTAs	`A`	`P`	-	-	-	-
summary_ctas	line	overview of the project/account shown CTAs	`A`	`P`	-	-	-	-
summary_external_apis	line	external API calls	`A`	-	-	-	-	-
summary_short_domain_requests	line	requests on custom domains without alias	`A`	-	-	-	-	-
summary_snapshot	line	overview of the project/account visits, unique visits, mobile devices, unique visits from mobiles, QR code scans	`A`	`P`	-	-	-	-
tl_associated_conversions	conversions	tracking link conversion overview (independent of passed dates)	-	-	-	`C`	-	-
tl_bots	line	overview of the tracking link visits from bots	-	-	`T`	-	-	-
tl_browsers	doughnut	first 10 browsers of users who visited the tracking link	-	-	`T`	-	-	-
tl_cities	doughnut	top 10 cities from which visits come	-	-	`T`	-	-	-
tl_countries	doughnut	top 10 countries from which visits come	-	-	`T`	-	-	-
tl_devices	doughnut	first 10 devices of users who visited the tracking link	-	-	`T`	-	-	-
tl_ips	doughnut	top 10 IPs from which visits come	-	-	`T`	-	-	-
tl_languages	doughnut	first 10 languages of users who visited the tracking link	-	-	`T`	-	-	-
tl_map	map	overview on the world map of the tracking link visits, unique visits, mobile devices, unique visits from mobiles, QR code scans	-	-	`T`	-	-	-
tl_operating_systems	doughnut	first 10 operating systems of users who visited the tracking link	-	-	`T`	-	-	-
tl_platforms	doughnut	first 10 platforms of users who visited the tracking link	-	-	`T`	-	-	-
tl_referrers	doughnut	top 10 referrers	-	-	`T`	-	-	-
tl_regions	doughnut	top 10 regions from which visits come	-	-	`T`	-	-	-
tl_snapshot	line	overview of the tracking link visits, unique visits, mobile devices, unique visits from mobiles, QR code scans	-	-	`T`	-	-	-
tl_splittest_conversions	conversions	tracking link spit test conversion overview (independent of passed dates)	-	-	-	`C`	-	-

Where:

A: account level chart (requires neither project_id nor url_id)
P: chart available only for projects (requires project_id)
T: chart available only for tracking links with or without associated conversions (requires project_id and url_id)
C: chart available only for tracking links with associated conversions (requires project_id and url_id)
I: chart available only for tracking links with the JotBio (InstaURL) option enabled (requires project_id and url_id)
K: chart available only for tracking links with the cloaking option enabled (requires project_id and url_id)
the presence in the table of both A and P means that the chart can be used both for the whole account and for a project; when project_id is not passed, the data returned is for the entire account.

/subusers

/subusers/accounts

/subusers/accounts/count

access: [READ]

This method returns the number of accounts associated with the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/accounts/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/accounts/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/accounts/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/accounts/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters associated accounts to be extracted by searching them

Return values

parameter	description
count	total number of associated accounts (filtered by parameter search)

/subusers/accounts/list

access: [READ]

This method returns a list of accounts associated with the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/accounts/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "id": "61febf9b83c5ea48b2ad37ac21c50112",
        "current": 1,
        "full_name": "Jon Smith",
        "email": "jon.smith.794@example.com",
        "short_name": "JS",
        "is_readonly": 0,
        "is_subuser": 0,
        "parent_full_name": "",
        "parent_short_name": "",
        "has_access_to_dashboard": 1,
        "creation": "2026-07-06 14:00:32",
        "domains": []
      },
      {
        "id": "3402f99c071597ae7f98d2d763c86349",
        "current": 0,
        "full_name": "Jon Smith (subuser)",
        "email": "jon.smith.794@example.com",
        "short_name": "JS",
        "is_readonly": 0,
        "is_subuser": 1,
        "parent_full_name": "Maria Garcia",
        "parent_short_name": "MG",
        "has_access_to_dashboard": 0,
        "creation": "2027-12-16 14:00:32",
        "domains": [
          "my.custom.domain"
        ]
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/accounts/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <id>61febf9b83c5ea48b2ad37ac21c50112</id>  
        <current>1</current>  
        <full_name>Jon Smith</full_name>  
        <email>jon.smith.794@example.com</email>  
        <short_name>JS</short_name>  
        <is_readonly>0</is_readonly>  
        <is_subuser>0</is_subuser>  
        <parent_full_name></parent_full_name>  
        <parent_short_name></parent_short_name>  
        <has_access_to_dashboard>1</has_access_to_dashboard>  
        <creation>2026-07-06 14:00:32</creation>  
        <domains>

        </domains>  
      </i0>  
      <i1>
        <id>3402f99c071597ae7f98d2d763c86349</id>  
        <current>0</current>  
        <full_name>Jon Smith (subuser)</full_name>  
        <email>jon.smith.794@example.com</email>  
        <short_name>JS</short_name>  
        <is_readonly>0</is_readonly>  
        <is_subuser>1</is_subuser>  
        <parent_full_name>Maria Garcia</parent_full_name>  
        <parent_short_name>MG</parent_short_name>  
        <has_access_to_dashboard>0</has_access_to_dashboard>  
        <creation>2027-12-16 14:00:32</creation>  
        <domains>
          <i0>my.custom.domain</i0>  
        </domains>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/accounts/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=61febf9b83c5ea48b2ad37ac21c50112
result_data_0_current=1
result_data_0_full_name=Jon Smith
result_data_0_email=jon.smith.794@example.com
result_data_0_short_name=JS
result_data_0_is_readonly=0
result_data_0_is_subuser=0
result_data_0_parent_full_name=
result_data_0_parent_short_name=
result_data_0_has_access_to_dashboard=1
result_data_0_creation=2026-07-06 14:00:32
result_data_0_domains=
result_data_1_id=3402f99c071597ae7f98d2d763c86349
result_data_1_current=0
result_data_1_full_name=Jon Smith (subuser)
result_data_1_email=jon.smith.794@example.com
result_data_1_short_name=JS
result_data_1_is_readonly=0
result_data_1_is_subuser=1
result_data_1_parent_full_name=Maria Garcia
result_data_1_parent_short_name=MG
result_data_1_has_access_to_dashboard=0
result_data_1_creation=2027-12-16 14:00:32
result_data_1_domains_0=my.custom.domain

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/accounts/list?format=plain

Query parameters

format = plain

Response

2
61febf9b83c5ea48b2ad37ac21c50112
1
Jon Smith
jon.smith.794@example.com
JS
0
0


1
2026-07-06 14:00:32

3402f99c071597ae7f98d2d763c86349
0
Jon Smith (subuser)
jon.smith.794@example.com
JS
0
1
Maria Garcia
MG
0
2027-12-16 14:00:32
my.custom.domain

Optional parameters

parameter	description
searchSTRING	filters associated accounts to be extracted by searching them

Return values

parameter	description
count	total number of associated accounts (filtered by parameter search)
data	array containing information on the associated accounts

Available fields in the data array:

id: ID to be used with endpoint i1/subusers/accounts/swap
current: 1 if the associated account is the one currently logged in, 0 otherwise
full_name: full name of the associated account
email: email of the associated account
short_name: short name of the associated account
is_readonly: 1 if the associated account is read-only, 0 otherwise
is_subuser: 1 if the associated account is a team member (i.e., the subuser of a parent user), 0 otherwise
parent_full_name: if is_subuser = 1, it is the full name of the parent user
parent_short_name: if is_subuser = 1, it is the short name of the parent user
has_access_to_dashboard: 1 if the associated account can access the dashboard, 0 otherwise
creation: the date/time (UTC) at which the account was created
domains: first 10 owned domains the account has access to

NOTE: a user can have a maximum of 50 accounts with the same email address.

/subusers/accounts/swap

access: [READ]

This method allows the logged in user to access another account to which he/she has access.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/accounts/swap?id=7840f70b600846ef64a85e11dc4f16d0

Query parameters

id = 7840f70b600846ef64a85e11dc4f16d0

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "logged": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/accounts/swap?id=7840f70b600846ef64a85e11dc4f16d0&format=xml

Query parameters

    id = 7840f70b600846ef64a85e11dc4f16d0
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <logged>1</logged>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/accounts/swap?id=7840f70b600846ef64a85e11dc4f16d0&format=txt

Query parameters

    id = 7840f70b600846ef64a85e11dc4f16d0
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_logged=1

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/accounts/swap?id=7840f70b600846ef64a85e11dc4f16d0&format=plain

Query parameters

    id = 7840f70b600846ef64a85e11dc4f16d0
format = plain

Response

Required parameters

parameter	description
idSTRING	ID of the account to swap to, this ID can be obtained by calling i1/subusers/accounts/list

Return values

parameter	description
logged	1 on success, an invalid parameter error otherwise

/subusers/add

access: [WRITE]

This method adds a new team member.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member

Query parameters

    email = email.of@the.team.member
full_name = full name of the team member

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "email": "email.of@the.team.member",
    "full_name": "full name of the team member",
    "added": "1 on success, 0 otherwise",
    "id": "afa88b03b9a63939e31a79e927c12bf9",
    "level": 5,
    "gender": "m",
    "role": "",
    "group": "",
    "creation": "2026-05-26 14:00:32",
    "is_readonly": 0,
    "is_confirmed": 0,
    "permission_id": null,
    "permission_name": null,
    "is_alias": 0,
    "alias_email": "",
    "alias_full_name": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member&format=xml

Query parameters

    email = email.of@the.team.member
full_name = full name of the team member
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <email>email.of@the.team.member</email>  
    <full_name>full name of the team member</full_name>  
    <added>1 on success, 0 otherwise</added>  
    <id>afa88b03b9a63939e31a79e927c12bf9</id>  
    <level>5</level>  
    <gender>m</gender>  
    <role></role>  
    <group></group>  
    <creation>2026-05-26 14:00:32</creation>  
    <is_readonly>0</is_readonly>  
    <is_confirmed>0</is_confirmed>  
    <permission_id></permission_id>  
    <permission_name></permission_name>  
    <is_alias>0</is_alias>  
    <alias_email></alias_email>  
    <alias_full_name></alias_full_name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member&format=txt

Query parameters

    email = email.of@the.team.member
full_name = full name of the team member
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_email=email.of@the.team.member
result_full_name=full name of the team member
result_added=1 on success, 0 otherwise
result_id=afa88b03b9a63939e31a79e927c12bf9
result_level=5
result_gender=m
result_role=
result_group=
result_creation=2026-05-26 14:00:32
result_is_readonly=0
result_is_confirmed=0
result_permission_id=
result_permission_name=
result_is_alias=0
result_alias_email=
result_alias_full_name=

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member&format=plain

Query parameters

    email = email.of@the.team.member
full_name = full name of the team member
   format = plain

Response

email.of@the.team.member
full name of the team member
1 on success, 0 otherwise
afa88b03b9a63939e31a79e927c12bf9
5
m


2026-05-26 14:00:32
0
0


0

Required parameters

parameter	description	max length
emailSTRING	email address of the team member	255
full_nameSTRING	full name of the team member	255

Optional parameters

parameter	description	max length
genderSTRING	gender of the team member, possible values: [m, f], default: m	1
groupSTRING	group of the team member	50
is_aliasBOOLEAN	1 if the user has full access to the account of the user who created it
is_readonlyBOOLEAN	1 if the team member can only read information
locationSTRING	2-digit code of the country (ISO Alpha-2) the team member is based on (e.g., US)	50
permission_idID	ID of the subuser permission (can only be passed by administrator/root users)
phone_numberSTRING	phone number	255
roleSTRING	role of the team member	50

Return values

parameter	description
added	1 on success, 0 otherwise
alias_email	email of the alias user if `is_alias = 1`, empty othrwise
alias_full_name	full name of the alias user if `is_alias = 1`, empty othrwise
creation	creation date/time
email	echo back of the email input parameter
full_name	echo back of the full_name input parameter
gender	echo back of the gender input parameter
group	echo back of the group input parameter
id	ID of the team member
is_alias	echo back of the is_alias input parameter
is_confirmed	1 if the team member confirmed the account by clicking on the confirmation link sent by email, 0 otherwise. The return value is always 0 when adding a new team member. Read the note below for details.
is_readonly	echo back of the is_readonly input parameter
level	level of the team member (level represents the user hierarchy, parent users have a lower level than childrens)
permission_id	ID of the subuser permission (only returned for administrator/root users)
permission_name	name of the subuser permission (only returned for administrator/root users)
role	echo back of the role input parameter

/subusers/count

access: [READ]

This method returns the number of team members.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 7
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>7</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=7

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters team members to be extracted by searching them
with_projectsBOOLEAN	1 to count only team members who created projects still present in the dashboard, 0 otherwise (default)

Return values

parameter	description
count	the number of team members

/subusers/delete

access: [WRITE]

This method deletes a team member.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/delete?ids=a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284

Query parameters

ids = a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/delete?ids=a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284&format=xml

Query parameters

   ids = a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>5</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/delete?ids=a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284&format=txt

Query parameters

   ids = a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=5

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/delete?ids=a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284&format=plain

Query parameters

   ids = a43c549ec7e95431d0f02929701316d2,20fbf4a438b31aee93d8f161aa25ac86,e0668598f500fbb325f2494c7b209d11,30553906694f6019e4ad7e83c6be3423,0712885a0ad227005b594e8defb97284
format = plain

Response

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of team members to remove

Return values

parameter	description
deleted	number of deleted team members on success, 0 otherwise

/subusers/edit

access: [WRITE]

This method edits a team member.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member

Query parameters

full_name = new full name of the team member

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "full_name": "new full name of the team member",
    "updated": "1 on success, 0 otherwise",
    "id": "edb0b3c0765d32e5c50a396cf8ae0efa",
    "is_alias": 0,
    "alias_email": "",
    "alias_full_name": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member&format=xml

Query parameters

full_name = new full name of the team member
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <full_name>new full name of the team member</full_name>  
    <updated>1 on success, 0 otherwise</updated>  
    <id>edb0b3c0765d32e5c50a396cf8ae0efa</id>  
    <is_alias>0</is_alias>  
    <alias_email></alias_email>  
    <alias_full_name></alias_full_name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member&format=txt

Query parameters

full_name = new full name of the team member
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_full_name=new full name of the team member
result_updated=1 on success, 0 otherwise
result_id=edb0b3c0765d32e5c50a396cf8ae0efa
result_is_alias=0
result_alias_email=
result_alias_full_name=

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member&format=plain

Query parameters

full_name = new full name of the team member
   format = plain

Response

new full name of the team member
1 on success, 0 otherwise
edb0b3c0765d32e5c50a396cf8ae0efa
0

Required parameters

parameter	description
idID	ID of the team member

Optional parameters

parameter	description	max length
full_nameSTRING	full name of the team member	255
genderSTRING	gender of the team member, possible values: [m, f], default: m	1
groupSTRING	group of the team member	50
is_aliasBOOLEAN	1 if the user has full access to the account of the user who created it
is_confirmedBOOLEAN	1 to enable the team member, 0 to disable
is_readonlyBOOLEAN	1 if the team member can only read information
locationSTRING	2-digit code of the country (ISO Alpha-2) the team member is based on (e.g., US)	50
permission_idID	ID of the subuser permission (can only be passed by administrator/root users)
phone_numberSTRING	phone number	255
roleSTRING	role of the team member	50

Return values

parameter	description
alias_email	email of the alias user if `is_alias = 1`, empty otherwise
alias_full_name	full name of the alias user if `is_alias = 1`, empty otherwise
creation	[OPTIONAL] creation date/time
full_name	[OPTIONAL] echo back of the full_name input parameter
gender	[OPTIONAL] echo back of the gender input parameter
group	[OPTIONAL] echo back of the group input parameter
id	ID of the team member
is_alias	echo back of the is_alias input parameter
is_readonly	[OPTIONAL] echo back of the is_readonly input parameter
location	[OPTIONAL] echo back of the location input parameter
permission_id	ID of the subuser permission (only returned for administrator/root users)
permission_name	name of the subuser permission (only returned for administrator/root users)
permissions_updated	number of team members whose permissions were updated
phone_number	[OPTIONAL] echo back of the phone_number input parameter
role	[OPTIONAL] echo back of the role input parameter
updated	1 on success, 0 otherwise

/subusers/info

access: [READ]

This method returns info about a team member.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/info?fields=parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=abec00385b4b364dc4a7a304fb56c6bf

Query parameters

fields = parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
    id = abec00385b4b364dc4a7a304fb56c6bf

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "parent_id": "093bb52dd59e25cfbd54dc41efe42471",
        "id": "abec00385b4b364dc4a7a304fb56c6bf",
        "level": 1,
        "email": "email.of@the.team.member",
        "full_name": "full name of the team member",
        "group": "",
        "role": "Tester",
        "is_readonly": 0,
        "last_login": "2026-05-26 14:00:32",
        "is_confirmed": 1,
        "permission_id": "64c589300d348c3db42c8cebbf1122b6",
        "permission_name": "permission name",
        "is_alias": 0,
        "alias_email": "",
        "alias_full_name": ""
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/info?fields=parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=abec00385b4b364dc4a7a304fb56c6bf&format=xml

Query parameters

fields = parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
    id = abec00385b4b364dc4a7a304fb56c6bf
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <parent_id>093bb52dd59e25cfbd54dc41efe42471</parent_id>  
        <id>abec00385b4b364dc4a7a304fb56c6bf</id>  
        <level>1</level>  
        <email>email.of@the.team.member</email>  
        <full_name>full name of the team member</full_name>  
        <group></group>  
        <role>Tester</role>  
        <is_readonly>0</is_readonly>  
        <last_login>2026-05-26 14:00:32</last_login>  
        <is_confirmed>1</is_confirmed>  
        <permission_id>64c589300d348c3db42c8cebbf1122b6</permission_id>  
        <permission_name>permission name</permission_name>  
        <is_alias>0</is_alias>  
        <alias_email></alias_email>  
        <alias_full_name></alias_full_name>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/info?fields=parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=abec00385b4b364dc4a7a304fb56c6bf&format=txt

Query parameters

fields = parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
    id = abec00385b4b364dc4a7a304fb56c6bf
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_parent_id=093bb52dd59e25cfbd54dc41efe42471
result_data_0_id=abec00385b4b364dc4a7a304fb56c6bf
result_data_0_level=1
result_data_0_email=email.of@the.team.member
result_data_0_full_name=full name of the team member
result_data_0_group=
result_data_0_role=Tester
result_data_0_is_readonly=0
result_data_0_last_login=2026-05-26 14:00:32
result_data_0_is_confirmed=1
result_data_0_permission_id=64c589300d348c3db42c8cebbf1122b6
result_data_0_permission_name=permission name
result_data_0_is_alias=0
result_data_0_alias_email=
result_data_0_alias_full_name=

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/info?fields=parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=abec00385b4b364dc4a7a304fb56c6bf&format=plain

Query parameters

fields = parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
    id = abec00385b4b364dc4a7a304fb56c6bf
format = plain

Response

093bb52dd59e25cfbd54dc41efe42471
abec00385b4b364dc4a7a304fb56c6bf
1
email.of@the.team.member
full name of the team member

Tester
0
2026-05-26 14:00:32
1
64c589300d348c3db42c8cebbf1122b6
permission name
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, is_confirmed, creation, email, full_name, gender, group, id, is_readonly, last_login, level, location, name, phone_number, role, parent_id
idID	ID of the team member

Return values

parameter	description
data	array containing information on the team members, returned information depends on the fields parameter.

/subusers/list

access: [READ]

This method returns a list of team members.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/list?fields=count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias

Query parameters

fields = count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "parent_id": "2bdc6fbcc47a23dbce4980cad8df396f",
        "id": "d61edc82310bf44284ffabc47f7eb117",
        "level": 1,
        "email": "email.of@the.team.member",
        "full_name": "full name of the team member",
        "group": "",
        "role": "Tester",
        "is_readonly": 0,
        "last_login": "2026-05-26 14:00:32",
        "is_confirmed": 1,
        "permission_id": "55735d869659c55aedee2255ed3404bb",
        "permission_name": "permission name",
        "is_alias": 0,
        "alias_email": "",
        "alias_full_name": ""
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/list?fields=count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&format=xml

Query parameters

fields = count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <parent_id>2bdc6fbcc47a23dbce4980cad8df396f</parent_id>  
        <id>d61edc82310bf44284ffabc47f7eb117</id>  
        <level>1</level>  
        <email>email.of@the.team.member</email>  
        <full_name>full name of the team member</full_name>  
        <group></group>  
        <role>Tester</role>  
        <is_readonly>0</is_readonly>  
        <last_login>2026-05-26 14:00:32</last_login>  
        <is_confirmed>1</is_confirmed>  
        <permission_id>55735d869659c55aedee2255ed3404bb</permission_id>  
        <permission_name>permission name</permission_name>  
        <is_alias>0</is_alias>  
        <alias_email></alias_email>  
        <alias_full_name></alias_full_name>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/list?fields=count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&format=txt

Query parameters

fields = count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_parent_id=2bdc6fbcc47a23dbce4980cad8df396f
result_data_0_id=d61edc82310bf44284ffabc47f7eb117
result_data_0_level=1
result_data_0_email=email.of@the.team.member
result_data_0_full_name=full name of the team member
result_data_0_group=
result_data_0_role=Tester
result_data_0_is_readonly=0
result_data_0_last_login=2026-05-26 14:00:32
result_data_0_is_confirmed=1
result_data_0_permission_id=55735d869659c55aedee2255ed3404bb
result_data_0_permission_name=permission name
result_data_0_is_alias=0
result_data_0_alias_email=
result_data_0_alias_full_name=

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/list?fields=count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&format=plain

Query parameters

fields = count,parent_id,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
format = plain

Response

1
2bdc6fbcc47a23dbce4980cad8df396f
d61edc82310bf44284ffabc47f7eb117
1
email.of@the.team.member
full name of the team member

Tester
0
2026-05-26 14:00:32
1
55735d869659c55aedee2255ed3404bb
permission name
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, is_confirmed, creation, email, full_name, gender, group, id, is_readonly, last_login, level, location, name, phone_number, role, parent_id

Optional parameters

parameter	description
lengthINTEGER	extracts this number of team members (maxmimum allowed: 100)
orderbyARRAY	orders team members by field, available fields: is_confirmed, creation, email, full_name, gender, group, id, is_readonly, last_login, level, location, name, phone_number, role, parent_id
project_idID	ID of the project, when passed the field `has_access` is returned for each team member, `has_access = 1` if the team member has access to the project, `has_access = 0` otherwise
searchSTRING	filters team members to be extracted by searching them
sortSTRING	sorts team members in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract team members from this position
with_projectsBOOLEAN	1 to extract only team members who created projects still present in the dashboard, 0 otherwise (default)

Return values

parameter	description
count	[OPTIONAL] total number of team members, returned only if count is passed in fields
data	array containing information on the team members, returned information depends on the fields parameter.

/subusers/projects

/subusers/projects/grant

access: [WRITE]

Grants access to projects to the team member.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/projects/grant?id=8ebeb683bd719952c62792b95042d674&add_ids=92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11&delete_ids=6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba

Query parameters

        id = 8ebeb683bd719952c62792b95042d674
   add_ids = 92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11
delete_ids = 6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 3,
    "deleted": 4
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/projects/grant?id=8ebeb683bd719952c62792b95042d674&add_ids=92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11&delete_ids=6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba&format=xml

Query parameters

        id = 8ebeb683bd719952c62792b95042d674
   add_ids = 92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11
delete_ids = 6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>3</added>  
    <deleted>4</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/projects/grant?id=8ebeb683bd719952c62792b95042d674&add_ids=92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11&delete_ids=6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba&format=txt

Query parameters

        id = 8ebeb683bd719952c62792b95042d674
   add_ids = 92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11
delete_ids = 6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=3
result_deleted=4

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/projects/grant?id=8ebeb683bd719952c62792b95042d674&add_ids=92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11&delete_ids=6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba&format=plain

Query parameters

        id = 8ebeb683bd719952c62792b95042d674
   add_ids = 92c531a71f4831a89d8037578f66b4ae,0247e44fef425c3cd12b69e67245f5ae,aa8f9963a7facf0869a1ba97f0f7ff11
delete_ids = 6a2cf5e0776f24370be05433d3ad11b8,639662c603a2910b65e3e4a379955b33,f1cf3149591b6d1c7c06d82cb296aeb3,8b87db4f9e23071e58df6349ca5eb5ba
    format = plain

Response

3
4

Required parameters

parameter	description
idID	ID of the team member

Optional parameters

parameter	description
add_idsARRAY_OF_IDS	comma separated list of project IDs to grant access to the team member
delete_idsARRAY_OF_IDS	comma-separated list of project IDs to deny access to the team member

Return values

parameter	description
added	number of project IDs that the team member has been granted access to
deleted	number of project IDs that the team member was denied access to

/subusers/roles_groups

/subusers/roles_groups/list

access: [READ]

This method returns a list of roles or groups previously used.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test

Query parameters

  type = role
search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    "test",
    "Tester",
    "main tester"
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test&format=xml

Query parameters

  type = role
search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>test</i0>  
    <i1>Tester</i1>  
    <i2>main tester</i2>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test&format=txt

Query parameters

  type = role
search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0=test
result_1=Tester
result_2=main tester

Example 4 (plain)

Request

https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test&format=plain

Query parameters

  type = role
search = test
format = plain

Response

test
Tester
main tester

Required parameters

parameter	description
typeSTRING	type to list, available types: [role, group]

Optional parameters

parameter	description
lengthINTEGER	extracts this number of roles & groups (maxmimum allowed: 100)
searchSTRING	filters roles & groups to be extracted by searching them
startINTEGER	starts to extract roles & groups from this position

Return values

parameter	description
[ARRAY]	array containing requested information.

/urls

/urls/balancers

/urls/balancers/clone

access: [WRITE]

Clone the balancer configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/balancers/clone?from_url_id=baa113f5451f2fb3fb945def1a8ee512&to_url_id=0db4acc9a386dac839392ab7666c8b50

Query parameters

from_url_id = baa113f5451f2fb3fb945def1a8ee512
  to_url_id = 0db4acc9a386dac839392ab7666c8b50

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/balancers/clone?from_url_id=baa113f5451f2fb3fb945def1a8ee512&to_url_id=0db4acc9a386dac839392ab7666c8b50&format=xml

Query parameters

from_url_id = baa113f5451f2fb3fb945def1a8ee512
  to_url_id = 0db4acc9a386dac839392ab7666c8b50
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/balancers/clone?from_url_id=baa113f5451f2fb3fb945def1a8ee512&to_url_id=0db4acc9a386dac839392ab7666c8b50&format=txt

Query parameters

from_url_id = baa113f5451f2fb3fb945def1a8ee512
  to_url_id = 0db4acc9a386dac839392ab7666c8b50
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/balancers/clone?from_url_id=baa113f5451f2fb3fb945def1a8ee512&to_url_id=0db4acc9a386dac839392ab7666c8b50&format=plain

Query parameters

from_url_id = baa113f5451f2fb3fb945def1a8ee512
  to_url_id = 0db4acc9a386dac839392ab7666c8b50
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the balancer configuration from
to_url_idID	ID of the tracking link you want to copy the balancer configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/balancers/delete

access: [WRITE]

Delete the smart balancer linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/balancers/delete?id=2d41ca117422d52555021b32aaa8204c

Query parameters

id = 2d41ca117422d52555021b32aaa8204c

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/balancers/delete?id=2d41ca117422d52555021b32aaa8204c&format=xml

Query parameters

    id = 2d41ca117422d52555021b32aaa8204c
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/balancers/delete?id=2d41ca117422d52555021b32aaa8204c&format=txt

Query parameters

    id = 2d41ca117422d52555021b32aaa8204c
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/balancers/delete?id=2d41ca117422d52555021b32aaa8204c&format=plain

Query parameters

    id = 2d41ca117422d52555021b32aaa8204c
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove the balancer

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/balancers/edit

access: [WRITE]

Set the smart balancer for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/balancers/edit?id=8e48ba23645b2e99ace8621f2f44ec9c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D

Query parameters

     id = 8e48ba23645b2e99ace8621f2f44ec9c
   type = WEIGHTED
   urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/balancers/edit?id=8e48ba23645b2e99ace8621f2f44ec9c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D&format=xml

Query parameters

     id = 8e48ba23645b2e99ace8621f2f44ec9c
   type = WEIGHTED
   urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/balancers/edit?id=8e48ba23645b2e99ace8621f2f44ec9c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D&format=txt

Query parameters

     id = 8e48ba23645b2e99ace8621f2f44ec9c
   type = WEIGHTED
   urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/balancers/edit?id=8e48ba23645b2e99ace8621f2f44ec9c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D&format=plain

Query parameters

     id = 8e48ba23645b2e99ace8621f2f44ec9c
   type = WEIGHTED
   urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
 format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link on which to enable the balancer
typeSTRING	balancer type, available types: SEQUENTIAL, WEIGHTED, WEIGHTED_FIXED, RANDOM, RANDOM_FIXED, SWITCHING, SPLIT_TEST
urlsJSON	JSON array of destination URLs to be used with the balancer, a maximum of 5 destination URLs can be used when `type = SPLIT_TEST`, otherwise a maximum of 100 destination URLs is allowed

Parameter type can be one of the following:

SEQUENTIAL: on each visits, redirects clicks to the next destination page
WEIGHTED: with this type you can allocate (percentage) how much traffic goes to destination URL
WEIGHTED_FIXED: similar to WEIGHTED, but a return user is redirected to the page he/she was redirected to on the first visit
RANDOM: the balancer redirects randomly to a destination URL
RANDOM_FIXED: similar to RANDOM, but a return user is redirected to the page he/she was redirected to on the first visit
SWITCHING: the balancer redirects each visitor starting from the first destination URL; if the visitor returns, the balancer will show the next destination URL (cookie based)
SPLIT_TEST: the balancer randomly redirects to a destination URL, each destination URL has an associated conversion code that allows to evaluate which of your destination URLs performs best

Optional parameters

parameter	description
conversionsARRAY_OF_IDS	conversion codes to be used when `type = SPLIT_TEST`
weightsJSON	JSON array of floats between 0.0 and 100.0, the balancer will use these floats to randomly select destination URLs, this parameter is mandatory for `type = WEIGHTED` and `type = WEIGHTED_FIXED`, it must contain the same number of items in `urls`

Return values

parameter	description
enabled	1 on success, 0 otherwise

/urls/balancers/info

access: [READ]

Get the smart balancer linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/balancers/info?id=385a1cd5d716a129efa848ceda5a87a4

Query parameters

id = 385a1cd5d716a129efa848ceda5a87a4

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "385a1cd5d716a129efa848ceda5a87a4",
    "type": "WEIGHTED",
    "info": [
      {
        "url": "https:\/\/www.joturl.com\/pricing\/",
        "weight": "22.22"
      },
      {
        "url": "https:\/\/www.joturl.com\/",
        "weight": "77.78"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/balancers/info?id=385a1cd5d716a129efa848ceda5a87a4&format=xml

Query parameters

    id = 385a1cd5d716a129efa848ceda5a87a4
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>385a1cd5d716a129efa848ceda5a87a4</id>  
    <type>WEIGHTED</type>  
    <info>
      <i0>
        <url>https://www.joturl.com/pricing/</url>  
        <weight>22.22</weight>  
      </i0>  
      <i1>
        <url>https://www.joturl.com/</url>  
        <weight>77.78</weight>  
      </i1>  
    </info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/balancers/info?id=385a1cd5d716a129efa848ceda5a87a4&format=txt

Query parameters

    id = 385a1cd5d716a129efa848ceda5a87a4
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=385a1cd5d716a129efa848ceda5a87a4
result_type=WEIGHTED
result_info_0_url=https://www.joturl.com/pricing/
result_info_0_weight=22.22
result_info_1_url=https://www.joturl.com/
result_info_1_weight=77.78

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/balancers/info?id=385a1cd5d716a129efa848ceda5a87a4&format=plain

Query parameters

    id = 385a1cd5d716a129efa848ceda5a87a4
format = plain

Response

385a1cd5d716a129efa848ceda5a87a4
WEIGHTED
https://www.joturl.com/pricing/
22.22
https://www.joturl.com/
77.78

Required parameters

parameter	description
idID	ID of the tracking link whose balancer configuration is desired

Return values

parameter	description
id	echo back of parameter id
info	array of couples (url, weight)
type	balancer type, see i1/urls/balancers/edit for details

/urls/balancers/property

access: [READ]

This method returns smart balancer types that are available to the logged users.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/balancers/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "types": {
      "SEQUENTIAL": {
        "is_split": 0
      },
      "WEIGHTED": {
        "is_split": 0
      },
      "WEIGHTED_FIXED": {
        "is_split": 0
      },
      "RANDOM": {
        "is_split": 0
      },
      "RANDOM_FIXED": {
        "is_split": 0
      },
      "SWITCHING": {
        "is_split": 0
      },
      "SPLIT_TEST": {
        "is_split": 1
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/balancers/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <types>
      <SEQUENTIAL>
        <is_split>0</is_split>  
      </SEQUENTIAL>  
      <WEIGHTED>
        <is_split>0</is_split>  
      </WEIGHTED>  
      <WEIGHTED_FIXED>
        <is_split>0</is_split>  
      </WEIGHTED_FIXED>  
      <RANDOM>
        <is_split>0</is_split>  
      </RANDOM>  
      <RANDOM_FIXED>
        <is_split>0</is_split>  
      </RANDOM_FIXED>  
      <SWITCHING>
        <is_split>0</is_split>  
      </SWITCHING>  
      <SPLIT_TEST>
        <is_split>1</is_split>  
      </SPLIT_TEST>  
    </types>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/balancers/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_types_SEQUENTIAL_is_split=0
result_types_WEIGHTED_is_split=0
result_types_WEIGHTED_FIXED_is_split=0
result_types_RANDOM_is_split=0
result_types_RANDOM_FIXED_is_split=0
result_types_SWITCHING_is_split=0
result_types_SPLIT_TEST_is_split=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/balancers/property?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
types	array of smart balancer types

/urls/browserdeeplinks

/urls/browserdeeplinks/clone

access: [WRITE]

Clone the browser deep link configuration from a tracking link to another. This endpoint is a convenience helper built on top of i1/urls/easydeeplinks/clone to simplify common use cases.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/clone?from_url_id=63754f4b2f651fa32ade93e6a2faafe7&to_url_id=c0252e4695518af15751d6ef1eb425a8

Query parameters

from_url_id = 63754f4b2f651fa32ade93e6a2faafe7
  to_url_id = c0252e4695518af15751d6ef1eb425a8

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/clone?from_url_id=63754f4b2f651fa32ade93e6a2faafe7&to_url_id=c0252e4695518af15751d6ef1eb425a8&format=xml

Query parameters

from_url_id = 63754f4b2f651fa32ade93e6a2faafe7
  to_url_id = c0252e4695518af15751d6ef1eb425a8
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/clone?from_url_id=63754f4b2f651fa32ade93e6a2faafe7&to_url_id=c0252e4695518af15751d6ef1eb425a8&format=txt

Query parameters

from_url_id = 63754f4b2f651fa32ade93e6a2faafe7
  to_url_id = c0252e4695518af15751d6ef1eb425a8
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/clone?from_url_id=63754f4b2f651fa32ade93e6a2faafe7&to_url_id=c0252e4695518af15751d6ef1eb425a8&format=plain

Query parameters

from_url_id = 63754f4b2f651fa32ade93e6a2faafe7
  to_url_id = c0252e4695518af15751d6ef1eb425a8
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the browser deep link configuration from
to_url_idID	ID of the tracking link you want to the browser deep link configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/browserdeeplinks/delete

access: [WRITE]

Unset (delete) a browser deep link configuration for a tracking link. This endpoint is a convenience helper built on top of i1/urls/easydeeplinks/delete to simplify common use cases.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/delete?id=e48a870452dafa3f7c93a45eb9faf1e4

Query parameters

id = e48a870452dafa3f7c93a45eb9faf1e4

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/delete?id=e48a870452dafa3f7c93a45eb9faf1e4&format=xml

Query parameters

    id = e48a870452dafa3f7c93a45eb9faf1e4
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/delete?id=e48a870452dafa3f7c93a45eb9faf1e4&format=txt

Query parameters

    id = e48a870452dafa3f7c93a45eb9faf1e4
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/delete?id=e48a870452dafa3f7c93a45eb9faf1e4&format=plain

Query parameters

    id = e48a870452dafa3f7c93a45eb9faf1e4
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a browser deep link configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/browserdeeplinks/edit

access: [WRITE]

Set a browser deep link settings for a tracking link. This endpoint is a convenience helper built on top of i1/urls/easydeeplinks/edit to simplify common use cases.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/edit?id=4b718d5a6a438bb97bad56f75c5fd9e5

Query parameters

id = 4b718d5a6a438bb97bad56f75c5fd9e5

Post parameters

settings=%7B%22name%22%3A%22Unknown%22%2C%22category%22%3A%22unknown%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22info%22%3A%7B%22title%22%3A%22JotUrl%22%2C%22description%22%3A%22%22%2C%22image%22%3A%22%22%2C%22ios_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22ios_store_url%22%3A%22%22%2C%22android_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22android_store_url%22%3A%22%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22%22%2C%22app_store_id%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22%22%2C%22package%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%7D%2C%22android%22%3A%7B%22app_name%22%3A%22Browser%22%7D%2C%22ios%22%3A%7B%22app_name%22%3A%22Browser%22%7D%7D%2C%22detected%22%3A%5B%5D%2C%22override_app_name%22%3A%22Browser%22%2C%22og_title%22%3A%22JotUrl%22%2C%22og_description%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/edit?id=4b718d5a6a438bb97bad56f75c5fd9e5&format=xml

Query parameters

    id = 4b718d5a6a438bb97bad56f75c5fd9e5
format = xml

Post parameters

settings=%7B%22name%22%3A%22Unknown%22%2C%22category%22%3A%22unknown%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22info%22%3A%7B%22title%22%3A%22JotUrl%22%2C%22description%22%3A%22%22%2C%22image%22%3A%22%22%2C%22ios_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22ios_store_url%22%3A%22%22%2C%22android_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22android_store_url%22%3A%22%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22%22%2C%22app_store_id%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22%22%2C%22package%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%7D%2C%22android%22%3A%7B%22app_name%22%3A%22Browser%22%7D%2C%22ios%22%3A%7B%22app_name%22%3A%22Browser%22%7D%7D%2C%22detected%22%3A%5B%5D%2C%22override_app_name%22%3A%22Browser%22%2C%22og_title%22%3A%22JotUrl%22%2C%22og_description%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/edit?id=4b718d5a6a438bb97bad56f75c5fd9e5&format=txt

Query parameters

    id = 4b718d5a6a438bb97bad56f75c5fd9e5
format = txt

Post parameters

settings=%7B%22name%22%3A%22Unknown%22%2C%22category%22%3A%22unknown%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22info%22%3A%7B%22title%22%3A%22JotUrl%22%2C%22description%22%3A%22%22%2C%22image%22%3A%22%22%2C%22ios_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22ios_store_url%22%3A%22%22%2C%22android_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22android_store_url%22%3A%22%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22%22%2C%22app_store_id%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22%22%2C%22package%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%7D%2C%22android%22%3A%7B%22app_name%22%3A%22Browser%22%7D%2C%22ios%22%3A%7B%22app_name%22%3A%22Browser%22%7D%7D%2C%22detected%22%3A%5B%5D%2C%22override_app_name%22%3A%22Browser%22%2C%22og_title%22%3A%22JotUrl%22%2C%22og_description%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/edit?id=4b718d5a6a438bb97bad56f75c5fd9e5&format=plain

Query parameters

    id = 4b718d5a6a438bb97bad56f75c5fd9e5
format = plain

Post parameters

settings=%7B%22name%22%3A%22Unknown%22%2C%22category%22%3A%22unknown%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22%22%7D%2C%22force_chrome%22%3A1%2C%22force_redirect%22%3A0%2C%22disable_ok_cancel%22%3A1%2C%22disable_open_in_browser_page%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22info%22%3A%7B%22title%22%3A%22JotUrl%22%2C%22description%22%3A%22%22%2C%22image%22%3A%22%22%2C%22ios_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22ios_store_url%22%3A%22%22%2C%22android_url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%2C%22android_store_url%22%3A%22%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22%22%2C%22app_store_id%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22%22%2C%22package%22%3A%22%22%2C%22url%22%3A%22https%3A%2F%2Fgoogle.com%2F%22%7D%7D%2C%22android%22%3A%7B%22app_name%22%3A%22Browser%22%7D%2C%22ios%22%3A%7B%22app_name%22%3A%22Browser%22%7D%7D%2C%22detected%22%3A%5B%5D%2C%22override_app_name%22%3A%22Browser%22%2C%22og_title%22%3A%22JotUrl%22%2C%22og_description%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

Required parameters

parameter	description
idID	tracking link ID for which you want to edit the browser deep link configuration
settingsJSON	stringified JSON of the browser deep link configuration, see i1/urls/browserdeeplinks/info for details, you can use the optional `override_app_name` field to define the name of the custom app (default: `App`)

Return values

parameter	description
enabled	1 if the browser deep link option has been successfully enabled, 0 otherwise

/urls/browserdeeplinks/info

access: [READ]

Get a browser deep link settings for a tracking link. This endpoint is a convenience helper built on top of i1/urls/easydeeplinks/info to simplify common use cases.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=271f82799ddfb432d24f47c20e7464d6

Query parameters

id = 271f82799ddfb432d24f47c20e7464d6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "Unknown",
    "category": "unknown",
    "ios": {
      "phone": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "https:\/\/google.com\/",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": ""
        },
        "disable_ok_cancel": 1
      },
      "tablet": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "https:\/\/google.com\/",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": ""
        },
        "disable_ok_cancel": 1
      }
    },
    "android": {
      "phone": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "https:\/\/google.com\/",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": ""
        },
        "force_chrome": 1,
        "force_redirect": 0,
        "disable_ok_cancel": 1
      },
      "tablet": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "https:\/\/google.com\/",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": ""
        },
        "force_chrome": 1,
        "force_redirect": 0,
        "disable_ok_cancel": 1
      }
    },
    "default_url": "https:\/\/google.com\/",
    "info": {
      "title": "JotUrl",
      "description": "",
      "image": "",
      "ios_url": "https:\/\/google.com\/",
      "ios_store_url": "",
      "android_url": "https:\/\/google.com\/",
      "android_store_url": "",
      "info": {
        "ios": {
          "app_name": "",
          "app_store_id": "",
          "url": "https:\/\/google.com\/"
        },
        "android": {
          "app_name": "",
          "package": "",
          "url": "https:\/\/google.com\/"
        }
      },
      "android": {
        "app_name": "Browser"
      },
      "ios": {
        "app_name": "Browser"
      }
    },
    "detected": [
      "ios",
      "android"
    ],
    "autodetect": 1,
    "override_app_name": "Browser",
    "og_title": "JotUrl",
    "og_description": "",
    "og_image": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=271f82799ddfb432d24f47c20e7464d6&format=xml

Query parameters

    id = 271f82799ddfb432d24f47c20e7464d6
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>Unknown</name>  
    <category>unknown</category>  
    <ios>
      <phone>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme>https://google.com/</scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store></store>  
        </not_installed>  
        <disable_ok_cancel>1</disable_ok_cancel>  
      </phone>  
      <tablet>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme>https://google.com/</scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store></store>  
        </not_installed>  
        <disable_ok_cancel>1</disable_ok_cancel>  
      </tablet>  
    </ios>  
    <android>
      <phone>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme>https://google.com/</scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store></store>  
        </not_installed>  
        <force_chrome>1</force_chrome>  
        <force_redirect>0</force_redirect>  
        <disable_ok_cancel>1</disable_ok_cancel>  
      </phone>  
      <tablet>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme>https://google.com/</scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store></store>  
        </not_installed>  
        <force_chrome>1</force_chrome>  
        <force_redirect>0</force_redirect>  
        <disable_ok_cancel>1</disable_ok_cancel>  
      </tablet>  
    </android>  
    <default_url>https://google.com/</default_url>  
    <info>
      <title>JotUrl</title>  
      <description></description>  
      <image></image>  
      <ios_url>https://google.com/</ios_url>  
      <ios_store_url></ios_store_url>  
      <android_url>https://google.com/</android_url>  
      <android_store_url></android_store_url>  
      <info>
        <ios>
          <app_name></app_name>  
          <app_store_id></app_store_id>  
          <url>https://google.com/</url>  
        </ios>  
        <android>
          <app_name></app_name>  
          <package></package>  
          <url>https://google.com/</url>  
        </android>  
      </info>  
      <android>
        <app_name>Browser</app_name>  
      </android>  
      <ios>
        <app_name>Browser</app_name>  
      </ios>  
    </info>  
    <detected>
      <i0>ios</i0>  
      <i1>android</i1>  
    </detected>  
    <autodetect>1</autodetect>  
    <override_app_name>Browser</override_app_name>  
    <og_title>JotUrl</og_title>  
    <og_description></og_description>  
    <og_image></og_image>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=271f82799ddfb432d24f47c20e7464d6&format=txt

Query parameters

    id = 271f82799ddfb432d24f47c20e7464d6
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=Unknown
result_category=unknown
result_ios_phone_enabled=1
result_ios_phone_installed_choice=scheme
result_ios_phone_installed_scheme=https://google.com/
result_ios_phone_installed_custom=
result_ios_phone_installed_alternatives=
result_ios_phone_not_installed_choice=default
result_ios_phone_not_installed_custom=
result_ios_phone_not_installed_store=
result_ios_phone_disable_ok_cancel=1
result_ios_tablet_enabled=1
result_ios_tablet_installed_choice=scheme
result_ios_tablet_installed_scheme=https://google.com/
result_ios_tablet_installed_custom=
result_ios_tablet_installed_alternatives=
result_ios_tablet_not_installed_choice=default
result_ios_tablet_not_installed_custom=
result_ios_tablet_not_installed_store=
result_ios_tablet_disable_ok_cancel=1
result_android_phone_enabled=1
result_android_phone_installed_choice=scheme
result_android_phone_installed_scheme=https://google.com/
result_android_phone_installed_custom=
result_android_phone_installed_alternatives=
result_android_phone_not_installed_choice=default
result_android_phone_not_installed_custom=
result_android_phone_not_installed_store=
result_android_phone_force_chrome=1
result_android_phone_force_redirect=0
result_android_phone_disable_ok_cancel=1
result_android_tablet_enabled=1
result_android_tablet_installed_choice=scheme
result_android_tablet_installed_scheme=https://google.com/
result_android_tablet_installed_custom=
result_android_tablet_installed_alternatives=
result_android_tablet_not_installed_choice=default
result_android_tablet_not_installed_custom=
result_android_tablet_not_installed_store=
result_android_tablet_force_chrome=1
result_android_tablet_force_redirect=0
result_android_tablet_disable_ok_cancel=1
result_default_url=https://google.com/
result_info_title=JotUrl
result_info_description=
result_info_image=
result_info_ios_url=https://google.com/
result_info_ios_store_url=
result_info_android_url=https://google.com/
result_info_android_store_url=
result_info_info_ios_app_name=
result_info_info_ios_app_store_id=
result_info_info_ios_url=https://google.com/
result_info_info_android_app_name=
result_info_info_android_package=
result_info_info_android_url=https://google.com/
result_info_android_app_name=Browser
result_info_ios_app_name=Browser
result_detected_0=ios
result_detected_1=android
result_autodetect=1
result_override_app_name=Browser
result_og_title=JotUrl
result_og_description=
result_og_image=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=271f82799ddfb432d24f47c20e7464d6&format=plain

Query parameters

    id = 271f82799ddfb432d24f47c20e7464d6
format = plain

Response

Unknown
unknown
1
scheme
https://google.com/


default


1
1
scheme
https://google.com/


default


1
1
scheme
https://google.com/


default


1
0
1
1
scheme
https://google.com/


default


1
0
1
https://google.com/
JotUrl


https://google.com/

https://google.com/



https://google.com/


https://google.com/
Browser
Browser
ios
android
1
Browser
JotUrl

Example 5 (json)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=1452a9ca4eefdc4fd97fb80b1ad387b7

Query parameters

id = 1452a9ca4eefdc4fd97fb80b1ad387b7

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "settings": "{\"name\":\"Unknown\",\"category\":\"unknown\",\"ios\":{\"phone\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"https:\\\/\\\/google.com\\\/\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"\"},\"disable_ok_cancel\":1},\"tablet\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"https:\\\/\\\/google.com\\\/\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"\"},\"disable_ok_cancel\":1}},\"android\":{\"phone\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"https:\\\/\\\/google.com\\\/\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"\"},\"force_chrome\":1,\"force_redirect\":0,\"disable_ok_cancel\":1},\"tablet\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"https:\\\/\\\/google.com\\\/\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"\"},\"force_chrome\":1,\"force_redirect\":0,\"disable_ok_cancel\":1}},\"default_url\":\"https:\\\/\\\/google.com\\\/\",\"info\":{\"title\":\"JotUrl\",\"description\":\"\",\"image\":\"\",\"ios_url\":\"https:\\\/\\\/google.com\\\/\",\"ios_store_url\":\"\",\"android_url\":\"https:\\\/\\\/google.com\\\/\",\"android_store_url\":\"\",\"info\":{\"ios\":{\"app_name\":\"\",\"app_store_id\":\"\",\"url\":\"https:\\\/\\\/google.com\\\/\"},\"android\":{\"app_name\":\"\",\"package\":\"\",\"url\":\"https:\\\/\\\/google.com\\\/\"}},\"android\":{\"app_name\":\"Browser\"},\"ios\":{\"app_name\":\"Browser\"}},\"override_app_name\":\"Browser\",\"og_title\":\"OG Title\",\"og_description\":\"OG Description\",\"og_image\":\"https:\\\/\\\/example.com\\\/og_image.png\"}",
    "autodetect": 0
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=1452a9ca4eefdc4fd97fb80b1ad387b7&format=xml

Query parameters

    id = 1452a9ca4eefdc4fd97fb80b1ad387b7
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <settings>{"name":"Unknown","category":"unknown","ios":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"disable_ok_cancel":1},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"disable_ok_cancel":1}},"android":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"force_chrome":1,"force_redirect":0,"disable_ok_cancel":1},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"force_chrome":1,"force_redirect":0,"disable_ok_cancel":1}},"default_url":"https:\/\/google.com\/","info":{"title":"JotUrl","description":"","image":"","ios_url":"https:\/\/google.com\/","ios_store_url":"","android_url":"https:\/\/google.com\/","android_store_url":"","info":{"ios":{"app_name":"","app_store_id":"","url":"https:\/\/google.com\/"},"android":{"app_name":"","package":"","url":"https:\/\/google.com\/"}},"android":{"app_name":"Browser"},"ios":{"app_name":"Browser"}},"override_app_name":"Browser","og_title":"OG Title","og_description":"OG Description","og_image":"https:\/\/example.com\/og_image.png"}</settings>  
    <autodetect>0</autodetect>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=1452a9ca4eefdc4fd97fb80b1ad387b7&format=txt

Query parameters

    id = 1452a9ca4eefdc4fd97fb80b1ad387b7
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_settings={"name":"Unknown","category":"unknown","ios":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"disable_ok_cancel":1},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"disable_ok_cancel":1}},"android":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"force_chrome":1,"force_redirect":0,"disable_ok_cancel":1},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"force_chrome":1,"force_redirect":0,"disable_ok_cancel":1}},"default_url":"https:\/\/google.com\/","info":{"title":"JotUrl","description":"","image":"","ios_url":"https:\/\/google.com\/","ios_store_url":"","android_url":"https:\/\/google.com\/","android_store_url":"","info":{"ios":{"app_name":"","app_store_id":"","url":"https:\/\/google.com\/"},"android":{"app_name":"","package":"","url":"https:\/\/google.com\/"}},"android":{"app_name":"Browser"},"ios":{"app_name":"Browser"}},"override_app_name":"Browser","og_title":"OG Title","og_description":"OG Description","og_image":"https:\/\/example.com\/og_image.png"}
result_autodetect=0

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/browserdeeplinks/info?id=1452a9ca4eefdc4fd97fb80b1ad387b7&format=plain

Query parameters

    id = 1452a9ca4eefdc4fd97fb80b1ad387b7
format = plain

Response

{"name":"Unknown","category":"unknown","ios":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"disable_ok_cancel":1},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"disable_ok_cancel":1}},"android":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"force_chrome":1,"force_redirect":0,"disable_ok_cancel":1},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"https:\/\/google.com\/","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":""},"force_chrome":1,"force_redirect":0,"disable_ok_cancel":1}},"default_url":"https:\/\/google.com\/","info":{"title":"JotUrl","description":"","image":"","ios_url":"https:\/\/google.com\/","ios_store_url":"","android_url":"https:\/\/google.com\/","android_store_url":"","info":{"ios":{"app_name":"","app_store_id":"","url":"https:\/\/google.com\/"},"android":{"app_name":"","package":"","url":"https:\/\/google.com\/"}},"android":{"app_name":"Browser"},"ios":{"app_name":"Browser"}},"override_app_name":"Browser","og_title":"OG Title","og_description":"OG Description","og_image":"https:\/\/example.com\/og_image.png"}
0

Required parameters

parameter	description
idID	tracking link ID for which you want to extract the browser deep link configuration

Return values

parameter	description
android	[OPTIONAL] array containing the browser deep link configuration for Android, returned only if `autodetect = 1`
autodetect	1 if the configuration was automatically detected, 0 if it was taken from a previously set configuration
category	[OPTIONAL] category of the browser deep link provider, returned only if `autodetect = 1`, supported categories: affiliation, business, entertainment, lifestyle, music, other, shopping, social, travel, unknown, website
default_url	[OPTIONAL] default URL for the browser deep link configuration, returned only if `autodetect = 1`
detected	[OPTIONAL] returned only if `autodetect = 1`, array containing the extracted information, it can contain the values `ios` and `android` depending on whether our system was able to extract the deep link information for that specific operating system, it contains only one of the above values in case it is not possible to extract the information for the deep link for one of the operating systems, it can be empty in case it is not possible to extract the information for the deep link
info	[OPTIONAL] Open Graph information extracted from `default_url` and raw deep link information, returned only if `autodetect = 1`
ios	[OPTIONAL] array containing the browser deep link configuration for iOS, returned only if `autodetect = 1`
name	[OPTIONAL] name of the browser deep link provider, returned only if `autodetect = 1`, supported names: Adidas, AliExpress, Amazon, Apartments.com, Apple Maps, Apple Music, Apple Podcast, Best Buy, BlueSky, Booking.com, BrandCycle, Comfrt, Discord, eBay, Epic Games Store, Etsy, Expedia, Facebook, Flipkart, Google Docs, Google Maps, Google Sheets, Google Slides, Howl, HSN, iFood, IKEA, Instagram, Kaufland, Kickstarter, Kohl's, LINE, LinkedIn, LTK, Macy's, MagicLinks, Mavely, Medium, Mercado Livre, Messenger, Microsoft Excel, Microsoft PowerPoint, Microsoft Word, Netflix, Nordstrom, Nordstrom Rack, OnlyFans, Otto, Pinterest, Poshmark, Product Hunt, Quora, QVC, Reddit, Refersion, Sephora, SHEIN, Shopee, ShopMy, Signal, Skype, Snapchat, Spotify, Steam, Target, Telegram, Temu, The Home Depot, Threads, TikTok, TripAdvisor, Trulia, Twitch TV, Ulta Beauty, Unknown, Viber, Vimeo, Walmart, WhatsApp, X, YouTube, Zendesk Support, Zillow, Zulily
settings	[OPTIONAL] returned only if `autodetect = 0`, stringified JSON of the browser deep link configuration, it contains the same fields returned when `autodetect = 1` except `autodetect` plus the fields: og_title, og_description, og_image which are the corresponding custom Open Graph fields

The android and ios arrays share the same configuration structure for both phone and tablet devices.

JSON Structure

{
    "phone": {
        "enabled": 1,
        "installed": {
            "choice": "scheme",
            "scheme": "myapp:\/\/page",
            "custom": "customscheme:\/\/page",
            "alternatives": []
        },
        "not_installed": {
            "choice": "default",
            "custom": "customscheme:\/\/fallback",
            "store": "https:\/\/play.google.com\/store\/apps\/details?id=com.example"
        },
        "disable_ok_cancel": 0,
        "disable_open_in_browser_page": 0,
        "deeplink_method": "aggressive"
    },
    "tablet": "...same structure as phone..."
}

Fields Description

General Configuration

enabled:
- 1: enables the specific configuration.
- 0: disables the configuration (the default URL will be used).

App Installed Logic (installed object)

choice:
- scheme: uses the standard URI defined in scheme.
- custom: uses the custom URI defined in custom.
alternatives: an array of fallback alternatives for the custom field. Can be empty or contain objects like {"type": "[unique ID]", "url": "[alternative custom URI scheme]"}.

App NOT Installed Logic (not_installed object)

choice:
- default: uses the global default_url.
- store: uses the store URL.
- custom: uses the custom URI.

Optional Flags

These flags may not be present in the response.

disable_ok_cancel: used to control the "OK/Cancel" dialog box displayed by the engine to maximize the likelihood of deep linking.
- 1: disables the "OK/Cancel" dialog box.
- 0: enables the "OK/Cancel" dialog box when needed.
disable_open_in_browser_page: used to control the "Open in browser" page displayed on TikTok.
- 1: disables the "Open in browser" page (Recommended if the deep link is used in TikTok ads).
- 0: enables the "Open in browser" page when needed.
force_open_in_browser_page: used to control the "Open in browser" page displayed on built-in browsers (this flag does not override the flag disable_open_in_browser_page).
- 1: forces the "Open in browser" page on all built-in browsers.
- 0: enables the "Open in browser" page when needed.

/urls/cloaking

/urls/cloaking/clone

access: [WRITE]

Clone a cloaking configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=0d6adbf6253d165a1adf5f2f231ca772&to_url_id=fd32fb78dd0e5dbca84351dc47b69e94

Query parameters

from_url_id = 0d6adbf6253d165a1adf5f2f231ca772
  to_url_id = fd32fb78dd0e5dbca84351dc47b69e94

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=0d6adbf6253d165a1adf5f2f231ca772&to_url_id=fd32fb78dd0e5dbca84351dc47b69e94&format=xml

Query parameters

from_url_id = 0d6adbf6253d165a1adf5f2f231ca772
  to_url_id = fd32fb78dd0e5dbca84351dc47b69e94
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=0d6adbf6253d165a1adf5f2f231ca772&to_url_id=fd32fb78dd0e5dbca84351dc47b69e94&format=txt

Query parameters

from_url_id = 0d6adbf6253d165a1adf5f2f231ca772
  to_url_id = fd32fb78dd0e5dbca84351dc47b69e94
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=0d6adbf6253d165a1adf5f2f231ca772&to_url_id=fd32fb78dd0e5dbca84351dc47b69e94&format=plain

Query parameters

from_url_id = 0d6adbf6253d165a1adf5f2f231ca772
  to_url_id = fd32fb78dd0e5dbca84351dc47b69e94
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy cloaking configuration from
to_url_idID	ID of the tracking link you want to copy cloaking configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/cloaking/delete

access: [WRITE]

Delete the cloaking configuration of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/cloaking/delete?id=b7547ec1188652e15182301ba6863f96

Query parameters

id = b7547ec1188652e15182301ba6863f96

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/cloaking/delete?id=b7547ec1188652e15182301ba6863f96&format=xml

Query parameters

    id = b7547ec1188652e15182301ba6863f96
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/cloaking/delete?id=b7547ec1188652e15182301ba6863f96&format=txt

Query parameters

    id = b7547ec1188652e15182301ba6863f96
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/cloaking/delete?id=b7547ec1188652e15182301ba6863f96&format=plain

Query parameters

    id = b7547ec1188652e15182301ba6863f96
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a cloaking configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/cloaking/edit

access: [WRITE]

Given the ID of a tracking link, sets a cloaking configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=526e67a91c91b35e5fca8941f5e69152&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D

Query parameters

      id = 526e67a91c91b35e5fca8941f5e69152
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=526e67a91c91b35e5fca8941f5e69152&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D&format=xml

Query parameters

      id = 526e67a91c91b35e5fca8941f5e69152
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=526e67a91c91b35e5fca8941f5e69152&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D&format=txt

Query parameters

      id = 526e67a91c91b35e5fca8941f5e69152
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=526e67a91c91b35e5fca8941f5e69152&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D&format=plain

Query parameters

      id = 526e67a91c91b35e5fca8941f5e69152
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
  format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=992f1f41c0f9618c554b7a15a2d7fcae&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D

Query parameters

      id = 992f1f41c0f9618c554b7a15a2d7fcae
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=992f1f41c0f9618c554b7a15a2d7fcae&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D&format=xml

Query parameters

      id = 992f1f41c0f9618c554b7a15a2d7fcae
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=992f1f41c0f9618c554b7a15a2d7fcae&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D&format=txt

Query parameters

      id = 992f1f41c0f9618c554b7a15a2d7fcae
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/cloaking/edit?id=992f1f41c0f9618c554b7a15a2d7fcae&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D&format=plain

Query parameters

      id = 992f1f41c0f9618c554b7a15a2d7fcae
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
  format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link
settingsJSON	stringified JSON of the cloaking configuration, see i1/urls/cloaking/info for details

Return values

parameter	description
enabled	1 if the cloaking option has been successfully enabled, 0 otherwise

/urls/cloaking/info

access: [READ]

Returns information on the cloaking configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=0f38e04b64199d754ad77533aee3d5c2

Query parameters

id = 0f38e04b64199d754ad77533aee3d5c2

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "0f38e04b64199d754ad77533aee3d5c2",
    "settings": "{\"block_url\":\"https:\\\/\\\/www.google.com\\\/\",\"corporate_ips_and_bots\":{\"block\":true},\"desktop_devices\":{\"block\":true},\"mobile_devices\":{\"block\":false},\"countries\":{\"block\":true,\"mode\":\"deny_all_except\",\"list\":[\"IT\",\"US\",\"FR\"]}}"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=0f38e04b64199d754ad77533aee3d5c2&format=xml

Query parameters

    id = 0f38e04b64199d754ad77533aee3d5c2
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>0f38e04b64199d754ad77533aee3d5c2</id>  
    <settings>{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}</settings>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=0f38e04b64199d754ad77533aee3d5c2&format=txt

Query parameters

    id = 0f38e04b64199d754ad77533aee3d5c2
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=0f38e04b64199d754ad77533aee3d5c2
result_settings={"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=0f38e04b64199d754ad77533aee3d5c2&format=plain

Query parameters

    id = 0f38e04b64199d754ad77533aee3d5c2
format = plain

Response

0f38e04b64199d754ad77533aee3d5c2
{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}

Example 5 (json)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=6b0e59cea9322f1840ed32046c158bfe

Query parameters

id = 6b0e59cea9322f1840ed32046c158bfe

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "6b0e59cea9322f1840ed32046c158bfe",
    "settings": "{\"block_url\":\"https:\\\/\\\/www.google.com\\\/\",\"corporate_ips_and_bots\":{\"block\":true},\"desktop_devices\":{\"block\":false},\"mobile_devices\":{\"block\":true,\"redirect_to\":\"https:\\\/\\\/www.amazon.com\\\/\"},\"countries\":{\"block\":true,\"mode\":\"allow_all_except\",\"list\":[\"NL\",\"ES\"]}}"
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=6b0e59cea9322f1840ed32046c158bfe&format=xml

Query parameters

    id = 6b0e59cea9322f1840ed32046c158bfe
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>6b0e59cea9322f1840ed32046c158bfe</id>  
    <settings>{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.amazon.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}</settings>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=6b0e59cea9322f1840ed32046c158bfe&format=txt

Query parameters

    id = 6b0e59cea9322f1840ed32046c158bfe
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=6b0e59cea9322f1840ed32046c158bfe
result_settings={"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.amazon.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/cloaking/info?id=6b0e59cea9322f1840ed32046c158bfe&format=plain

Query parameters

    id = 6b0e59cea9322f1840ed32046c158bfe
format = plain

Response

6b0e59cea9322f1840ed32046c158bfe
{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.amazon.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
data	[OPTIONAL] stringified JSON of the cloaking configuration, this parameter is returned only if a cloaking configuration is available for the tracking link

Available fields in the data array:

block_url: default URL to be used in the following fields
corporate_ips_and_bots: blocks requests from corporate IPs and bots
desktop_devices: blocks requests from desktop devices
mobile_devices: blocks requests from mobile devices
countries: blocks requests from specific countries

Available fields in the corporate_ips_and_bots, desktop_devices, mobile_devices arrays:

block: to enable/disable the corresponding type of block
redirect_to (optional): the URL in redirect_to will be used to redirect the user if block is true and redirect_to is not empty, , otherwise the URL specified in block_url will be used if block is true and redirect_to is empty.

Available fields in the countries array:

block: to enable/disable this type of block
list: a list of ISO (3166-1 alpha-2) country codes to allow/deny
mode: can be allow_all_except or deny_all_except, the mode allow_all_except allows requests from all countries except those in list, the mode deny_all_except blocks requests from all countries except those in list; blocked requests will be redirected to block_url

/urls/clone

access: [WRITE]

This method clones options of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=0769de6379e11b3f7c16feda8f00bca5&alias=583f6fd&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=5e3b162eb29b2fa97de60a853a55e428

Query parameters

   fields = id,short_url
   src_id = 0769de6379e11b3f7c16feda8f00bca5
    alias = 583f6fd
 long_url = https://www.joturl.com/
domain_id = 5e3b162eb29b2fa97de60a853a55e428

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1,
    "added": 0,
    "removed": 0,
    "failed": [],
    "id": "4fbd50acdc4c0c1a8e0e89228b2187d4",
    "short_url": "http:\/\/jo.my\/583f6fd"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=0769de6379e11b3f7c16feda8f00bca5&alias=583f6fd&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=5e3b162eb29b2fa97de60a853a55e428&format=xml

Query parameters

   fields = id,short_url
   src_id = 0769de6379e11b3f7c16feda8f00bca5
    alias = 583f6fd
 long_url = https://www.joturl.com/
domain_id = 5e3b162eb29b2fa97de60a853a55e428
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
    <added>0</added>  
    <removed>0</removed>  
    <failed>

    </failed>  
    <id>4fbd50acdc4c0c1a8e0e89228b2187d4</id>  
    <short_url>http://jo.my/583f6fd</short_url>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=0769de6379e11b3f7c16feda8f00bca5&alias=583f6fd&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=5e3b162eb29b2fa97de60a853a55e428&format=txt

Query parameters

   fields = id,short_url
   src_id = 0769de6379e11b3f7c16feda8f00bca5
    alias = 583f6fd
 long_url = https://www.joturl.com/
domain_id = 5e3b162eb29b2fa97de60a853a55e428
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
result_added=0
result_removed=0
result_failed=
result_id=4fbd50acdc4c0c1a8e0e89228b2187d4
result_short_url=http://jo.my/583f6fd

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=0769de6379e11b3f7c16feda8f00bca5&alias=583f6fd&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=5e3b162eb29b2fa97de60a853a55e428&format=plain

Query parameters

   fields = id,short_url
   src_id = 0769de6379e11b3f7c16feda8f00bca5
    alias = 583f6fd
 long_url = https://www.joturl.com/
domain_id = 5e3b162eb29b2fa97de60a853a55e428
   format = plain

Response

http://jo.my/583f6fd

Required parameters

parameter	description
src_idID	ID of the tracking link to be cloned

Optional parameters

parameter	description	max length
aliasSTRING	alias for the cloned tracking link, see i1/urls/shorten for details	510
domain_idID	ID of the domain for the cloned tracking link, if not specified the domain of the source tracking link will be used
dst_idID	ID of the tracking link on which to clone the options
fieldsARRAY	comma separated list of fields to return after cloning is complete, see method i1/urls/list for reference.
long_urlSTRING	destination URL for the cloned tracking link, not available for tracking pixels, if empty, the destination URL of the source tracking link will be used	4000
notesSTRING	notes for the cloned tracking link	255
project_idID	ID of the project where the cloned tracking link will be put in, if not specified the project of the source tracking link will be used
tagsARRAY_STRING	comma-separated list of tags for the cloned tracking link

Return values

parameter	description
[FIELDS]	[OPTIONAL] fields containing information on cloned tracking links, the information returned depends on the fields parameter, no field is returned if the fields parameter is empty. See i1/urls/list for details on fields
added	total number of options added or changed in the destination tracking link
cloned	total number of cloned options (removed + added/changed), this parameter can be 0 if the tracking link you cloned has no options, or if an error occurred, in the latter case the parameter `failed` is not empty
errors	List of errors that caused the option in the `failed` array to fail
failed	list of options that could not be added, modified or deleted from the destination tracking link due to an error, this parameter can be empty when the cloned tracking link has no options or when no error occurred during cloning, see i1/urls/options/list for details on returned values
removed	total number of options removed in the destination tracking link

/urls/conversions

/urls/conversions/add

access: [WRITE]

Add conversion codes to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/conversions/add?url_id=fe52da6df0b8c3a2dbd156e53bcaabb8&ids=c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a

Query parameters

url_id = fe52da6df0b8c3a2dbd156e53bcaabb8
   ids = c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 4
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/conversions/add?url_id=fe52da6df0b8c3a2dbd156e53bcaabb8&ids=c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a&format=xml

Query parameters

url_id = fe52da6df0b8c3a2dbd156e53bcaabb8
   ids = c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>4</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/conversions/add?url_id=fe52da6df0b8c3a2dbd156e53bcaabb8&ids=c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a&format=txt

Query parameters

url_id = fe52da6df0b8c3a2dbd156e53bcaabb8
   ids = c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=4

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/conversions/add?url_id=fe52da6df0b8c3a2dbd156e53bcaabb8&ids=c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a&format=plain

Query parameters

url_id = fe52da6df0b8c3a2dbd156e53bcaabb8
   ids = c1e8d0813d467a35cadf62b2bf56108d,2066eb53f0ba25ca50bcd826aed685f3,2e8445eb6a2fb288e6c48e3f831c6140,ffe94de9dec11e06de40fbf85745347a
format = plain

Response

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of conversion codes to add (maxmimum number of conversion codes: 5)
url_idID	ID of the tracking link to which to add one or more conversion codes

Return values

parameter	description
added	0 on error, the number of added conversion codes otherwise

/urls/conversions/clone

access: [WRITE]

Clone the conversions configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/conversions/clone?from_url_id=e1279642ff7ce4f08f4bc076faa43c83&to_url_id=ab54272210e40bc132f9f086e1571f9f

Query parameters

from_url_id = e1279642ff7ce4f08f4bc076faa43c83
  to_url_id = ab54272210e40bc132f9f086e1571f9f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/conversions/clone?from_url_id=e1279642ff7ce4f08f4bc076faa43c83&to_url_id=ab54272210e40bc132f9f086e1571f9f&format=xml

Query parameters

from_url_id = e1279642ff7ce4f08f4bc076faa43c83
  to_url_id = ab54272210e40bc132f9f086e1571f9f
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/conversions/clone?from_url_id=e1279642ff7ce4f08f4bc076faa43c83&to_url_id=ab54272210e40bc132f9f086e1571f9f&format=txt

Query parameters

from_url_id = e1279642ff7ce4f08f4bc076faa43c83
  to_url_id = ab54272210e40bc132f9f086e1571f9f
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/conversions/clone?from_url_id=e1279642ff7ce4f08f4bc076faa43c83&to_url_id=ab54272210e40bc132f9f086e1571f9f&format=plain

Query parameters

from_url_id = e1279642ff7ce4f08f4bc076faa43c83
  to_url_id = ab54272210e40bc132f9f086e1571f9f
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the conversions configuration from
to_url_idID	ID of the tracking link you want to copy the conversions configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/conversions/count

access: [READ]

This method returns the number of conversion codes linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/conversions/count?url_id=60b0b792fdd5f9685d1678a5b702f51b

Query parameters

url_id = 60b0b792fdd5f9685d1678a5b702f51b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/conversions/count?url_id=60b0b792fdd5f9685d1678a5b702f51b&format=xml

Query parameters

url_id = 60b0b792fdd5f9685d1678a5b702f51b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/conversions/count?url_id=60b0b792fdd5f9685d1678a5b702f51b&format=txt

Query parameters

url_id = 60b0b792fdd5f9685d1678a5b702f51b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/conversions/count?url_id=60b0b792fdd5f9685d1678a5b702f51b&format=plain

Query parameters

url_id = 60b0b792fdd5f9685d1678a5b702f51b
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link to check

Return values

parameter	description
count	the number of linked conversion codes

/urls/conversions/delete

access: [WRITE]

Delete one or more conversion codes linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/conversions/delete?url_id=e825b658bccfad6ef2b68e07beaeed64

Query parameters

url_id = e825b658bccfad6ef2b68e07beaeed64

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/conversions/delete?url_id=e825b658bccfad6ef2b68e07beaeed64&format=xml

Query parameters

url_id = e825b658bccfad6ef2b68e07beaeed64
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/conversions/delete?url_id=e825b658bccfad6ef2b68e07beaeed64&format=txt

Query parameters

url_id = e825b658bccfad6ef2b68e07beaeed64
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/conversions/delete?url_id=e825b658bccfad6ef2b68e07beaeed64&format=plain

Query parameters

url_id = e825b658bccfad6ef2b68e07beaeed64
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link from which to remove one or more conversion codes

Optional parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of conversion codes to remove, if empty all conversion codes will be removed

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/conversions/edit

access: [WRITE]

Edit the list of conversion codes linked to a tracking link (all previous conversion codes are removed).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/conversions/edit?url_id=56fc20377c3a2fcb9d38bbc770b4bc63&ids=0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93

Query parameters

url_id = 56fc20377c3a2fcb9d38bbc770b4bc63
   ids = 0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/conversions/edit?url_id=56fc20377c3a2fcb9d38bbc770b4bc63&ids=0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93&format=xml

Query parameters

url_id = 56fc20377c3a2fcb9d38bbc770b4bc63
   ids = 0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93</ids>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/conversions/edit?url_id=56fc20377c3a2fcb9d38bbc770b4bc63&ids=0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93&format=txt

Query parameters

url_id = 56fc20377c3a2fcb9d38bbc770b4bc63
   ids = 0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/conversions/edit?url_id=56fc20377c3a2fcb9d38bbc770b4bc63&ids=0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93&format=plain

Query parameters

url_id = 56fc20377c3a2fcb9d38bbc770b4bc63
   ids = 0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93
format = plain

Response

0bbc2636104bceeb2fee28767bede8a8,9693be38c07e3054fa46dfca32cc5436,61d1e2ae54840b0c35daec68c871b0e5,ec749b7befe64af66476ff7bf7b2db8d,adee638e91b035a058f7d05d004c3c93

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of conversion codes to add (maxmimum number of conversion codes: 5)
url_idID	ID of the tracking link to which to add one or more conversion codes

Return values

parameter	description
ids	comma-separated list of added conversion codes

/urls/conversions/list

access: [READ]

This method returns a list of conversion codes linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=a9bd4b698a35ba3f646ba8a005d0e83b

Query parameters

fields = count,name,id,enable_postback_url,actual_url_params
url_id = a9bd4b698a35ba3f646ba8a005d0e83b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3,
    "data": [
      {
        "name": "conversion name 1",
        "id": "c1dfb65463491c6615166c5540421d9b",
        "enable_postback_url": 0,
        "actual_url_params": ""
      },
      {
        "name": "conversion name 2 (with postback URL enabled)",
        "id": "a9d5349b514a3c460487b3c2ef988195",
        "enable_postback_url": 1,
        "actual_url_params": "subid1={:CLICK_ID:}"
      },
      {
        "name": "conversion name 3",
        "id": "324bd0f4d5fd991a5a08c473c541ca05",
        "enable_postback_url": 0,
        "actual_url_params": ""
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=a9bd4b698a35ba3f646ba8a005d0e83b&format=xml

Query parameters

fields = count,name,id,enable_postback_url,actual_url_params
url_id = a9bd4b698a35ba3f646ba8a005d0e83b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
    <data>
      <i0>
        <name>conversion name 1</name>  
        <id>c1dfb65463491c6615166c5540421d9b</id>  
        <enable_postback_url>0</enable_postback_url>  
        <actual_url_params></actual_url_params>  
      </i0>  
      <i1>
        <name>conversion name 2 (with postback URL enabled)</name>  
        <id>a9d5349b514a3c460487b3c2ef988195</id>  
        <enable_postback_url>1</enable_postback_url>  
        <actual_url_params>subid1={:CLICK_ID:}</actual_url_params>  
      </i1>  
      <i2>
        <name>conversion name 3</name>  
        <id>324bd0f4d5fd991a5a08c473c541ca05</id>  
        <enable_postback_url>0</enable_postback_url>  
        <actual_url_params></actual_url_params>  
      </i2>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=a9bd4b698a35ba3f646ba8a005d0e83b&format=txt

Query parameters

fields = count,name,id,enable_postback_url,actual_url_params
url_id = a9bd4b698a35ba3f646ba8a005d0e83b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
result_data_0_name=conversion name 1
result_data_0_id=c1dfb65463491c6615166c5540421d9b
result_data_0_enable_postback_url=0
result_data_0_actual_url_params=
result_data_1_name=conversion name 2 (with postback URL enabled)
result_data_1_id=a9d5349b514a3c460487b3c2ef988195
result_data_1_enable_postback_url=1
result_data_1_actual_url_params=subid1={:CLICK_ID:}
result_data_2_name=conversion name 3
result_data_2_id=324bd0f4d5fd991a5a08c473c541ca05
result_data_2_enable_postback_url=0
result_data_2_actual_url_params=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=a9bd4b698a35ba3f646ba8a005d0e83b&format=plain

Query parameters

fields = count,name,id,enable_postback_url,actual_url_params
url_id = a9bd4b698a35ba3f646ba8a005d0e83b
format = plain

Response

3
conversion name 1
c1dfb65463491c6615166c5540421d9b
0

conversion name 2 (with postback URL enabled)
a9d5349b514a3c460487b3c2ef988195
1
subid1={:CLICK_ID:}
conversion name 3
324bd0f4d5fd991a5a08c473c541ca05
0

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, name, notes, enable_postback_url, actual_url_params, postback_url_params
url_idID	ID of the liked tracking link

Optional parameters

parameter	description
lengthINTEGER	extracts this number of conversion codes (maxmimum allowed: 100)
orderbyARRAY	orders conversion codes by field, available fields: id, name, notes, enable_postback_url, actual_url_params, postback_url_params
searchSTRING	filters conversion codes to be extracted by searching them
sortSTRING	sorts conversion codes in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract conversion codes from this position

Return values

parameter	description
count	[OPTIONAL] total number of conversion codes, returned only if count is passed in fields
data	array containing information on the conversion codes, returned information depends on the fields parameter.

/urls/count

access: [READ]

This method returns the number of user's urls.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/count?project_id=16f12d94c0061ac1740a1e7413d14f98

Query parameters

project_id = 16f12d94c0061ac1740a1e7413d14f98

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3064
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/count?project_id=16f12d94c0061ac1740a1e7413d14f98&format=xml

Query parameters

project_id = 16f12d94c0061ac1740a1e7413d14f98
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3064</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/count?project_id=16f12d94c0061ac1740a1e7413d14f98&format=txt

Query parameters

project_id = 16f12d94c0061ac1740a1e7413d14f98
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3064

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/count?project_id=16f12d94c0061ac1740a1e7413d14f98&format=plain

Query parameters

project_id = 16f12d94c0061ac1740a1e7413d14f98
    format = plain

Response

Optional parameters

parameter	description
end_dateDATE	see i1/urls/list for details
filterSTRING	see i1/urls/list for details
optionSTRING	see i1/urls/list for details
project_idID	see i1/urls/list for details
searchSTRING	see i1/urls/list for details
start_dateDATE	see i1/urls/list for details
whereSTRING	see i1/urls/list for details
with_alertsBOOLEAN	see i1/urls/list for details

Return values

parameter	description
count	total number of tracking links

/urls/ctas

/urls/ctas/clone

access: [WRITE]

Clone the CTA configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/clone?from_url_id=1beb2fb415cff3309549c4b211602ab1&to_url_id=857bf05dcfb467d3c9c6cbbefe8c4fac

Query parameters

from_url_id = 1beb2fb415cff3309549c4b211602ab1
  to_url_id = 857bf05dcfb467d3c9c6cbbefe8c4fac

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/clone?from_url_id=1beb2fb415cff3309549c4b211602ab1&to_url_id=857bf05dcfb467d3c9c6cbbefe8c4fac&format=xml

Query parameters

from_url_id = 1beb2fb415cff3309549c4b211602ab1
  to_url_id = 857bf05dcfb467d3c9c6cbbefe8c4fac
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/clone?from_url_id=1beb2fb415cff3309549c4b211602ab1&to_url_id=857bf05dcfb467d3c9c6cbbefe8c4fac&format=txt

Query parameters

from_url_id = 1beb2fb415cff3309549c4b211602ab1
  to_url_id = 857bf05dcfb467d3c9c6cbbefe8c4fac
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/clone?from_url_id=1beb2fb415cff3309549c4b211602ab1&to_url_id=857bf05dcfb467d3c9c6cbbefe8c4fac&format=plain

Query parameters

from_url_id = 1beb2fb415cff3309549c4b211602ab1
  to_url_id = 857bf05dcfb467d3c9c6cbbefe8c4fac
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the CTA configuration from
to_url_idID	ID of the tracking link you want to copy the CTA configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/ctas/delete

access: [WRITE]

Unset a call to action for a short URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/delete?url_id=62fca235ebc9da83daddfdcf61a1d8f4

Query parameters

url_id = 62fca235ebc9da83daddfdcf61a1d8f4

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/delete?url_id=62fca235ebc9da83daddfdcf61a1d8f4&format=xml

Query parameters

url_id = 62fca235ebc9da83daddfdcf61a1d8f4
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/delete?url_id=62fca235ebc9da83daddfdcf61a1d8f4&format=txt

Query parameters

url_id = 62fca235ebc9da83daddfdcf61a1d8f4
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/delete?url_id=62fca235ebc9da83daddfdcf61a1d8f4&format=plain

Query parameters

url_id = 62fca235ebc9da83daddfdcf61a1d8f4
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link from which to remove the CTA

Optional parameters

parameter	description
idID	ID of the CTA to remove

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/ctas/edit

access: [WRITE]

Set a call to action for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/edit?url_id=2ad98372aa8ee06b8f985c55c348210b&id=a92ccdf458158fd9dcfb9b8d4086481f

Query parameters

url_id = 2ad98372aa8ee06b8f985c55c348210b
    id = a92ccdf458158fd9dcfb9b8d4086481f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/edit?url_id=2ad98372aa8ee06b8f985c55c348210b&id=a92ccdf458158fd9dcfb9b8d4086481f&format=xml

Query parameters

url_id = 2ad98372aa8ee06b8f985c55c348210b
    id = a92ccdf458158fd9dcfb9b8d4086481f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/edit?url_id=2ad98372aa8ee06b8f985c55c348210b&id=a92ccdf458158fd9dcfb9b8d4086481f&format=txt

Query parameters

url_id = 2ad98372aa8ee06b8f985c55c348210b
    id = a92ccdf458158fd9dcfb9b8d4086481f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/edit?url_id=2ad98372aa8ee06b8f985c55c348210b&id=a92ccdf458158fd9dcfb9b8d4086481f&format=plain

Query parameters

url_id = 2ad98372aa8ee06b8f985c55c348210b
    id = a92ccdf458158fd9dcfb9b8d4086481f
format = plain

Response

Required parameters

parameter	description
idID	ID of the CTA to associate to the tracking link
url_idID	ID of the tracking link

Return values

parameter	description
added	1 on success, 0 otherwise

/urls/ctas/info

access: [READ]

Get information for a CTA that is linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=0ddff06b367f3a39f81725cdd14fbef3

Query parameters

fields = id,type,name
url_id = 0ddff06b367f3a39f81725cdd14fbef3

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "572bb1c77d6c2c53c9ce420550ba87dc",
    "type": "button",
    "name": "this is a button CTA"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=0ddff06b367f3a39f81725cdd14fbef3&format=xml

Query parameters

fields = id,type,name
url_id = 0ddff06b367f3a39f81725cdd14fbef3
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>572bb1c77d6c2c53c9ce420550ba87dc</id>  
    <type>button</type>  
    <name>this is a button CTA</name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=0ddff06b367f3a39f81725cdd14fbef3&format=txt

Query parameters

fields = id,type,name
url_id = 0ddff06b367f3a39f81725cdd14fbef3
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=572bb1c77d6c2c53c9ce420550ba87dc
result_type=button
result_name=this is a button CTA

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=0ddff06b367f3a39f81725cdd14fbef3&format=plain

Query parameters

fields = id,type,name
url_id = 0ddff06b367f3a39f81725cdd14fbef3
format = plain

Response

572bb1c77d6c2c53c9ce420550ba87dc
button
this is a button CTA

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: id, type, name
url_idID	ID of the liked tracking link

Return values

parameter	description
id	[OPTIONAL] ID of the CTA, only if id is passed in fields
name	[OPTIONAL] name of the CTA, only if name is passed in fields
type	[OPTIONAL] type of the CTA, only if type is passed in fields

/urls/ctas/previews

/urls/ctas/previews/check

access: [WRITE]

Check if a page preview is associated with a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/previews/check?url_id=4809f3e8f582b670808a2b7e475cbfcd

Query parameters

url_id = 4809f3e8f582b670808a2b7e475cbfcd

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/previews/check?url_id=4809f3e8f582b670808a2b7e475cbfcd&format=xml

Query parameters

url_id = 4809f3e8f582b670808a2b7e475cbfcd
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/previews/check?url_id=4809f3e8f582b670808a2b7e475cbfcd&format=txt

Query parameters

url_id = 4809f3e8f582b670808a2b7e475cbfcd
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/previews/check?url_id=4809f3e8f582b670808a2b7e475cbfcd&format=plain

Query parameters

url_id = 4809f3e8f582b670808a2b7e475cbfcd
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link

Return values

parameter	description
enabled	1 if a page preview is associated with the tracking link, 0 otherwise

/urls/ctas/previews/extract

access: [WRITE]

Extract a page preview for the destination URL of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=dc1a81a3b94655d4af58b3e3df30882b

Query parameters

url_id = dc1a81a3b94655d4af58b3e3df30882b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "extracted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=dc1a81a3b94655d4af58b3e3df30882b&format=xml

Query parameters

url_id = dc1a81a3b94655d4af58b3e3df30882b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <extracted>1</extracted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=dc1a81a3b94655d4af58b3e3df30882b&format=txt

Query parameters

url_id = dc1a81a3b94655d4af58b3e3df30882b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_extracted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=dc1a81a3b94655d4af58b3e3df30882b&format=plain

Query parameters

url_id = dc1a81a3b94655d4af58b3e3df30882b
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link

Optional parameters

parameter	description
aiBOOLEAN	1 to enable the AI extraction, default value `ai = 0`

Return values

parameter	description
extracted	1 on success, 0 otherwise

/urls/ctas/previews/info

access: [READ]

Return a page preview info for the destination URL of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/previews/info?url_id=95a3fecc4a7d723fc1af189ed9beb8bd

Query parameters

url_id = 95a3fecc4a7d723fc1af189ed9beb8bd

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "info": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/previews/info?url_id=95a3fecc4a7d723fc1af189ed9beb8bd&format=xml

Query parameters

url_id = 95a3fecc4a7d723fc1af189ed9beb8bd
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <info>1</info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/previews/info?url_id=95a3fecc4a7d723fc1af189ed9beb8bd&format=txt

Query parameters

url_id = 95a3fecc4a7d723fc1af189ed9beb8bd
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_info=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/previews/info?url_id=95a3fecc4a7d723fc1af189ed9beb8bd&format=plain

Query parameters

url_id = 95a3fecc4a7d723fc1af189ed9beb8bd
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link

Return values

parameter	description
info	1 on success, 0 otherwise

/urls/ctas/previews/preview

access: [WRITE]

Return a page preview HTML for the destination URL of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=c51b729fc62206bc39c8db4e6e74a05d

Query parameters

url_id = c51b729fc62206bc39c8db4e6e74a05d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "html": "<html><body>...<\/body><\/html>"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=c51b729fc62206bc39c8db4e6e74a05d&format=xml

Query parameters

url_id = c51b729fc62206bc39c8db4e6e74a05d
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <html><[CDATA[&lt;html&gt;&lt;body&gt;...&lt;/body&gt;&lt;/html&gt;]]></html>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=c51b729fc62206bc39c8db4e6e74a05d&format=txt

Query parameters

url_id = c51b729fc62206bc39c8db4e6e74a05d
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_html=&lt;html&gt;&lt;body&gt;...&lt;/body&gt;&lt;/html&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=c51b729fc62206bc39c8db4e6e74a05d&format=plain

Query parameters

url_id = c51b729fc62206bc39c8db4e6e74a05d
format = plain

Response

&lt;html&gt;&lt;body&gt;...&lt;/body&gt;&lt;/html&gt;

Required parameters

parameter	description
url_idID	ID of the tracking link

Optional parameters

parameter	description
return_htmlBOOLEAN	1 to return HTML, 0 to return JSON containing the `html` field, default value `return_html = 0`

Return values

parameter	description
[BINARY DATA]	[OPTIONAL] raw HTML content for the page preview, returned if `return_html = 1`
html	[OPTIONAL] HTML for the page preview, returned if `return_html = 0`

/urls/deeplinks

/urls/deeplinks/al

access: [READ]

Extract App Links information from a given URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F

Query parameters

url = https://www.facebook.com/groups/1234567890/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "android": {
      "app_name": "Facebook",
      "package": "com.facebook.katana",
      "uri_scheme": "fb:\/\/group\/1234567890"
    },
    "ios": {
      "app_name": "Facebook",
      "app_store_id": "284882215",
      "uri_scheme": "fb:\/\/group\/?id=1234567890"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F&format=xml

Query parameters

   url = https://www.facebook.com/groups/1234567890/
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <android>
      <app_name>Facebook</app_name>  
      <package>com.facebook.katana</package>  
      <uri_scheme>fb://group/1234567890</uri_scheme>  
    </android>  
    <ios>
      <app_name>Facebook</app_name>  
      <app_store_id>284882215</app_store_id>  
      <uri_scheme>fb://group/?id=1234567890</uri_scheme>  
    </ios>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F&format=txt

Query parameters

   url = https://www.facebook.com/groups/1234567890/
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_android_app_name=Facebook
result_android_package=com.facebook.katana
result_android_uri_scheme=fb://group/1234567890
result_ios_app_name=Facebook
result_ios_app_store_id=284882215
result_ios_uri_scheme=fb://group/?id=1234567890

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F&format=plain

Query parameters

   url = https://www.facebook.com/groups/1234567890/
format = plain

Response

Facebook
com.facebook.katana
fb://group/1234567890
Facebook
284882215
fb://group/?id=1234567890

Required parameters

parameter	description
urlSTRING	URL to be scraped

Return values

parameter	description
data	Extracted App Link tags

/urls/deeplinks/clone

access: [WRITE]

Clone the deep link configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=87ee6bd942ad0349e9662f33afd42707&to_url_id=155d198177d7688b0f331607e0890712

Query parameters

from_url_id = 87ee6bd942ad0349e9662f33afd42707
  to_url_id = 155d198177d7688b0f331607e0890712

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=87ee6bd942ad0349e9662f33afd42707&to_url_id=155d198177d7688b0f331607e0890712&format=xml

Query parameters

from_url_id = 87ee6bd942ad0349e9662f33afd42707
  to_url_id = 155d198177d7688b0f331607e0890712
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=87ee6bd942ad0349e9662f33afd42707&to_url_id=155d198177d7688b0f331607e0890712&format=txt

Query parameters

from_url_id = 87ee6bd942ad0349e9662f33afd42707
  to_url_id = 155d198177d7688b0f331607e0890712
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=87ee6bd942ad0349e9662f33afd42707&to_url_id=155d198177d7688b0f331607e0890712&format=plain

Query parameters

from_url_id = 87ee6bd942ad0349e9662f33afd42707
  to_url_id = 155d198177d7688b0f331607e0890712
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the deep link configuration from
to_url_idID	ID of the tracking link you want to the deep link configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/deeplinks/delete

access: [WRITE]

Unset (delete) a deep link for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/delete?id=a3efd89daa0aac26a114404a7892ee30

Query parameters

id = a3efd89daa0aac26a114404a7892ee30

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/delete?id=a3efd89daa0aac26a114404a7892ee30&format=xml

Query parameters

    id = a3efd89daa0aac26a114404a7892ee30
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/delete?id=a3efd89daa0aac26a114404a7892ee30&format=txt

Query parameters

    id = a3efd89daa0aac26a114404a7892ee30
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/delete?id=a3efd89daa0aac26a114404a7892ee30&format=plain

Query parameters

    id = a3efd89daa0aac26a114404a7892ee30
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a deep link configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/deeplinks/edit

access: [WRITE]

Set deep link settings for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/edit?id=2a2413e7eaa83c0a6ea8cb4910ca0ab4

Query parameters

id = 2a2413e7eaa83c0a6ea8cb4910ca0ab4

Post parameters

settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/edit?id=2a2413e7eaa83c0a6ea8cb4910ca0ab4&format=xml

Query parameters

    id = 2a2413e7eaa83c0a6ea8cb4910ca0ab4
format = xml

Post parameters

settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/edit?id=2a2413e7eaa83c0a6ea8cb4910ca0ab4&format=txt

Query parameters

    id = 2a2413e7eaa83c0a6ea8cb4910ca0ab4
format = txt

Post parameters

settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/edit?id=2a2413e7eaa83c0a6ea8cb4910ca0ab4&format=plain

Query parameters

    id = 2a2413e7eaa83c0a6ea8cb4910ca0ab4
format = plain

Post parameters

settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D

Response

Required parameters

parameter	description
idID	tracking link ID for which you want to edit the app deep link configuration
settingsJSON	stringified JSON of the app deep link configuration, see i1/urls/deeplinks/info for details

Return values

parameter	description
enabled	1 if the app deep link option has been successfully enabled, 0 otherwise

/urls/deeplinks/huawei

/urls/deeplinks/huawei/quickapps

/urls/deeplinks/huawei/quickapps/id2package

access: [READ]

Get the package of a Huawei Quick App from its ID.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890

Query parameters

id = C1234567890

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "package": "com.example.quickapp"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890&format=xml

Query parameters

    id = C1234567890
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <package>com.example.quickapp</package>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890&format=txt

Query parameters

    id = C1234567890
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_package=com.example.quickapp

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890&format=plain

Query parameters

    id = C1234567890
format = plain

Response

com.example.quickapp

Required parameters

parameter	description
idSTRING	ID of a Huawei Quick App

Return values

parameter	description
package	The Huawei Quick App package that matches the passed `id`

/urls/deeplinks/info

access: [READ]

Get a deep link settings for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/info?id=25b7e62bbb49ce3cc733bf5b74ae73c8

Query parameters

id = 25b7e62bbb49ce3cc733bf5b74ae73c8

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "settings": "{\"params\":[{\"key\":\"a\",\"value\":\"b\"},{\"key\":\"c\",\"value\":\"d\"}],\"default_url\":\"https:\\\/\\\/joturl.com\\\/\",\"desktop_settings\":\"default\",\"desktop_redirect_url\":\"\",\"android_redirect_url\":\"\",\"android_settings\":\"deeplink\",\"android_uri_scheme\":\"customUriScheme:\\\/\\\/open\",\"android_package_name\":\"com.joturl.example\",\"android_fallback\":\"redirect\",\"android_fallback_redirect_url\":\"https:\\\/\\\/joturl.com\\\/\",\"ios_settings\":\"default\",\"ios_redirect_url\":\"\",\"ios_uri_scheme\":\"\",\"ios_store_url\":\"\",\"ios_fallback\":\"store\",\"ios_fallback_redirect_url\":\"\",\"og_title\":\"\",\"og_description\":\"\",\"og_image\":\"\"}"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/info?id=25b7e62bbb49ce3cc733bf5b74ae73c8&format=xml

Query parameters

    id = 25b7e62bbb49ce3cc733bf5b74ae73c8
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <settings>{"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"default_url":"https:\/\/joturl.com\/","desktop_settings":"default","desktop_redirect_url":"","android_redirect_url":"","android_settings":"deeplink","android_uri_scheme":"customUriScheme:\/\/open","android_package_name":"com.joturl.example","android_fallback":"redirect","android_fallback_redirect_url":"https:\/\/joturl.com\/","ios_settings":"default","ios_redirect_url":"","ios_uri_scheme":"","ios_store_url":"","ios_fallback":"store","ios_fallback_redirect_url":"","og_title":"","og_description":"","og_image":""}</settings>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/info?id=25b7e62bbb49ce3cc733bf5b74ae73c8&format=txt

Query parameters

    id = 25b7e62bbb49ce3cc733bf5b74ae73c8
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_settings={"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"default_url":"https:\/\/joturl.com\/","desktop_settings":"default","desktop_redirect_url":"","android_redirect_url":"","android_settings":"deeplink","android_uri_scheme":"customUriScheme:\/\/open","android_package_name":"com.joturl.example","android_fallback":"redirect","android_fallback_redirect_url":"https:\/\/joturl.com\/","ios_settings":"default","ios_redirect_url":"","ios_uri_scheme":"","ios_store_url":"","ios_fallback":"store","ios_fallback_redirect_url":"","og_title":"","og_description":"","og_image":""}

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/info?id=25b7e62bbb49ce3cc733bf5b74ae73c8&format=plain

Query parameters

    id = 25b7e62bbb49ce3cc733bf5b74ae73c8
format = plain

Response

{"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"default_url":"https:\/\/joturl.com\/","desktop_settings":"default","desktop_redirect_url":"","android_redirect_url":"","android_settings":"deeplink","android_uri_scheme":"customUriScheme:\/\/open","android_package_name":"com.joturl.example","android_fallback":"redirect","android_fallback_redirect_url":"https:\/\/joturl.com\/","ios_settings":"default","ios_redirect_url":"","ios_uri_scheme":"","ios_store_url":"","ios_fallback":"store","ios_fallback_redirect_url":"","og_title":"","og_description":"","og_image":""}

Required parameters

parameter	description
idID	tracking link ID to extract deep link configuration for

Return values

parameter	description
settings	stringified JSON of the deep link configuration

Fields in settings:

params: array of {"key":"","value":""} objects representing custom parameters
default_url: the user will be redirected to this URL in all cases where it will not be possible to automatically open the app or take the user to the store, this URL cannot be changed, it is always the same as the URL to which the tracking link redirects (change the latter if necessary)
desktop_settings: desktop settings, qrcode to show a page with QR a code, default to redirect the user to the URL in default_url, redirect to redirect the user to the URL in desktop_redirect_url
desktop_redirect_url: the URL to be used when desktop_settings = redirect
android_settings: Android settings, default to redirect the user to the URL in default_url, redirect to redirect the user to the URL in android_redirect_url, deeplink to try to bring the user within the app
android_redirect_url: the URL to be used when android_settings = redirect
android_uri_scheme: when android_settings = deeplink, Android URI scheme
android_package_name: when android_settings = deeplink, Android package name
huawei_quickapp_package_name: when android_settings = deeplink, package name of the Quick App on the Huawei AppGallery
huawei_app_id: when android_settings = deeplink, app ID in the Huawei AppGallery
android_fallback: when the custom URI scheme fails, redirects to the Google Play store/Huawei AppGallery if android_fallback = store, redirects to the URL in android_fallback_redirect_url if android_fallback = redirect
android_fallback_redirect_url: the URL to be used when android_fallback = redirect
has_app_link: 1 if the custom domain associated with the tracking link is configured for the Android App Links, 0 otherwise
ios_settings: iOS settings, default to redirect the user to the URL in default_url, redirect to redirect the user to the URL in ios_redirect_url, deeplink to try to bring the user within the app
ios_redirect_url: the URL to be used when ios_settings = redirect
ios_uri_scheme: when ios_settings = deeplink, iOS URI scheme
ios_store_url: when ios_settings = deeplink ,URL of the app on the Apple Store
ios_fallback: when the custom URI scheme fails, redirects to the Apple store if ios_fallback = store, redirects to the URL in ios_fallback_redirect_url if ios_fallback = redirect
ios_fallback_redirect_url: the URL to be used when ios_fallback = redirect
has_universal_link: 1 if the custom domain associated with the tracking link is configured for the Apple Universal Links, 0 otherwise
og_title: Open Graph Title
og_description: Open Graph Description
og_image: Open Graph Image (URL)

Configuration example:

{
    "params": [
        {
            "key": "a",
            "value": "b"
        },
        {
            "key": "c",
            "value": "d"
        }
    ],
    "default_url": "https:\/\/joturl.com\/",
    "desktop_settings": "default",
    "desktop_redirect_url": "",
    "android_redirect_url": "",
    "android_settings": "deeplink",
    "android_uri_scheme": "customUriScheme:\/\/open",
    "android_package_name": "com.joturl.example",
    "android_fallback": "redirect",
    "android_fallback_redirect_url": "https:\/\/joturl.com\/",
    "ios_settings": "default",
    "ios_redirect_url": "",
    "ios_uri_scheme": "",
    "ios_store_url": "",
    "ios_fallback": "store",
    "ios_fallback_redirect_url": "",
    "og_title": "",
    "og_description": "",
    "og_image": ""
}

/urls/deeplinks/og

access: [READ]

Extract Open Graph information from a given URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F

Query parameters

url = https://www.facebook.com/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "site_name": "Facebook",
      "url": "https:\/\/www.facebook.com\/",
      "image": "https:\/\/www.facebook.com\/images\/fb_icon_325x325.png",
      "locale": "en_US",
      "title": "Facebook - Log In or Sign Up",
      "description": "Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates."
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F&format=xml

Query parameters

   url = https://www.facebook.com/
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <site_name>Facebook</site_name>  
      <url>https://www.facebook.com/</url>  
      <image>https://www.facebook.com/images/fb_icon_325x325.png</image>  
      <locale>en_US</locale>  
      <title>Facebook - Log In or Sign Up</title>  
      <description>Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates.</description>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F&format=txt

Query parameters

   url = https://www.facebook.com/
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_site_name=Facebook
result_data_url=https://www.facebook.com/
result_data_image=https://www.facebook.com/images/fb_icon_325x325.png
result_data_locale=en_US
result_data_title=Facebook - Log In or Sign Up
result_data_description=Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates.

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F&format=plain

Query parameters

   url = https://www.facebook.com/
format = plain

Response

Facebook
https://www.facebook.com/
https://www.facebook.com/images/fb_icon_325x325.png
en_US
Facebook - Log In or Sign Up
Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates.

Required parameters

parameter	description
urlSTRING	URL to be scraped

Return values

parameter	description
data	Extracted Open Graph tags

/urls/deeplinks/templates

/urls/deeplinks/templates/add

access: [WRITE]

Add an app deep link templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/add?name=template+name&domains%5B0%5D=a2864fac0ce8bcc3142b61c983872df3&domains%5B1%5D=d1f47163bb412fa0bfcbdf7b100e3a5c&domains%5B2%5D=c50ac661f01a233cfe85568a41d0dae1&configuration=%7B%22params%22%3A1,%22android%22%3A0,%22ios%22%3A0,%22og%22%3A1%7D&settings=%7B%22params%22%3A%5B%7B%22key%22%3A%22a%22,%22value%22%3A%22b%22%7D,%7B%22key%22%3A%22c%22,%22value%22%3A%22d%22%7D%5D,%22...%22%3A%22...%22,%22og_title%22%3A%22%22,%22og_description%22%3A%22%22,%22og_image%22%3A%22%22%7D

Query parameters

         name = template name
   domains[0] = a2864fac0ce8bcc3142b61c983872df3
   domains[1] = d1f47163bb412fa0bfcbdf7b100e3a5c
   domains[2] = c50ac661f01a233cfe85568a41d0dae1
configuration = {"params":1,"android":0,"ios":0,"og":1}
     settings = {"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"...":"...","og_title":"","og_description":"","og_image":""}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "843b7e9bd84dbc1207e768e8b769ecda",
    "name": "template name",
    "domains": [
      "a2864fac0ce8bcc3142b61c983872df3",
      "d1f47163bb412fa0bfcbdf7b100e3a5c",
      "c50ac661f01a233cfe85568a41d0dae1"
    ],
    "configuration": {
      "params": 1,
      "android": 0,
      "ios": 0,
      "og": 1
    },
    "settings": {
      "params": [
        {
          "key": "a",
          "value": "b"
        },
        {
          "key": "c",
          "value": "d"
        }
      ],
      ...: "...",
      "og_title": "",
      "og_description": "",
      "og_image": ""
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/add?name=template+name&domains%5B0%5D=a2864fac0ce8bcc3142b61c983872df3&domains%5B1%5D=d1f47163bb412fa0bfcbdf7b100e3a5c&domains%5B2%5D=c50ac661f01a233cfe85568a41d0dae1&configuration=%7B%22params%22%3A1,%22android%22%3A0,%22ios%22%3A0,%22og%22%3A1%7D&settings=%7B%22params%22%3A%5B%7B%22key%22%3A%22a%22,%22value%22%3A%22b%22%7D,%7B%22key%22%3A%22c%22,%22value%22%3A%22d%22%7D%5D,%22...%22%3A%22...%22,%22og_title%22%3A%22%22,%22og_description%22%3A%22%22,%22og_image%22%3A%22%22%7D&format=xml

Query parameters

         name = template name
   domains[0] = a2864fac0ce8bcc3142b61c983872df3
   domains[1] = d1f47163bb412fa0bfcbdf7b100e3a5c
   domains[2] = c50ac661f01a233cfe85568a41d0dae1
configuration = {"params":1,"android":0,"ios":0,"og":1}
     settings = {"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"...":"...","og_title":"","og_description":"","og_image":""}
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>843b7e9bd84dbc1207e768e8b769ecda</id>  
    <name>template name</name>  
    <domains>
      <i0>a2864fac0ce8bcc3142b61c983872df3</i0>  
      <i1>d1f47163bb412fa0bfcbdf7b100e3a5c</i1>  
      <i2>c50ac661f01a233cfe85568a41d0dae1</i2>  
    </domains>  
    <configuration>
      <params>1</params>  
      <android>0</android>  
      <ios>0</ios>  
      <og>1</og>  
    </configuration>  
    <settings>
      <params>
        <i0>
          <key>a</key>  
          <value>b</value>  
        </i0>  
        <i1>
          <key>c</key>  
          <value>d</value>  
        </i1>  
      </params>  
      <...>...</...>  
      <og_title></og_title>  
      <og_description></og_description>  
      <og_image></og_image>  
    </settings>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/add?name=template+name&domains%5B0%5D=a2864fac0ce8bcc3142b61c983872df3&domains%5B1%5D=d1f47163bb412fa0bfcbdf7b100e3a5c&domains%5B2%5D=c50ac661f01a233cfe85568a41d0dae1&configuration=%7B%22params%22%3A1,%22android%22%3A0,%22ios%22%3A0,%22og%22%3A1%7D&settings=%7B%22params%22%3A%5B%7B%22key%22%3A%22a%22,%22value%22%3A%22b%22%7D,%7B%22key%22%3A%22c%22,%22value%22%3A%22d%22%7D%5D,%22...%22%3A%22...%22,%22og_title%22%3A%22%22,%22og_description%22%3A%22%22,%22og_image%22%3A%22%22%7D&format=txt

Query parameters

         name = template name
   domains[0] = a2864fac0ce8bcc3142b61c983872df3
   domains[1] = d1f47163bb412fa0bfcbdf7b100e3a5c
   domains[2] = c50ac661f01a233cfe85568a41d0dae1
configuration = {"params":1,"android":0,"ios":0,"og":1}
     settings = {"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"...":"...","og_title":"","og_description":"","og_image":""}
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=843b7e9bd84dbc1207e768e8b769ecda
result_name=template name
result_domains_0=a2864fac0ce8bcc3142b61c983872df3
result_domains_1=d1f47163bb412fa0bfcbdf7b100e3a5c
result_domains_2=c50ac661f01a233cfe85568a41d0dae1
result_configuration_params=1
result_configuration_android=0
result_configuration_ios=0
result_configuration_og=1
result_settings_params_0_key=a
result_settings_params_0_value=b
result_settings_params_1_key=c
result_settings_params_1_value=d
result_settings_...=...
result_settings_og_title=
result_settings_og_description=
result_settings_og_image=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/add?name=template+name&domains%5B0%5D=a2864fac0ce8bcc3142b61c983872df3&domains%5B1%5D=d1f47163bb412fa0bfcbdf7b100e3a5c&domains%5B2%5D=c50ac661f01a233cfe85568a41d0dae1&configuration=%7B%22params%22%3A1,%22android%22%3A0,%22ios%22%3A0,%22og%22%3A1%7D&settings=%7B%22params%22%3A%5B%7B%22key%22%3A%22a%22,%22value%22%3A%22b%22%7D,%7B%22key%22%3A%22c%22,%22value%22%3A%22d%22%7D%5D,%22...%22%3A%22...%22,%22og_title%22%3A%22%22,%22og_description%22%3A%22%22,%22og_image%22%3A%22%22%7D&format=plain

Query parameters

         name = template name
   domains[0] = a2864fac0ce8bcc3142b61c983872df3
   domains[1] = d1f47163bb412fa0bfcbdf7b100e3a5c
   domains[2] = c50ac661f01a233cfe85568a41d0dae1
configuration = {"params":1,"android":0,"ios":0,"og":1}
     settings = {"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"...":"...","og_title":"","og_description":"","og_image":""}
       format = plain

Response

843b7e9bd84dbc1207e768e8b769ecda
template name
a2864fac0ce8bcc3142b61c983872df3
d1f47163bb412fa0bfcbdf7b100e3a5c
c50ac661f01a233cfe85568a41d0dae1
1
0
0
1
a
b
c
d
...

Required parameters

parameter	description	max length
configurationJSON	template configuration, see notes for details
nameSTRING	template name to add	255
settingsJSON	stringified JSON of the app deep link settings, see i1/urls/deeplinks/info for details

Optional parameters

parameter	description
domainsARRAY_OF_IDS	domains IDs associated to the template, the max number of allowed domains is: 10

Return values

parameter	description
configuration	the app deep link template configuration
domains	the list of domain IDs associated with the app deep link template
hosts	the list of domain hosts associated with the app deep link template
id	ID of the app deep link template
name	the template name that was just added
settings	the app deep link settings of the template

/urls/deeplinks/templates/count

access: [READ]

This method returns the number of available app deep link templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?format=plain

Query parameters

format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?search=test

Query parameters

search = test

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?search=test&format=xml

Query parameters

search = test
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?search=test&format=txt

Query parameters

search = test
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/count?search=test&format=plain

Query parameters

search = test
format = plain

Response

Optional parameters

parameter	description
searchSTRING	count items by searching them

Return values

parameter	description
count	number of app deep link templates the user has access to (filtered by search if passed)

/urls/deeplinks/templates/delete

access: [WRITE]

Delete an app deep link template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc

Query parameters

ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=xml

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=txt

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=plain

Query parameters

   ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143

Query parameters

ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143",
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=xml

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143</ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=txt

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=plain

Query parameters

   ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = plain

Response

334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of app deep link template IDs to be deleted, max number of IDs in the list: 100

Return values

parameter	description
deleted	1 if the deletion was successful, 0 otherwise

/urls/deeplinks/templates/edit

access: [WRITE]

Edit an app deep link template configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/edit?id=e90bbea7152b1b004edb17b454d2ce52&name=new+template+name

Query parameters

  id = e90bbea7152b1b004edb17b454d2ce52
name = new template name

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "e90bbea7152b1b004edb17b454d2ce52",
    "name": "new template name"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/edit?id=e90bbea7152b1b004edb17b454d2ce52&name=new+template+name&format=xml

Query parameters

    id = e90bbea7152b1b004edb17b454d2ce52
  name = new template name
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>e90bbea7152b1b004edb17b454d2ce52</id>  
    <name>new template name</name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/edit?id=e90bbea7152b1b004edb17b454d2ce52&name=new+template+name&format=txt

Query parameters

    id = e90bbea7152b1b004edb17b454d2ce52
  name = new template name
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=e90bbea7152b1b004edb17b454d2ce52
result_name=new template name

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/edit?id=e90bbea7152b1b004edb17b454d2ce52&name=new+template+name&format=plain

Query parameters

    id = e90bbea7152b1b004edb17b454d2ce52
  name = new template name
format = plain

Response

e90bbea7152b1b004edb17b454d2ce52
new template name

Required parameters

parameter	description
idID	ID of the app deep link template configuration

Optional parameters

parameter	description	max length
configurationJSON	new template configuration, see i1/urls/deeplinks/templates/add for details
domainsARRAY_OF_IDS	new list of domain IDs to be associated to the template, the max number of allowed domains is: 10
nameSTRING	new template name	255
settingsJSON	new stringified JSON of the app deep link settings, see i1/urls/deeplinks/info for details

Return values

parameter	description
configuration	the app deep link template configuration
domains	the list of domain IDs associated with the app deep link template
hosts	the list of domain hosts associated with the app deep link template
id	ID of the app deep link template
name	the template name that was just added
settings	the app deep link settings of the template

/urls/deeplinks/templates/info

access: [READ]

This method returns information on the app deep link configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/info?id=dfb391c596f958a5bd5e0ea6b91bf90f&fields=id,name,settings,domains,configuration

Query parameters

    id = dfb391c596f958a5bd5e0ea6b91bf90f
fields = id,name,settings,domains,configuration

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "dfb391c596f958a5bd5e0ea6b91bf90f",
    "name": "template name",
    "domains": [
      "3cb7768911c5ccd018a64a712964a385",
      "8acc9b0295c6d77b5fbbd02125d98c56",
      "baf85f4f3569a524283750764f060bf6",
      "de0c27c72a536fe6890e25e21b1de062"
    ],
    "hosts": [
      "0.example.com",
      "1.example.com",
      "2.example.com",
      "3.example.com"
    ],
    "settings": {
      "params": [
        {
          "key": "a",
          "value": "b"
        },
        {
          "key": "c",
          "value": "d"
        }
      ],
      ...: "...",
      "og_title": "",
      "og_description": "",
      "og_image": ""
    },
    "configuration": {
      "params": 1,
      "android": 0,
      "ios": 0,
      "og": 1
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/info?id=dfb391c596f958a5bd5e0ea6b91bf90f&fields=id,name,settings,domains,configuration&format=xml

Query parameters

    id = dfb391c596f958a5bd5e0ea6b91bf90f
fields = id,name,settings,domains,configuration
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>dfb391c596f958a5bd5e0ea6b91bf90f</id>  
    <name>template name</name>  
    <domains>
      <i0>3cb7768911c5ccd018a64a712964a385</i0>  
      <i1>8acc9b0295c6d77b5fbbd02125d98c56</i1>  
      <i2>baf85f4f3569a524283750764f060bf6</i2>  
      <i3>de0c27c72a536fe6890e25e21b1de062</i3>  
    </domains>  
    <hosts>
      <i0>0.example.com</i0>  
      <i1>1.example.com</i1>  
      <i2>2.example.com</i2>  
      <i3>3.example.com</i3>  
    </hosts>  
    <settings>
      <params>
        <i0>
          <key>a</key>  
          <value>b</value>  
        </i0>  
        <i1>
          <key>c</key>  
          <value>d</value>  
        </i1>  
      </params>  
      <...>...</...>  
      <og_title></og_title>  
      <og_description></og_description>  
      <og_image></og_image>  
    </settings>  
    <configuration>
      <params>1</params>  
      <android>0</android>  
      <ios>0</ios>  
      <og>1</og>  
    </configuration>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/info?id=dfb391c596f958a5bd5e0ea6b91bf90f&fields=id,name,settings,domains,configuration&format=txt

Query parameters

    id = dfb391c596f958a5bd5e0ea6b91bf90f
fields = id,name,settings,domains,configuration
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=dfb391c596f958a5bd5e0ea6b91bf90f
result_name=template name
result_domains_0=3cb7768911c5ccd018a64a712964a385
result_domains_1=8acc9b0295c6d77b5fbbd02125d98c56
result_domains_2=baf85f4f3569a524283750764f060bf6
result_domains_3=de0c27c72a536fe6890e25e21b1de062
result_hosts_0=0.example.com
result_hosts_1=1.example.com
result_hosts_2=2.example.com
result_hosts_3=3.example.com
result_settings_params_0_key=a
result_settings_params_0_value=b
result_settings_params_1_key=c
result_settings_params_1_value=d
result_settings_...=...
result_settings_og_title=
result_settings_og_description=
result_settings_og_image=
result_configuration_params=1
result_configuration_android=0
result_configuration_ios=0
result_configuration_og=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/info?id=dfb391c596f958a5bd5e0ea6b91bf90f&fields=id,name,settings,domains,configuration&format=plain

Query parameters

    id = dfb391c596f958a5bd5e0ea6b91bf90f
fields = id,name,settings,domains,configuration
format = plain

Response

dfb391c596f958a5bd5e0ea6b91bf90f
template name
3cb7768911c5ccd018a64a712964a385
8acc9b0295c6d77b5fbbd02125d98c56
baf85f4f3569a524283750764f060bf6
de0c27c72a536fe6890e25e21b1de062
0.example.com
1.example.com
2.example.com
3.example.com
a
b
c
d
...



1
0
0
1

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: id, name, settings, domains, configuration
idID	ID of the app deep link template

Return values

parameter	description
configuration	[OPTIONAL] the app deep link template configuration, returned only if `configuration` is passed in `fields`
domains	[OPTIONAL] the list of domain IDs associated with the app deep link template, returned only if `domains` is passed in `fields`
hosts	[OPTIONAL] the list of domain hosts associated with the app deep link template, returned only if `domains` is passed in `fields`
id	[OPTIONAL] ID of the app deep link template, returned only if `id` is passed in `fields`
name	[OPTIONAL] the app deep link template name, returned only if `name` is passed in `fields`
settings	[OPTIONAL] the app deep link settings of the template, returned only if `settings` is passed in `fields`

/urls/deeplinks/templates/list

access: [READ]

This method returns a list of deep link configurations, parameter fields can be used to retrieve specific fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/list?fields=id,name,domains,hosts,configuration,settings,count

Query parameters

fields = id,name,domains,hosts,configuration,settings,count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "id": "a2138615579ff476aad762bf907616f7",
        "name": "template name 1",
        "domains": [
          "f519baa8c8b669d2f25741b89c5a64cf",
          "b9b8906e16a28bce27d9b9d1324d5182",
          "31314d817a0b53e2db6a1792e8aa848a",
          "00a0883996c81bb9419063beedbaec1e"
        ],
        "hosts": [
          "0.example.com",
          "1.example.com",
          "2.example.com",
          "3.example.com"
        ],
        "configuration": {
          "params": 1,
          "android": 0,
          "ios": 0,
          "og": 1
        },
        "settings": {
          "params": [
            {
              "key": "a",
              "value": "b"
            },
            {
              "key": "c",
              "value": "d"
            }
          ],
          ...: "...",
          "og_title": "",
          "og_description": "",
          "og_image": ""
        }
      },
      {
        "id": "abfe5e05a50c04c397cc057256afcbe8",
        "name": "template name 2",
        "domains": [
          "a30449471a09339962270490b0254e4a",
          "95b27153ef568711a4d670a9dba27b79",
          "d8cd4e6f38a002253504717896e8f195",
          "37ba876669f85f40c6ccb86baa7938b6",
          "5ba3eca48a99a3ec6ef95bd841442f3c"
        ],
        "hosts": [
          "0.example.com",
          "1.example.com",
          "2.example.com",
          "3.example.com",
          "4.example.com"
        ],
        "configuration": {
          "params": 1,
          "android": 1,
          "ios": 1,
          "og": 1
        },
        "settings": {
          "params": [
            {
              "key": "e",
              "value": "f"
            },
            {
              "key": "g",
              "value": "h"
            }
          ],
          ...: "...",
          "og_title": "",
          "og_description": "",
          "og_image": ""
        }
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/list?fields=id,name,domains,hosts,configuration,settings,count&format=xml

Query parameters

fields = id,name,domains,hosts,configuration,settings,count
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <id>a2138615579ff476aad762bf907616f7</id>  
        <name>template name 1</name>  
        <domains>
          <i0>f519baa8c8b669d2f25741b89c5a64cf</i0>  
          <i1>b9b8906e16a28bce27d9b9d1324d5182</i1>  
          <i2>31314d817a0b53e2db6a1792e8aa848a</i2>  
          <i3>00a0883996c81bb9419063beedbaec1e</i3>  
        </domains>  
        <hosts>
          <i0>0.example.com</i0>  
          <i1>1.example.com</i1>  
          <i2>2.example.com</i2>  
          <i3>3.example.com</i3>  
        </hosts>  
        <configuration>
          <params>1</params>  
          <android>0</android>  
          <ios>0</ios>  
          <og>1</og>  
        </configuration>  
        <settings>
          <params>
            <i0>
              <key>a</key>  
              <value>b</value>  
            </i0>  
            <i1>
              <key>c</key>  
              <value>d</value>  
            </i1>  
          </params>  
          <...>...</...>  
          <og_title></og_title>  
          <og_description></og_description>  
          <og_image></og_image>  
        </settings>  
      </i0>  
      <i1>
        <id>abfe5e05a50c04c397cc057256afcbe8</id>  
        <name>template name 2</name>  
        <domains>
          <i0>a30449471a09339962270490b0254e4a</i0>  
          <i1>95b27153ef568711a4d670a9dba27b79</i1>  
          <i2>d8cd4e6f38a002253504717896e8f195</i2>  
          <i3>37ba876669f85f40c6ccb86baa7938b6</i3>  
          <i4>5ba3eca48a99a3ec6ef95bd841442f3c</i4>  
        </domains>  
        <hosts>
          <i0>0.example.com</i0>  
          <i1>1.example.com</i1>  
          <i2>2.example.com</i2>  
          <i3>3.example.com</i3>  
          <i4>4.example.com</i4>  
        </hosts>  
        <configuration>
          <params>1</params>  
          <android>1</android>  
          <ios>1</ios>  
          <og>1</og>  
        </configuration>  
        <settings>
          <params>
            <i0>
              <key>e</key>  
              <value>f</value>  
            </i0>  
            <i1>
              <key>g</key>  
              <value>h</value>  
            </i1>  
          </params>  
          <...>...</...>  
          <og_title></og_title>  
          <og_description></og_description>  
          <og_image></og_image>  
        </settings>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/list?fields=id,name,domains,hosts,configuration,settings,count&format=txt

Query parameters

fields = id,name,domains,hosts,configuration,settings,count
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=a2138615579ff476aad762bf907616f7
result_data_0_name=template name 1
result_data_0_domains_0=f519baa8c8b669d2f25741b89c5a64cf
result_data_0_domains_1=b9b8906e16a28bce27d9b9d1324d5182
result_data_0_domains_2=31314d817a0b53e2db6a1792e8aa848a
result_data_0_domains_3=00a0883996c81bb9419063beedbaec1e
result_data_0_hosts_0=0.example.com
result_data_0_hosts_1=1.example.com
result_data_0_hosts_2=2.example.com
result_data_0_hosts_3=3.example.com
result_data_0_configuration_params=1
result_data_0_configuration_android=0
result_data_0_configuration_ios=0
result_data_0_configuration_og=1
result_data_0_settings_params_0_key=a
result_data_0_settings_params_0_value=b
result_data_0_settings_params_1_key=c
result_data_0_settings_params_1_value=d
result_data_0_settings_...=...
result_data_0_settings_og_title=
result_data_0_settings_og_description=
result_data_0_settings_og_image=
result_data_1_id=abfe5e05a50c04c397cc057256afcbe8
result_data_1_name=template name 2
result_data_1_domains_0=a30449471a09339962270490b0254e4a
result_data_1_domains_1=95b27153ef568711a4d670a9dba27b79
result_data_1_domains_2=d8cd4e6f38a002253504717896e8f195
result_data_1_domains_3=37ba876669f85f40c6ccb86baa7938b6
result_data_1_domains_4=5ba3eca48a99a3ec6ef95bd841442f3c
result_data_1_hosts_0=0.example.com
result_data_1_hosts_1=1.example.com
result_data_1_hosts_2=2.example.com
result_data_1_hosts_3=3.example.com
result_data_1_hosts_4=4.example.com
result_data_1_configuration_params=1
result_data_1_configuration_android=1
result_data_1_configuration_ios=1
result_data_1_configuration_og=1
result_data_1_settings_params_0_key=e
result_data_1_settings_params_0_value=f
result_data_1_settings_params_1_key=g
result_data_1_settings_params_1_value=h
result_data_1_settings_...=...
result_data_1_settings_og_title=
result_data_1_settings_og_description=
result_data_1_settings_og_image=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/list?fields=id,name,domains,hosts,configuration,settings,count&format=plain

Query parameters

fields = id,name,domains,hosts,configuration,settings,count
format = plain

Response

2
a2138615579ff476aad762bf907616f7
template name 1
f519baa8c8b669d2f25741b89c5a64cf
b9b8906e16a28bce27d9b9d1324d5182
31314d817a0b53e2db6a1792e8aa848a
00a0883996c81bb9419063beedbaec1e
0.example.com
1.example.com
2.example.com
3.example.com
1
0
0
1
a
b
c
d
...



abfe5e05a50c04c397cc057256afcbe8
template name 2
a30449471a09339962270490b0254e4a
95b27153ef568711a4d670a9dba27b79
d8cd4e6f38a002253504717896e8f195
37ba876669f85f40c6ccb86baa7938b6
5ba3eca48a99a3ec6ef95bd841442f3c
0.example.com
1.example.com
2.example.com
3.example.com
4.example.com
1
1
1
1
e
f
g
h
...

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: id, name, settings, domains, configuration

Optional parameters

parameter	description
domain_idID	if this optional parameter is provided, the response is ordered as follows: first, templates associated with that `domain_id`, sorted by template name; next, templates with no associated domains, sorted by template name. Templates associated only with other domains are not included. If `domain_id` is omitted, all templates are returned sorted by template name.
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
orderbyARRAY	orders items by field, available fields: id, name
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	[OPTIONAL] total number of deep link configurations, returned only if count is passed in fields
data	array containing the required information about deep link configurations, if `domain_id` is provided in the input parameters, `domain_id` is added to the output

/urls/deeplinks/templates/urls

/urls/deeplinks/templates/urls/delete

access: [WRITE]

Delete the association between a tracking link and an app deep link template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/delete?url_id=8cc3e6c4b65dd741f2431ed0daca7971

Query parameters

url_id = 8cc3e6c4b65dd741f2431ed0daca7971

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/delete?url_id=8cc3e6c4b65dd741f2431ed0daca7971&format=xml

Query parameters

url_id = 8cc3e6c4b65dd741f2431ed0daca7971
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/delete?url_id=8cc3e6c4b65dd741f2431ed0daca7971&format=txt

Query parameters

url_id = 8cc3e6c4b65dd741f2431ed0daca7971
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/delete?url_id=8cc3e6c4b65dd741f2431ed0daca7971&format=plain

Query parameters

url_id = 8cc3e6c4b65dd741f2431ed0daca7971
format = plain

Response

Required parameters

parameter	description
url_idID	tracking link ID to remove association from the deep link app template

Return values

parameter	description
deleted	1 if the deletion was successful, 0 otherwise

/urls/deeplinks/templates/urls/get

access: [READ]

Get information on the app deep link template associated with a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/get?url_id=13365f2c051d560df1548a6d2c1e7293

Query parameters

url_id = 13365f2c051d560df1548a6d2c1e7293

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "3620874961f699770af7192760a4eabe",
    "name": "associated template name"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/get?url_id=13365f2c051d560df1548a6d2c1e7293&format=xml

Query parameters

url_id = 13365f2c051d560df1548a6d2c1e7293
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>3620874961f699770af7192760a4eabe</id>  
    <name>associated template name</name>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/get?url_id=13365f2c051d560df1548a6d2c1e7293&format=txt

Query parameters

url_id = 13365f2c051d560df1548a6d2c1e7293
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=3620874961f699770af7192760a4eabe
result_name=associated template name

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/get?url_id=13365f2c051d560df1548a6d2c1e7293&format=plain

Query parameters

url_id = 13365f2c051d560df1548a6d2c1e7293
format = plain

Response

3620874961f699770af7192760a4eabe
associated template name

Required parameters

parameter	description
url_idID	tracking link ID from which to extract the app deep link template information

Return values

parameter	description
configuration	[OPTIONAL] see i1/urls/deeplinks/templates/info for details, returned only if there is an association between the tracking ID and an app deep link template
domains	[OPTIONAL] see i1/urls/deeplinks/templates/info for details, returned only if there is an association between the tracking ID and an app deep link template
id	[OPTIONAL] see i1/urls/deeplinks/templates/info for details, returned only if there is an association between the tracking ID and an app deep link template
name	[OPTIONAL] see i1/urls/deeplinks/templates/info for details, returned only if there is an association between the tracking ID and an app deep link template
settings	[OPTIONAL] see i1/urls/deeplinks/templates/info for details, returned only if there is an association between the tracking ID and an app deep link template
url_settings	[OPTIONAL] JSON of the app deep link configuration, see i1/urls/deeplinks/info for details, this is a diff of the differences between the passed settings to endpoint i1/urls/deeplinks/templates/urls/set and the template settings at the time of association (so it does not reflect any changes made to the template after association with the tracking link)

/urls/deeplinks/templates/urls/set

access: [WRITE]

Set the association between a tracking link and an app deep link template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/set?url_id=80e62dd6489d55f652dd2534207f592f&template_id=f9042cd87047150b4669cd9f0e0300fb

Query parameters

     url_id = 80e62dd6489d55f652dd2534207f592f
template_id = f9042cd87047150b4669cd9f0e0300fb

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "set": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/set?url_id=80e62dd6489d55f652dd2534207f592f&template_id=f9042cd87047150b4669cd9f0e0300fb&format=xml

Query parameters

     url_id = 80e62dd6489d55f652dd2534207f592f
template_id = f9042cd87047150b4669cd9f0e0300fb
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <set>1</set>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/set?url_id=80e62dd6489d55f652dd2534207f592f&template_id=f9042cd87047150b4669cd9f0e0300fb&format=txt

Query parameters

     url_id = 80e62dd6489d55f652dd2534207f592f
template_id = f9042cd87047150b4669cd9f0e0300fb
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_set=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/deeplinks/templates/urls/set?url_id=80e62dd6489d55f652dd2534207f592f&template_id=f9042cd87047150b4669cd9f0e0300fb&format=plain

Query parameters

     url_id = 80e62dd6489d55f652dd2534207f592f
template_id = f9042cd87047150b4669cd9f0e0300fb
     format = plain

Response

Required parameters

parameter	description
template_idID	ID of the app deep link template to associate
url_idID	ID of the tracking link to which the app deep link template should be associated

Optional parameters

parameter	description
url_settingsJSON	stringified JSON of the app deep link configuration, see i1/urls/deeplinks/info for details

Return values

parameter	description
set	1 if the association between the tracking link and the app deep link template was successful, 0 otherwise

/urls/delete

access: [WRITE]

This method deletes a set of tracking links by using the parameter ids.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/delete?ids=543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e

Query parameters

ids = 543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/delete?ids=543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e&format=xml

Query parameters

   ids = 543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>3</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/delete?ids=543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e&format=txt

Query parameters

   ids = 543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/delete?ids=543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e&format=plain

Query parameters

   ids = 543bc3b5cf4da5aa10cd06859ffd4c8f,4b72a5b8ae09c672c05bc75b1da2933f,0ae1d1b5af148ad70ed2f2099d52269e
format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/urls/delete?ids=5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd

Query parameters

ids = 5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": [
      "e433fd8129ea4b88943adc67404f44a7",
      "5fd7129bba5ebe3270417e5a530826bd"
    ],
    "deleted": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/delete?ids=5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd&format=xml

Query parameters

   ids = 5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>
      <i0>e433fd8129ea4b88943adc67404f44a7</i0>  
      <i1>5fd7129bba5ebe3270417e5a530826bd</i1>  
    </ids>  
    <deleted>1</deleted>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/delete?ids=5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd&format=txt

Query parameters

   ids = 5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=e433fd8129ea4b88943adc67404f44a7
result_ids_1=5fd7129bba5ebe3270417e5a530826bd
result_deleted=1

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/delete?ids=5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd&format=plain

Query parameters

   ids = 5720cab9cf3db14c4a0fb57ca0fc30ed,e433fd8129ea4b88943adc67404f44a7,5fd7129bba5ebe3270417e5a530826bd
format = plain

Response

e433fd8129ea4b88943adc67404f44a7
5fd7129bba5ebe3270417e5a530826bd
1

Required parameters

parameter	description
idsARRAY_OF_IDS	comma separated list of tracking link IDs to be deleted

Return values

parameter	description
deleted	number of deleted tracking links
ids	[OPTIONAL] list of tracking link IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred

/urls/easydeeplinks

/urls/easydeeplinks/clone

access: [WRITE]

Clone the easy deep link configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=1707f66991063f6f961a8d8e4203ac43&to_url_id=968e6775494a3368dc6618384005aac4

Query parameters

from_url_id = 1707f66991063f6f961a8d8e4203ac43
  to_url_id = 968e6775494a3368dc6618384005aac4

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=1707f66991063f6f961a8d8e4203ac43&to_url_id=968e6775494a3368dc6618384005aac4&format=xml

Query parameters

from_url_id = 1707f66991063f6f961a8d8e4203ac43
  to_url_id = 968e6775494a3368dc6618384005aac4
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=1707f66991063f6f961a8d8e4203ac43&to_url_id=968e6775494a3368dc6618384005aac4&format=txt

Query parameters

from_url_id = 1707f66991063f6f961a8d8e4203ac43
  to_url_id = 968e6775494a3368dc6618384005aac4
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=1707f66991063f6f961a8d8e4203ac43&to_url_id=968e6775494a3368dc6618384005aac4&format=plain

Query parameters

from_url_id = 1707f66991063f6f961a8d8e4203ac43
  to_url_id = 968e6775494a3368dc6618384005aac4
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the easy deep link configuration from
to_url_idID	ID of the tracking link you want to the easy deep link configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/easydeeplinks/delete

access: [WRITE]

Unset (delete) an easy deep link configuration for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/delete?id=2eff4dc8f2f35ae30897909c911cac0b

Query parameters

id = 2eff4dc8f2f35ae30897909c911cac0b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/delete?id=2eff4dc8f2f35ae30897909c911cac0b&format=xml

Query parameters

    id = 2eff4dc8f2f35ae30897909c911cac0b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/delete?id=2eff4dc8f2f35ae30897909c911cac0b&format=txt

Query parameters

    id = 2eff4dc8f2f35ae30897909c911cac0b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/delete?id=2eff4dc8f2f35ae30897909c911cac0b&format=plain

Query parameters

    id = 2eff4dc8f2f35ae30897909c911cac0b
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove an easy deep link configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/easydeeplinks/detect

access: [READ]

Find the app the passed URL is associated with (e.g., Facebook, Instagram).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL

Query parameters

url = https://www.facebook.com/jotURL

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "Facebook",
    "category": "social"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL&format=xml

Query parameters

   url = https://www.facebook.com/jotURL
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>Facebook</name>  
    <category>social</category>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL&format=txt

Query parameters

   url = https://www.facebook.com/jotURL
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=Facebook
result_category=social

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL&format=plain

Query parameters

   url = https://www.facebook.com/jotURL
format = plain

Response

Facebook
social

Optional parameters

parameter	description	max length
urlURL	URL corresponding to the app page	4000

Return values

parameter	description
category	category of the easy deep link provider, if available, supported categories: affiliation, business, entertainment, lifestyle, music, other, shopping, social, travel, unknown, website
name	name of the easy deep link link provider, if available, supported names: Adidas, AliExpress, Amazon, Apartments.com, Apple Maps, Apple Music, Apple Podcast, Best Buy, BlueSky, Booking.com, BrandCycle, Comfrt, Discord, Epic Games Store, Etsy, Expedia, Facebook, Flipkart, Google Docs, Google Maps, Google Sheets, Google Slides, HSN, Howl, IKEA, Instagram, Kaufland, Kickstarter, Kohl's, LINE, LTK, LinkedIn, Macy's, MagicLinks, Mavely, Medium, Mercado Livre, Messenger, Microsoft Excel, Microsoft PowerPoint, Microsoft Word, Netflix, Nordstrom, Nordstrom Rack, OnlyFans, Otto, Pinterest, Poshmark, Product Hunt, QVC, Quora, Reddit, Refersion, SHEIN, Sephora, ShopMy, Shopee, Signal, Skype, Snapchat, Spotify, Steam, Target, Telegram, Temu, The Home Depot, Threads, TikTok, TripAdvisor, Trulia, Twitch TV, Ulta Beauty, Unknown, Viber, Vimeo, Walmart, WhatsApp, X, YouTube, Zendesk Support, Zillow, Zulily, eBay, iFood
real_category	[OPTIONAL] real category of the easy deep link provider, see notes
real_name	[OPTIONAL] real name of the easy deep link provider, see notes

/urls/easydeeplinks/edit

access: [WRITE]

Set an easy deep link settings for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/edit?id=e394812b7dcbe20637831de9945766bb

Query parameters

id = e394812b7dcbe20637831de9945766bb

Post parameters

settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/edit?id=e394812b7dcbe20637831de9945766bb&format=xml

Query parameters

    id = e394812b7dcbe20637831de9945766bb
format = xml

Post parameters

settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/edit?id=e394812b7dcbe20637831de9945766bb&format=txt

Query parameters

    id = e394812b7dcbe20637831de9945766bb
format = txt

Post parameters

settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/edit?id=e394812b7dcbe20637831de9945766bb&format=plain

Query parameters

    id = e394812b7dcbe20637831de9945766bb
format = plain

Post parameters

settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D

Response

Required parameters

parameter	description
idID	tracking link ID for which you want to edit the easy deep link configuration
settingsJSON	stringified JSON of the easy deep link configuration, see i1/urls/easydeeplinks/info for details, if the app name is `Unknown` you can use the optional `override_app_name` field to define the name of the custom app (default: `App`)

Return values

parameter	description
enabled	1 if the easy deep link option has been successfully enabled, 0 otherwise

/urls/easydeeplinks/info

access: [READ]

Get an easy deep link settings for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=641c8bf6c3b935c515f726d441b441a2

Query parameters

id = 641c8bf6c3b935c515f726d441b441a2

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "YouTube",
    "category": "social",
    "ios": {
      "phone": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": "https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"
        }
      },
      "tablet": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": "https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"
        }
      }
    },
    "android": {
      "phone": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"
        }
      },
      "tablet": {
        "enabled": 1,
        "installed": {
          "choice": "scheme",
          "scheme": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end",
          "custom": "",
          "alternatives": []
        },
        "not_installed": {
          "choice": "default",
          "custom": "",
          "store": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"
        }
      }
    },
    "default_url": "https:\/\/youtu.be\/oBg0slZQt1g",
    "info": {
      "title": "JotURL - The all-in-one dream suite for your marketing links!",
      "description": "JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com",
      "image": "https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg",
      "ios_url": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be",
      "ios_store_url": "https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664",
      "android_url": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end",
      "android_store_url": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube",
      "info": {
        "ios": {
          "app_name": "YouTube",
          "app_store_id": "544007664",
          "url": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be"
        },
        "android": {
          "app_name": "YouTube",
          "package": "com.google.android.youtube",
          "url": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"
        }
      }
    },
    "detected": [
      "ios",
      "android"
    ],
    "autodetect": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=641c8bf6c3b935c515f726d441b441a2&format=xml

Query parameters

    id = 641c8bf6c3b935c515f726d441b441a2
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>YouTube</name>  
    <category>social</category>  
    <ios>
      <phone>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store>https://itunes.apple.com/us/app/youtube/id544007664</store>  
        </not_installed>  
      </phone>  
      <tablet>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store>https://itunes.apple.com/us/app/youtube/id544007664</store>  
        </not_installed>  
      </tablet>  
    </ios>  
    <android>
      <phone>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store>https://play.google.com/store/apps/details?id=com.google.android.youtube</store>  
        </not_installed>  
      </phone>  
      <tablet>
        <enabled>1</enabled>  
        <installed>
          <choice>scheme</choice>  
          <scheme><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></scheme>  
          <custom></custom>  
          <alternatives>

          </alternatives>  
        </installed>  
        <not_installed>
          <choice>default</choice>  
          <custom></custom>  
          <store>https://play.google.com/store/apps/details?id=com.google.android.youtube</store>  
        </not_installed>  
      </tablet>  
    </android>  
    <default_url>https://youtu.be/oBg0slZQt1g</default_url>  
    <info>
      <title>JotURL - The all-in-one dream suite for your marketing links!</title>  
      <description>JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com</description>  
      <image>https://i.ytimg.com/vi/oBg0slZQt1g/maxresdefault.jpg</image>  
      <ios_url><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></ios_url>  
      <ios_store_url>https://itunes.apple.com/us/app/youtube/id544007664</ios_store_url>  
      <android_url><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></android_url>  
      <android_store_url>https://play.google.com/store/apps/details?id=com.google.android.youtube</android_store_url>  
      <info>
        <ios>
          <app_name>YouTube</app_name>  
          <app_store_id>544007664</app_store_id>  
          <url><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></url>  
        </ios>  
        <android>
          <app_name>YouTube</app_name>  
          <package>com.google.android.youtube</package>  
          <url><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></url>  
        </android>  
      </info>  
    </info>  
    <detected>
      <i0>ios</i0>  
      <i1>android</i1>  
    </detected>  
    <autodetect>1</autodetect>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=641c8bf6c3b935c515f726d441b441a2&format=txt

Query parameters

    id = 641c8bf6c3b935c515f726d441b441a2
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=YouTube
result_category=social
result_ios_phone_enabled=1
result_ios_phone_installed_choice=scheme
result_ios_phone_installed_scheme=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_ios_phone_installed_custom=
result_ios_phone_installed_alternatives=
result_ios_phone_not_installed_choice=default
result_ios_phone_not_installed_custom=
result_ios_phone_not_installed_store=https://itunes.apple.com/us/app/youtube/id544007664
result_ios_tablet_enabled=1
result_ios_tablet_installed_choice=scheme
result_ios_tablet_installed_scheme=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_ios_tablet_installed_custom=
result_ios_tablet_installed_alternatives=
result_ios_tablet_not_installed_choice=default
result_ios_tablet_not_installed_custom=
result_ios_tablet_not_installed_store=https://itunes.apple.com/us/app/youtube/id544007664
result_android_phone_enabled=1
result_android_phone_installed_choice=scheme
result_android_phone_installed_scheme=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_android_phone_installed_custom=
result_android_phone_installed_alternatives=
result_android_phone_not_installed_choice=default
result_android_phone_not_installed_custom=
result_android_phone_not_installed_store=https://play.google.com/store/apps/details?id=com.google.android.youtube
result_android_tablet_enabled=1
result_android_tablet_installed_choice=scheme
result_android_tablet_installed_scheme=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_android_tablet_installed_custom=
result_android_tablet_installed_alternatives=
result_android_tablet_not_installed_choice=default
result_android_tablet_not_installed_custom=
result_android_tablet_not_installed_store=https://play.google.com/store/apps/details?id=com.google.android.youtube
result_default_url=https://youtu.be/oBg0slZQt1g
result_info_title=JotURL - The all-in-one dream suite for your marketing links!
result_info_description=JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com
result_info_image=https://i.ytimg.com/vi/oBg0slZQt1g/maxresdefault.jpg
result_info_ios_url=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_info_ios_store_url=https://itunes.apple.com/us/app/youtube/id544007664
result_info_android_url=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_info_android_store_url=https://play.google.com/store/apps/details?id=com.google.android.youtube
result_info_info_ios_app_name=YouTube
result_info_info_ios_app_store_id=544007664
result_info_info_ios_url=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_info_info_android_app_name=YouTube
result_info_info_android_package=com.google.android.youtube
result_info_info_android_url=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_detected_0=ios
result_detected_1=android
result_autodetect=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=641c8bf6c3b935c515f726d441b441a2&format=plain

Query parameters

    id = 641c8bf6c3b935c515f726d441b441a2
format = plain

Response

YouTube
social
1
scheme
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be


default

https://itunes.apple.com/us/app/youtube/id544007664
1
scheme
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be


default

https://itunes.apple.com/us/app/youtube/id544007664
1
scheme
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end


default

https://play.google.com/store/apps/details?id=com.google.android.youtube
1
scheme
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end


default

https://play.google.com/store/apps/details?id=com.google.android.youtube
https://youtu.be/oBg0slZQt1g
JotURL - The all-in-one dream suite for your marketing links!
JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com
https://i.ytimg.com/vi/oBg0slZQt1g/maxresdefault.jpg
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
https://itunes.apple.com/us/app/youtube/id544007664
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
https://play.google.com/store/apps/details?id=com.google.android.youtube
YouTube
544007664
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
YouTube
com.google.android.youtube
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
ios
android
1

Example 5 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=d18ca4c0f05fe9a53aed1b1d32f0bf9f

Query parameters

id = d18ca4c0f05fe9a53aed1b1d32f0bf9f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "settings": "{\"name\":\"YouTube\",\"category\":\"social\",\"ios\":{\"phone\":{\"enabled\":true,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/itunes.apple.com\\\/us\\\/app\\\/youtube\\\/id544007664\"}},\"tablet\":{\"enabled\":true,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/itunes.apple.com\\\/us\\\/app\\\/youtube\\\/id544007664\"}}},\"android\":{\"phone\":{\"enabled\":true,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/play.google.com\\\/store\\\/apps\\\/details?id=com.google.android.youtube\"}},\"tablet\":{\"enabled\":true,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/play.google.com\\\/store\\\/apps\\\/details?id=com.google.android.youtube\"}}},\"default_url\":\"https:\\\/\\\/youtu.be\\\/oBg0slZQt1g\",\"info\":{\"title\":\"JotURL - The all-in-one dream suite for your marketing links!\",\"description\":\"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com\",\"image\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/oBg0slZQt1g\\\/maxresdefault.jpg\",\"ios_url\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\",\"ios_store_url\":\"https:\\\/\\\/itunes.apple.com\\\/us\\\/app\\\/youtube\\\/id544007664\",\"android_url\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\",\"android_store_url\":\"https:\\\/\\\/play.google.com\\\/store\\\/apps\\\/details?id=com.google.android.youtube\",\"info\":{\"ios\":{\"app_name\":\"YouTube\",\"app_store_id\":\"544007664\",\"url\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\"},\"android\":{\"app_name\":\"YouTube\",\"package\":\"com.google.android.youtube\",\"url\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\"}}},\"og_title\":\"OG Title\",\"og_description\":\"OG Description\",\"og_image\":\"https:\\\/\\\/example.com\\\/og_image.png\"}",
    "autodetect": 0
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=d18ca4c0f05fe9a53aed1b1d32f0bf9f&format=xml

Query parameters

    id = d18ca4c0f05fe9a53aed1b1d32f0bf9f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <settings><[CDATA[{"name":"YouTube","category":"social","ios":{"phone":{"enabled":true,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"}},"tablet":{"enabled":true,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"}}},"android":{"phone":{"enabled":true,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"}},"tablet":{"enabled":true,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"}}},"default_url":"https:\/\/youtu.be\/oBg0slZQt1g","info":{"title":"JotURL - The all-in-one dream suite for your marketing links!","description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg","ios_url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","ios_store_url":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664","android_url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","android_store_url":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube","info":{"ios":{"app_name":"YouTube","app_store_id":"544007664","url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be"},"android":{"app_name":"YouTube","package":"com.google.android.youtube","url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"}}},"og_title":"OG Title","og_description":"OG Description","og_image":"https:\/\/example.com\/og_image.png"}]]></settings>  
    <autodetect>0</autodetect>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=d18ca4c0f05fe9a53aed1b1d32f0bf9f&format=txt

Query parameters

    id = d18ca4c0f05fe9a53aed1b1d32f0bf9f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_settings={"name":"YouTube","category":"social","ios":{"phone":{"enabled":true,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"}},"tablet":{"enabled":true,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"}}},"android":{"phone":{"enabled":true,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"}},"tablet":{"enabled":true,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"}}},"default_url":"https:\/\/youtu.be\/oBg0slZQt1g","info":{"title":"JotURL - The all-in-one dream suite for your marketing links!","description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg","ios_url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","ios_store_url":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664","android_url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","android_store_url":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube","info":{"ios":{"app_name":"YouTube","app_store_id":"544007664","url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be"},"android":{"app_name":"YouTube","package":"com.google.android.youtube","url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"}}},"og_title":"OG Title","og_description":"OG Description","og_image":"https:\/\/example.com\/og_image.png"}
result_autodetect=0

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/info?id=d18ca4c0f05fe9a53aed1b1d32f0bf9f&format=plain

Query parameters

    id = d18ca4c0f05fe9a53aed1b1d32f0bf9f
format = plain

Response

{"name":"YouTube","category":"social","ios":{"phone":{"enabled":true,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"}},"tablet":{"enabled":true,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"}}},"android":{"phone":{"enabled":true,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"}},"tablet":{"enabled":true,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"}}},"default_url":"https:\/\/youtu.be\/oBg0slZQt1g","info":{"title":"JotURL - The all-in-one dream suite for your marketing links!","description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg","ios_url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","ios_store_url":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664","android_url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","android_store_url":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube","info":{"ios":{"app_name":"YouTube","app_store_id":"544007664","url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be"},"android":{"app_name":"YouTube","package":"com.google.android.youtube","url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"}}},"og_title":"OG Title","og_description":"OG Description","og_image":"https:\/\/example.com\/og_image.png"}
0

Required parameters

parameter	description
idID	tracking link ID for which you want to extract the easy deep link configuration

Optional parameters

parameter	description
infoJSON	additional information to use to create the the easy deep link configuration, used only if valid and matching the tracking link destination URL

The info object contains structured information extracted from the final web page. Only some EDL providers support this parameter.

final_url (required)
The resolved destination URL after all redirects have been followed.
This represents the actual page URL that was loaded and analyzed.
info (optional)
High-level information about the page, primarily intended for validation, filtering, and decision-making:
- title: the main page title, typically derived from document metadata
- h1: the primary page heading, if available
- h2: a secondary page heading, if available
- robots: robots directives declared by the page, if present
- noindex: indicates whether the page declares that it should not be indexed
- httpStatus: the HTTP response status returned when accessing the page
og (optional)
Preview-oriented metadata describing how the page should be represented when shared:
- title: a human-readable title suitable for previews (max 1024 characters)
- description: a concise description summarizing the page content (max 2048 characters)
- image: a representative image URL suitable for visual previews (max 2048 characters)

Return values

parameter	description
android	[OPTIONAL] array containing the easy deep link configuration for Android, returned only if `autodetect = 1`
autodetect	1 if the configuration was automatically detected, 0 if it was taken from a previously set configuration
category	[OPTIONAL] category of the easy deep link provider, returned only if `autodetect = 1`, supported categories: affiliation, business, entertainment, lifestyle, music, other, shopping, social, travel, unknown, website
default_url	[OPTIONAL] default URL for the easy deep link configuration, returned only if `autodetect = 1`
detected	[OPTIONAL] returned only if `autodetect = 1`, array containing the extracted information, it can contain the values `ios` and `android` depending on whether our system was able to extract the deep link information for that specific operating system, it contains only one of the above values in case it is not possible to extract the information for the deep link for one of the operating systems, it can be empty in case it is not possible to extract the information for the deep link
info	[OPTIONAL] Open Graph information extracted from `default_url` and raw deep link information, returned only if `autodetect = 1`
ios	[OPTIONAL] array containing the easy deep link configuration for iOS, returned only if `autodetect = 1`
name	[OPTIONAL] name of the easy deep link provider, returned only if `autodetect = 1`, supported names: Adidas, AliExpress, Amazon, Apartments.com, Apple Maps, Apple Music, Apple Podcast, Best Buy, BlueSky, Booking.com, BrandCycle, Comfrt, Discord, eBay, Epic Games Store, Etsy, Expedia, Facebook, Flipkart, Google Docs, Google Maps, Google Sheets, Google Slides, Howl, HSN, iFood, IKEA, Instagram, Kaufland, Kickstarter, Kohl's, LINE, LinkedIn, LTK, Macy's, MagicLinks, Mavely, Medium, Mercado Livre, Messenger, Microsoft Excel, Microsoft PowerPoint, Microsoft Word, Netflix, Nordstrom, Nordstrom Rack, OnlyFans, Otto, Pinterest, Poshmark, Product Hunt, Quora, QVC, Reddit, Refersion, Sephora, SHEIN, Shopee, ShopMy, Signal, Skype, Snapchat, Spotify, Steam, Target, Telegram, Temu, The Home Depot, Threads, TikTok, TripAdvisor, Trulia, Twitch TV, Ulta Beauty, Unknown, Viber, Vimeo, Walmart, WhatsApp, X, YouTube, Zendesk Support, Zillow, Zulily
settings	[OPTIONAL] returned only if `autodetect = 0`, stringified JSON of the easy deep link configuration, it contains the same fields returned when `autodetect = 1` except `autodetect` plus the fields: og_title, og_description, og_image which are the corresponding custom Open Graph fields

The android and ios arrays share the same configuration structure for both phone and tablet devices.

JSON Structure

{
    "phone": {
        "enabled": 1,
        "installed": {
            "choice": "scheme",
            "scheme": "myapp:\/\/page",
            "custom": "customscheme:\/\/page",
            "alternatives": []
        },
        "not_installed": {
            "choice": "default",
            "custom": "customscheme:\/\/fallback",
            "store": "https:\/\/play.google.com\/store\/apps\/details?id=com.example"
        },
        "disable_ok_cancel": 0,
        "disable_open_in_browser_page": 0,
        "deeplink_method": "aggressive",
        "force_redirect": 0,
        "force_chrome": 0
    },
    "tablet": "...same structure as phone..."
}

Fields Description

General Configuration

enabled:
- 1: enables the specific configuration.
- 0: disables the configuration (the default URL will be used).
deeplink_method (Available only when autodetect = 0):
- aggressive: tries to open the app anyway. This maximizes the deep linking success rate but may cause error messages (e.g., "invalid address") if the app is not installed (recommended).
- conservative: our engine employs techniques to minimize the probability of errors, attempting to open the app only when specific conditions are met to ensure a smoother user experience.

App Installed Logic (installed object)

choice:
- scheme: uses the standard URI defined in scheme.
- custom: uses the custom URI defined in custom.
alternatives: an array of fallback alternatives for the custom field. Can be empty or contain objects like {"type": "[unique ID]", "url": "[alternative custom URI scheme]"}.

App NOT Installed Logic (not_installed object)

choice:
- default: uses the global default_url.
- store: uses the store URL.
- custom: uses the custom URI.

Optional Flags

These flags may not be present in the response.

disable_ok_cancel: used to control the "OK/Cancel" dialog box displayed by the engine to maximize the likelihood of deep linking.
- 1: disables the "OK/Cancel" dialog box.
- 0: enables the "OK/Cancel" dialog box when needed.
disable_open_in_browser_page: used to control the "Open in browser" page displayed on TikTok.
- 1: disables the "Open in browser" page (Recommended if the deep link is used in TikTok ads).
- 0: enables the "Open in browser" page when needed.
force_open_in_browser_page: used to control the "Open in browser" page displayed on built-in browsers (this flag does not override the flag disable_open_in_browser_page).
- 1: forces the "Open in browser" page on all built-in browsers.
- 0: enables the "Open in browser" page when needed.

Android only flags, may not be present in the response.

force_chrome:
- 1: tries to open Chrome before deep linking (useful for apps with internal webviews, e.g., Facebook).
- 0: does not try to open Chrome.
force_redirect: this flag is used only when not_installed.choice = default, force_chrome = 0, and a webview (e.g., Facebook internal browser) is detected. If the deep link fails:
- 1: forces a redirect to default_url instead of opening the Android Play Store.
- 0: opens the Android Play Store.

/urls/easydeeplinks/list

access: [READ]

Get all supported apps for the easy deep link grouped by category.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/easydeeplinks/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "shopping": [
      "Adidas",
      "AliExpress",
      "Amazon",
      "Best Buy",
      "Comfrt",
      "eBay",
      "Etsy",
      "Flipkart",
      "HSN",
      "IKEA",
      "Kaufland",
      "Kohl's",
      "LTK",
      "Macy's",
      "Mercado Livre",
      "Nordstrom",
      "Nordstrom Rack",
      "Otto",
      "Poshmark",
      "QVC",
      "Sephora",
      "SHEIN",
      "Shopee",
      "Target",
      "Temu",
      "The Home Depot",
      "Ulta Beauty",
      "Walmart",
      "Zulily"
    ],
    "lifestyle": [
      "Apartments.com",
      "iFood",
      "Trulia",
      "Zillow"
    ],
    "travel": [
      "Apple Maps",
      "Booking.com",
      "Expedia",
      "Google Maps",
      "TripAdvisor"
    ],
    "music": [
      "Apple Music",
      "Spotify"
    ],
    "other": [
      "Apple Podcast",
      "Zendesk Support"
    ],
    "social": [
      "BlueSky",
      "Discord",
      "Facebook",
      "Instagram",
      "LINE",
      "LinkedIn",
      "Messenger",
      "Pinterest",
      "Product Hunt",
      "Reddit",
      "Signal",
      "Skype",
      "Snapchat",
      "Telegram",
      "Threads",
      "TikTok",
      "Viber",
      "Vimeo",
      "X",
      "YouTube"
    ],
    "affiliation": [
      "BrandCycle",
      "Howl",
      "MagicLinks",
      "Mavely",
      "Refersion",
      "ShopMy"
    ],
    "entertainment": [
      "Epic Games Store",
      "Netflix",
      "OnlyFans",
      "Steam",
      "Twitch TV"
    ],
    "business": [
      "Google Docs",
      "Google Sheets",
      "Google Slides",
      "Microsoft Excel",
      "Microsoft PowerPoint",
      "Microsoft Word"
    ],
    "website": [
      "Kickstarter",
      "Medium",
      "Quora"
    ],
    "unknown": [
      "Unknown"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/easydeeplinks/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <shopping>
      <i0>Adidas</i0>  
      <i1>AliExpress</i1>  
      <i2>Amazon</i2>  
      <i3>Best Buy</i3>  
      <i4>Comfrt</i4>  
      <i5>eBay</i5>  
      <i6>Etsy</i6>  
      <i7>Flipkart</i7>  
      <i8>HSN</i8>  
      <i9>IKEA</i9>  
      <i10>Kaufland</i10>  
      <i11>Kohl's</i11>  
      <i12>LTK</i12>  
      <i13>Macy's</i13>  
      <i14>Mercado Livre</i14>  
      <i15>Nordstrom</i15>  
      <i16>Nordstrom Rack</i16>  
      <i17>Otto</i17>  
      <i18>Poshmark</i18>  
      <i19>QVC</i19>  
      <i20>Sephora</i20>  
      <i21>SHEIN</i21>  
      <i22>Shopee</i22>  
      <i23>Target</i23>  
      <i24>Temu</i24>  
      <i25>The Home Depot</i25>  
      <i26>Ulta Beauty</i26>  
      <i27>Walmart</i27>  
      <i28>Zulily</i28>  
    </shopping>  
    <lifestyle>
      <i0>Apartments.com</i0>  
      <i1>iFood</i1>  
      <i2>Trulia</i2>  
      <i3>Zillow</i3>  
    </lifestyle>  
    <travel>
      <i0>Apple Maps</i0>  
      <i1>Booking.com</i1>  
      <i2>Expedia</i2>  
      <i3>Google Maps</i3>  
      <i4>TripAdvisor</i4>  
    </travel>  
    <music>
      <i0>Apple Music</i0>  
      <i1>Spotify</i1>  
    </music>  
    <other>
      <i0>Apple Podcast</i0>  
      <i1>Zendesk Support</i1>  
    </other>  
    <social>
      <i0>BlueSky</i0>  
      <i1>Discord</i1>  
      <i2>Facebook</i2>  
      <i3>Instagram</i3>  
      <i4>LINE</i4>  
      <i5>LinkedIn</i5>  
      <i6>Messenger</i6>  
      <i7>Pinterest</i7>  
      <i8>Product Hunt</i8>  
      <i9>Reddit</i9>  
      <i10>Signal</i10>  
      <i11>Skype</i11>  
      <i12>Snapchat</i12>  
      <i13>Telegram</i13>  
      <i14>Threads</i14>  
      <i15>TikTok</i15>  
      <i16>Viber</i16>  
      <i17>Vimeo</i17>  
      <i18>X</i18>  
      <i19>YouTube</i19>  
    </social>  
    <affiliation>
      <i0>BrandCycle</i0>  
      <i1>Howl</i1>  
      <i2>MagicLinks</i2>  
      <i3>Mavely</i3>  
      <i4>Refersion</i4>  
      <i5>ShopMy</i5>  
    </affiliation>  
    <entertainment>
      <i0>Epic Games Store</i0>  
      <i1>Netflix</i1>  
      <i2>OnlyFans</i2>  
      <i3>Steam</i3>  
      <i4>Twitch TV</i4>  
    </entertainment>  
    <business>
      <i0>Google Docs</i0>  
      <i1>Google Sheets</i1>  
      <i2>Google Slides</i2>  
      <i3>Microsoft Excel</i3>  
      <i4>Microsoft PowerPoint</i4>  
      <i5>Microsoft Word</i5>  
    </business>  
    <website>
      <i0>Kickstarter</i0>  
      <i1>Medium</i1>  
      <i2>Quora</i2>  
    </website>  
    <unknown>
      <i0>Unknown</i0>  
    </unknown>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/easydeeplinks/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_shopping_0=Adidas
result_shopping_1=AliExpress
result_shopping_2=Amazon
result_shopping_3=Best Buy
result_shopping_4=Comfrt
result_shopping_5=eBay
result_shopping_6=Etsy
result_shopping_7=Flipkart
result_shopping_8=HSN
result_shopping_9=IKEA
result_shopping_10=Kaufland
result_shopping_11=Kohl's
result_shopping_12=LTK
result_shopping_13=Macy's
result_shopping_14=Mercado Livre
result_shopping_15=Nordstrom
result_shopping_16=Nordstrom Rack
result_shopping_17=Otto
result_shopping_18=Poshmark
result_shopping_19=QVC
result_shopping_20=Sephora
result_shopping_21=SHEIN
result_shopping_22=Shopee
result_shopping_23=Target
result_shopping_24=Temu
result_shopping_25=The Home Depot
result_shopping_26=Ulta Beauty
result_shopping_27=Walmart
result_shopping_28=Zulily
result_lifestyle_0=Apartments.com
result_lifestyle_1=iFood
result_lifestyle_2=Trulia
result_lifestyle_3=Zillow
result_travel_0=Apple Maps
result_travel_1=Booking.com
result_travel_2=Expedia
result_travel_3=Google Maps
result_travel_4=TripAdvisor
result_music_0=Apple Music
result_music_1=Spotify
result_other_0=Apple Podcast
result_other_1=Zendesk Support
result_social_0=BlueSky
result_social_1=Discord
result_social_2=Facebook
result_social_3=Instagram
result_social_4=LINE
result_social_5=LinkedIn
result_social_6=Messenger
result_social_7=Pinterest
result_social_8=Product Hunt
result_social_9=Reddit
result_social_10=Signal
result_social_11=Skype
result_social_12=Snapchat
result_social_13=Telegram
result_social_14=Threads
result_social_15=TikTok
result_social_16=Viber
result_social_17=Vimeo
result_social_18=X
result_social_19=YouTube
result_affiliation_0=BrandCycle
result_affiliation_1=Howl
result_affiliation_2=MagicLinks
result_affiliation_3=Mavely
result_affiliation_4=Refersion
result_affiliation_5=ShopMy
result_entertainment_0=Epic Games Store
result_entertainment_1=Netflix
result_entertainment_2=OnlyFans
result_entertainment_3=Steam
result_entertainment_4=Twitch TV
result_business_0=Google Docs
result_business_1=Google Sheets
result_business_2=Google Slides
result_business_3=Microsoft Excel
result_business_4=Microsoft PowerPoint
result_business_5=Microsoft Word
result_website_0=Kickstarter
result_website_1=Medium
result_website_2=Quora
result_unknown_0=Unknown

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/easydeeplinks/list?format=plain

Query parameters

format = plain

Response

Adidas
AliExpress
Amazon
Best Buy
Comfrt
eBay
Etsy
Flipkart
HSN
IKEA
Kaufland
Kohl's
LTK
Macy's
Mercado Livre
Nordstrom
Nordstrom Rack
Otto
Poshmark
QVC
Sephora
SHEIN
Shopee
Target
Temu
The Home Depot
Ulta Beauty
Walmart
Zulily
Apartments.com
iFood
Trulia
Zillow
Apple Maps
Booking.com
Expedia
Google Maps
TripAdvisor
Apple Music
Spotify
Apple Podcast
Zendesk Support
BlueSky
Discord
Facebook
Instagram
LINE
LinkedIn
Messenger
Pinterest
Product Hunt
Reddit
Signal
Skype
Snapchat
Telegram
Threads
TikTok
Viber
Vimeo
X
YouTube
BrandCycle
Howl
MagicLinks
Mavely
Refersion
ShopMy
Epic Games Store
Netflix
OnlyFans
Steam
Twitch TV
Google Docs
Google Sheets
Google Slides
Microsoft Excel
Microsoft PowerPoint
Microsoft Word
Kickstarter
Medium
Quora
Unknown

Return values

parameter	description
data	array containing all supported apps for the easy deep link grouped by category, it is in the form {"category1":[ list ], "category2":[ list ], ... }

/urls/edit

access: [WRITE]

Edit fields of a short URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/edit?id=c66d236bf3ba54cc862bbf539efa0e9c&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=this+is+a+sample+note

Query parameters

      id = c66d236bf3ba54cc862bbf539efa0e9c
long_url = https://www.joturl.com/
   notes = this is a sample note

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "c66d236bf3ba54cc862bbf539efa0e9c",
    "alias": "jot",
    "domain_host": "jo.my",
    "domain_id": "d9c1f3306c17b4f4d45ff80841d557ed",
    "project_id": "33345a1fa48632ae5af2faaae49d0929",
    "project_name": "project name",
    "long_url": "https:\/\/www.joturl.com\/",
    "short_url": "http:\/\/jo.my\/jot",
    "notes": "this is a sample note"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/edit?id=c66d236bf3ba54cc862bbf539efa0e9c&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=this+is+a+sample+note&format=xml

Query parameters

      id = c66d236bf3ba54cc862bbf539efa0e9c
long_url = https://www.joturl.com/
   notes = this is a sample note
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>c66d236bf3ba54cc862bbf539efa0e9c</id>  
    <alias>jot</alias>  
    <domain_host>jo.my</domain_host>  
    <domain_id>d9c1f3306c17b4f4d45ff80841d557ed</domain_id>  
    <project_id>33345a1fa48632ae5af2faaae49d0929</project_id>  
    <project_name>project name</project_name>  
    <long_url>https://www.joturl.com/</long_url>  
    <short_url>http://jo.my/jot</short_url>  
    <notes>this is a sample note</notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/edit?id=c66d236bf3ba54cc862bbf539efa0e9c&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=this+is+a+sample+note&format=txt

Query parameters

      id = c66d236bf3ba54cc862bbf539efa0e9c
long_url = https://www.joturl.com/
   notes = this is a sample note
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=c66d236bf3ba54cc862bbf539efa0e9c
result_alias=jot
result_domain_host=jo.my
result_domain_id=d9c1f3306c17b4f4d45ff80841d557ed
result_project_id=33345a1fa48632ae5af2faaae49d0929
result_project_name=project name
result_long_url=https://www.joturl.com/
result_short_url=http://jo.my/jot
result_notes=this is a sample note

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/edit?id=c66d236bf3ba54cc862bbf539efa0e9c&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=this+is+a+sample+note&format=plain

Query parameters

      id = c66d236bf3ba54cc862bbf539efa0e9c
long_url = https://www.joturl.com/
   notes = this is a sample note
  format = plain

Response

http://jo.my/jot

Required parameters

parameter	description
idID	ID of the tracking link to be edited

Optional parameters

parameter	description	max length
long_urlSTRING	destination URL for tracking link	4000
notesSTRING	notes for tracking link	255

Return values

parameter	description
alias	see i1/urls/list for details
domain_host	domain (e.g., domain.ext) of the tracking link
domain_id	ID of the domain of the tracking link
id	see i1/urls/list for details
long_url	see i1/urls/list for details
notes	see i1/urls/list for details
project_id	ID of the project
project_name	name of the project
short_url	see i1/urls/list for details

/urls/embeddable

access: [READ]

This method returns 1 if the passed URL is embeddable, 0 otherwise.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F

Query parameters

u = https://www.joturl.com/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "embeddable": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F&format=xml

Query parameters

     u = https://www.joturl.com/
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <embeddable>0</embeddable>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F&format=txt

Query parameters

     u = https://www.joturl.com/
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_embeddable=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F&format=plain

Query parameters

     u = https://www.joturl.com/
format = plain

Response

Required parameters

parameter	description
uSTRING	URL to be checked

Return values

parameter	description
embeddable	1 if the URL is embeddable, 0 otherwise

/urls/export

access: [READ]

This method export the list of URLs in a user account.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/export

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 14,
    "remaining": 0,
    "tls": {
      "publication name 1": {
        "custom.domain7.ext": [
          {
            "alias": "alias0",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=0",
            "visits": 100,
            "unique_visits": 81,
            "qrcodes_visits": 68
          },
          {
            "alias": "alias1",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=1",
            "visits": 42,
            "unique_visits": 10,
            "qrcodes_visits": 0
          },
          {
            "alias": "alias2",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=2",
            "visits": 61,
            "unique_visits": 40,
            "qrcodes_visits": 30
          },
          {
            "alias": "alias3",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=3",
            "visits": 11,
            "unique_visits": 1,
            "qrcodes_visits": 1
          },
          {
            "alias": "alias4",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=4",
            "visits": 82,
            "unique_visits": 1,
            "qrcodes_visits": 1
          }
        ]
      },
      "publication name 2": {
        "custom.domain4.ext": [
          {
            "alias": "alias5",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=5",
            "visits": 0,
            "unique_visits": 0,
            "qrcodes_visits": 0
          },
          {
            "alias": "alias6",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=6",
            "visits": 36,
            "unique_visits": 20,
            "qrcodes_visits": 16
          },
          {
            "alias": "alias7",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=7",
            "visits": 89,
            "unique_visits": 79,
            "qrcodes_visits": 0
          },
          {
            "alias": "alias8",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=8",
            "visits": 58,
            "unique_visits": 31,
            "qrcodes_visits": 21
          }
        ]
      },
      "publication name 3": {
        "custom.domain2.ext": [
          {
            "alias": "alias9",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=9",
            "visits": 83,
            "unique_visits": 25,
            "qrcodes_visits": 16
          },
          {
            "alias": "alias10",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=10",
            "visits": 80,
            "unique_visits": 28,
            "qrcodes_visits": 18
          },
          {
            "alias": "alias11",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=11",
            "visits": 26,
            "unique_visits": 15,
            "qrcodes_visits": 8
          },
          {
            "alias": "alias12",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=12",
            "visits": 52,
            "unique_visits": 7,
            "qrcodes_visits": 1
          },
          {
            "alias": "alias13",
            "embed_code": "",
            "long_url": "https:\/\/my.destination.url\/?p=13",
            "visits": 91,
            "unique_visits": 27,
            "qrcodes_visits": 18
          }
        ]
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/export?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>14</count>  
    <remaining>0</remaining>  
    <tls>
      <publication name 1>
        <custom.domain7.ext>
          <i0>
            <alias>alias0</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=0</long_url>  
            <visits>100</visits>  
            <unique_visits>81</unique_visits>  
            <qrcodes_visits>68</qrcodes_visits>  
          </i0>  
          <i1>
            <alias>alias1</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=1</long_url>  
            <visits>42</visits>  
            <unique_visits>10</unique_visits>  
            <qrcodes_visits>0</qrcodes_visits>  
          </i1>  
          <i2>
            <alias>alias2</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=2</long_url>  
            <visits>61</visits>  
            <unique_visits>40</unique_visits>  
            <qrcodes_visits>30</qrcodes_visits>  
          </i2>  
          <i3>
            <alias>alias3</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=3</long_url>  
            <visits>11</visits>  
            <unique_visits>1</unique_visits>  
            <qrcodes_visits>1</qrcodes_visits>  
          </i3>  
          <i4>
            <alias>alias4</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=4</long_url>  
            <visits>82</visits>  
            <unique_visits>1</unique_visits>  
            <qrcodes_visits>1</qrcodes_visits>  
          </i4>  
        </custom.domain7.ext>  
      </publication name 1>  
      <publication name 2>
        <custom.domain4.ext>
          <i0>
            <alias>alias5</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=5</long_url>  
            <visits>0</visits>  
            <unique_visits>0</unique_visits>  
            <qrcodes_visits>0</qrcodes_visits>  
          </i0>  
          <i1>
            <alias>alias6</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=6</long_url>  
            <visits>36</visits>  
            <unique_visits>20</unique_visits>  
            <qrcodes_visits>16</qrcodes_visits>  
          </i1>  
          <i2>
            <alias>alias7</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=7</long_url>  
            <visits>89</visits>  
            <unique_visits>79</unique_visits>  
            <qrcodes_visits>0</qrcodes_visits>  
          </i2>  
          <i3>
            <alias>alias8</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=8</long_url>  
            <visits>58</visits>  
            <unique_visits>31</unique_visits>  
            <qrcodes_visits>21</qrcodes_visits>  
          </i3>  
        </custom.domain4.ext>  
      </publication name 2>  
      <publication name 3>
        <custom.domain2.ext>
          <i0>
            <alias>alias9</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=9</long_url>  
            <visits>83</visits>  
            <unique_visits>25</unique_visits>  
            <qrcodes_visits>16</qrcodes_visits>  
          </i0>  
          <i1>
            <alias>alias10</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=10</long_url>  
            <visits>80</visits>  
            <unique_visits>28</unique_visits>  
            <qrcodes_visits>18</qrcodes_visits>  
          </i1>  
          <i2>
            <alias>alias11</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=11</long_url>  
            <visits>26</visits>  
            <unique_visits>15</unique_visits>  
            <qrcodes_visits>8</qrcodes_visits>  
          </i2>  
          <i3>
            <alias>alias12</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=12</long_url>  
            <visits>52</visits>  
            <unique_visits>7</unique_visits>  
            <qrcodes_visits>1</qrcodes_visits>  
          </i3>  
          <i4>
            <alias>alias13</alias>  
            <embed_code></embed_code>  
            <long_url>https://my.destination.url/?p=13</long_url>  
            <visits>91</visits>  
            <unique_visits>27</unique_visits>  
            <qrcodes_visits>18</qrcodes_visits>  
          </i4>  
        </custom.domain2.ext>  
      </publication name 3>  
    </tls>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/export?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=14
result_remaining=0
result_tls_publication name 1_custom.domain7.ext_0_alias=alias0
result_tls_publication name 1_custom.domain7.ext_0_embed_code=
result_tls_publication name 1_custom.domain7.ext_0_long_url=https://my.destination.url/?p=0
result_tls_publication name 1_custom.domain7.ext_0_visits=100
result_tls_publication name 1_custom.domain7.ext_0_unique_visits=81
result_tls_publication name 1_custom.domain7.ext_0_qrcodes_visits=68
result_tls_publication name 1_custom.domain7.ext_1_alias=alias1
result_tls_publication name 1_custom.domain7.ext_1_embed_code=
result_tls_publication name 1_custom.domain7.ext_1_long_url=https://my.destination.url/?p=1
result_tls_publication name 1_custom.domain7.ext_1_visits=42
result_tls_publication name 1_custom.domain7.ext_1_unique_visits=10
result_tls_publication name 1_custom.domain7.ext_1_qrcodes_visits=0
result_tls_publication name 1_custom.domain7.ext_2_alias=alias2
result_tls_publication name 1_custom.domain7.ext_2_embed_code=
result_tls_publication name 1_custom.domain7.ext_2_long_url=https://my.destination.url/?p=2
result_tls_publication name 1_custom.domain7.ext_2_visits=61
result_tls_publication name 1_custom.domain7.ext_2_unique_visits=40
result_tls_publication name 1_custom.domain7.ext_2_qrcodes_visits=30
result_tls_publication name 1_custom.domain7.ext_3_alias=alias3
result_tls_publication name 1_custom.domain7.ext_3_embed_code=
result_tls_publication name 1_custom.domain7.ext_3_long_url=https://my.destination.url/?p=3
result_tls_publication name 1_custom.domain7.ext_3_visits=11
result_tls_publication name 1_custom.domain7.ext_3_unique_visits=1
result_tls_publication name 1_custom.domain7.ext_3_qrcodes_visits=1
result_tls_publication name 1_custom.domain7.ext_4_alias=alias4
result_tls_publication name 1_custom.domain7.ext_4_embed_code=
result_tls_publication name 1_custom.domain7.ext_4_long_url=https://my.destination.url/?p=4
result_tls_publication name 1_custom.domain7.ext_4_visits=82
result_tls_publication name 1_custom.domain7.ext_4_unique_visits=1
result_tls_publication name 1_custom.domain7.ext_4_qrcodes_visits=1
result_tls_publication name 2_custom.domain4.ext_0_alias=alias5
result_tls_publication name 2_custom.domain4.ext_0_embed_code=
result_tls_publication name 2_custom.domain4.ext_0_long_url=https://my.destination.url/?p=5
result_tls_publication name 2_custom.domain4.ext_0_visits=0
result_tls_publication name 2_custom.domain4.ext_0_unique_visits=0
result_tls_publication name 2_custom.domain4.ext_0_qrcodes_visits=0
result_tls_publication name 2_custom.domain4.ext_1_alias=alias6
result_tls_publication name 2_custom.domain4.ext_1_embed_code=
result_tls_publication name 2_custom.domain4.ext_1_long_url=https://my.destination.url/?p=6
result_tls_publication name 2_custom.domain4.ext_1_visits=36
result_tls_publication name 2_custom.domain4.ext_1_unique_visits=20
result_tls_publication name 2_custom.domain4.ext_1_qrcodes_visits=16
result_tls_publication name 2_custom.domain4.ext_2_alias=alias7
result_tls_publication name 2_custom.domain4.ext_2_embed_code=
result_tls_publication name 2_custom.domain4.ext_2_long_url=https://my.destination.url/?p=7
result_tls_publication name 2_custom.domain4.ext_2_visits=89
result_tls_publication name 2_custom.domain4.ext_2_unique_visits=79
result_tls_publication name 2_custom.domain4.ext_2_qrcodes_visits=0
result_tls_publication name 2_custom.domain4.ext_3_alias=alias8
result_tls_publication name 2_custom.domain4.ext_3_embed_code=
result_tls_publication name 2_custom.domain4.ext_3_long_url=https://my.destination.url/?p=8
result_tls_publication name 2_custom.domain4.ext_3_visits=58
result_tls_publication name 2_custom.domain4.ext_3_unique_visits=31
result_tls_publication name 2_custom.domain4.ext_3_qrcodes_visits=21
result_tls_publication name 3_custom.domain2.ext_0_alias=alias9
result_tls_publication name 3_custom.domain2.ext_0_embed_code=
result_tls_publication name 3_custom.domain2.ext_0_long_url=https://my.destination.url/?p=9
result_tls_publication name 3_custom.domain2.ext_0_visits=83
result_tls_publication name 3_custom.domain2.ext_0_unique_visits=25
result_tls_publication name 3_custom.domain2.ext_0_qrcodes_visits=16
result_tls_publication name 3_custom.domain2.ext_1_alias=alias10
result_tls_publication name 3_custom.domain2.ext_1_embed_code=
result_tls_publication name 3_custom.domain2.ext_1_long_url=https://my.destination.url/?p=10
result_tls_publication name 3_custom.domain2.ext_1_visits=80
result_tls_publication name 3_custom.domain2.ext_1_unique_visits=28
result_tls_publication name 3_custom.domain2.ext_1_qrcodes_visits=18
result_tls_publication name 3_custom.domain2.ext_2_alias=alias11
result_tls_publication name 3_custom.domain2.ext_2_embed_code=
result_tls_publication name 3_custom.domain2.ext_2_long_url=https://my.destination.url/?p=11
result_tls_publication name 3_custom.domain2.ext_2_visits=26
result_tls_publication name 3_custom.domain2.ext_2_unique_visits=15
result_tls_publication name 3_custom.domain2.ext_2_qrcodes_visits=8
result_tls_publication name 3_custom.domain2.ext_3_alias=alias12
result_tls_publication name 3_custom.domain2.ext_3_embed_code=
result_tls_publication name 3_custom.domain2.ext_3_long_url=https://my.destination.url/?p=12
result_tls_publication name 3_custom.domain2.ext_3_visits=52
result_tls_publication name 3_custom.domain2.ext_3_unique_visits=7
result_tls_publication name 3_custom.domain2.ext_3_qrcodes_visits=1
result_tls_publication name 3_custom.domain2.ext_4_alias=alias13
result_tls_publication name 3_custom.domain2.ext_4_embed_code=
result_tls_publication name 3_custom.domain2.ext_4_long_url=https://my.destination.url/?p=13
result_tls_publication name 3_custom.domain2.ext_4_visits=91
result_tls_publication name 3_custom.domain2.ext_4_unique_visits=27
result_tls_publication name 3_custom.domain2.ext_4_qrcodes_visits=18

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/export?format=plain

Query parameters

format = plain

Response

14
0
alias0

https://my.destination.url/?p=0
100
81
68
alias1

https://my.destination.url/?p=1
42
10
0
alias2

https://my.destination.url/?p=2
61
40
30
alias3

https://my.destination.url/?p=3
11
1
1
alias4

https://my.destination.url/?p=4
82
1
1
alias5

https://my.destination.url/?p=5
0
0
0
alias6

https://my.destination.url/?p=6
36
20
16
alias7

https://my.destination.url/?p=7
89
79
0
alias8

https://my.destination.url/?p=8
58
31
21
alias9

https://my.destination.url/?p=9
83
25
16
alias10

https://my.destination.url/?p=10
80
28
18
alias11

https://my.destination.url/?p=11
26
15
8
alias12

https://my.destination.url/?p=12
52
7
1
alias13

https://my.destination.url/?p=13
91
27
18

Optional parameters

parameter	description
startINTEGER	the position from which to start the extraction

Return values

parameter	description
count	total number of tracking links
next	[OPTIONAL] the URL to be called to obtain the next tracking links, the export ends if this parameter does not exist or the URL is empty
remaining	remaining tracking links after the export call, the export ends if this parameter is 0
tls	array containing the exported tracking links

/urls/hub

/urls/hub/check

access: [READ]

This method performs an advanced check of conditions in the hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/check?controller_id=913db635c0857c53b2a6b77cb14d48b1

Query parameters

controller_id = 913db635c0857c53b2a6b77cb14d48b1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "url_id": "0f0526b7c4926c80fbcee883b7edc6af",
        "condition": "#referrer# CON 'facebook.com'",
        "warning": {
          "type": "not_reached",
          "message": "condition is never reached"
        }
      },
      {
        "url_id": "0f0526b7c4926c80fbcee883b7edc6af",
        "condition": "#os# == 'android'",
        "warning": {
          "type": "=true",
          "message": "condition is always true"
        }
      },
      {
        "url_id": "fb6bde86ca24af0aceb6c0b9590e52af",
        "condition": "#os# != 'android'",
        "warning": {
          "type": "=false",
          "message": "condition is always false"
        }
      },
      {
        "url_id": "913db635c0857c53b2a6b77cb14d48b1",
        "condition": "",
        "warning": {
          "type": "controller_url",
          "message": "the controller destination URL is never reached (at least one rule is always true)"
        }
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/check?controller_id=913db635c0857c53b2a6b77cb14d48b1&format=xml

Query parameters

controller_id = 913db635c0857c53b2a6b77cb14d48b1
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <url_id>0f0526b7c4926c80fbcee883b7edc6af</url_id>  
        <condition>#referrer# CON 'facebook.com'</condition>  
        <warning>
          <type>not_reached</type>  
          <message>condition is never reached</message>  
        </warning>  
      </i0>  
      <i1>
        <url_id>0f0526b7c4926c80fbcee883b7edc6af</url_id>  
        <condition>#os# == 'android'</condition>  
        <warning>
          <type>=true</type>  
          <message>condition is always true</message>  
        </warning>  
      </i1>  
      <i2>
        <url_id>fb6bde86ca24af0aceb6c0b9590e52af</url_id>  
        <condition>#os# != 'android'</condition>  
        <warning>
          <type>=false</type>  
          <message>condition is always false</message>  
        </warning>  
      </i2>  
      <i3>
        <url_id>913db635c0857c53b2a6b77cb14d48b1</url_id>  
        <condition></condition>  
        <warning>
          <type>controller_url</type>  
          <message>the controller destination URL is never reached (at least one rule is always true)</message>  
        </warning>  
      </i3>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/check?controller_id=913db635c0857c53b2a6b77cb14d48b1&format=txt

Query parameters

controller_id = 913db635c0857c53b2a6b77cb14d48b1
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_url_id=0f0526b7c4926c80fbcee883b7edc6af
result_data_0_condition=#referrer# CON 'facebook.com'
result_data_0_warning_type=not_reached
result_data_0_warning_message=condition is never reached
result_data_1_url_id=0f0526b7c4926c80fbcee883b7edc6af
result_data_1_condition=#os# == 'android'
result_data_1_warning_type==true
result_data_1_warning_message=condition is always true
result_data_2_url_id=fb6bde86ca24af0aceb6c0b9590e52af
result_data_2_condition=#os# != 'android'
result_data_2_warning_type==false
result_data_2_warning_message=condition is always false
result_data_3_url_id=913db635c0857c53b2a6b77cb14d48b1
result_data_3_condition=
result_data_3_warning_type=controller_url
result_data_3_warning_message=the controller destination URL is never reached (at least one rule is always true)

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/check?controller_id=913db635c0857c53b2a6b77cb14d48b1&format=plain

Query parameters

controller_id = 913db635c0857c53b2a6b77cb14d48b1
       format = plain

Response

0f0526b7c4926c80fbcee883b7edc6af
#referrer# CON 'facebook.com'
not_reached
condition is never reached
0f0526b7c4926c80fbcee883b7edc6af
#os# == 'android'
=true
condition is always true
fb6bde86ca24af0aceb6c0b9590e52af
#os# != 'android'
=false
condition is always false
913db635c0857c53b2a6b77cb14d48b1

controller_url
the controller destination URL is never reached (at least one rule is always true)

Required parameters

parameter	description
controller_idID	ID of the controller tracking link

Return values

parameter	description
data	array containing information about rule checks, empty if no anomalies are detected

The returned array contains as many elements as the anomalies found, each element is an object containing the following fields:

url_id: the ID of the URL associated with the anomaly
condition: the condition identified as an anomaly
warning: object containing information on the detected anomaly

Field warning is an object containing the following fields:

message: a short message explaining the anomaly
type: anomaly type, the following types are currently supported:
1. =true: condition is always true
2. =false: condition is always false
3. never_reached: condition is never reached
4. controller_url_never_reached: the controller destination URL is never reached (at least one rule is always true)
5. controller_url_always_reached: the controller destination URL is always reached (all rules are always false)
6. controller_url_always_used: no rules to check, the controller URL will always be used

/urls/hub/clone

access: [WRITE]

Clone the hub configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/clone?from_url_id=6ec69f77bc25192b26d34a834b3adfb1&to_url_id=8aa30fa7f79d717bdf6455dc5650fc92

Query parameters

from_url_id = 6ec69f77bc25192b26d34a834b3adfb1
  to_url_id = 8aa30fa7f79d717bdf6455dc5650fc92

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/clone?from_url_id=6ec69f77bc25192b26d34a834b3adfb1&to_url_id=8aa30fa7f79d717bdf6455dc5650fc92&format=xml

Query parameters

from_url_id = 6ec69f77bc25192b26d34a834b3adfb1
  to_url_id = 8aa30fa7f79d717bdf6455dc5650fc92
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/clone?from_url_id=6ec69f77bc25192b26d34a834b3adfb1&to_url_id=8aa30fa7f79d717bdf6455dc5650fc92&format=txt

Query parameters

from_url_id = 6ec69f77bc25192b26d34a834b3adfb1
  to_url_id = 8aa30fa7f79d717bdf6455dc5650fc92
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/clone?from_url_id=6ec69f77bc25192b26d34a834b3adfb1&to_url_id=8aa30fa7f79d717bdf6455dc5650fc92&format=plain

Query parameters

from_url_id = 6ec69f77bc25192b26d34a834b3adfb1
  to_url_id = 8aa30fa7f79d717bdf6455dc5650fc92
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the hub configuration from
to_url_idID	ID of the tracking link you want to the hub configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/hub/conditions

/urls/hub/conditions/add

access: [WRITE]

Add a new condition to the URL hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/conditions/add?url_id=39c34e5e32333c2c41d082d5f7dddd3e&controller_id=6f4090539febbc422451354b3d0dd9b3&condition=%23language%23+%3D+%27DE%27

Query parameters

       url_id = 39c34e5e32333c2c41d082d5f7dddd3e
controller_id = 6f4090539febbc422451354b3d0dd9b3
    condition = #language# = 'DE'

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/conditions/add?url_id=39c34e5e32333c2c41d082d5f7dddd3e&controller_id=6f4090539febbc422451354b3d0dd9b3&condition=%23language%23+%3D+%27DE%27&format=xml

Query parameters

       url_id = 39c34e5e32333c2c41d082d5f7dddd3e
controller_id = 6f4090539febbc422451354b3d0dd9b3
    condition = #language# = 'DE'
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/conditions/add?url_id=39c34e5e32333c2c41d082d5f7dddd3e&controller_id=6f4090539febbc422451354b3d0dd9b3&condition=%23language%23+%3D+%27DE%27&format=txt

Query parameters

       url_id = 39c34e5e32333c2c41d082d5f7dddd3e
controller_id = 6f4090539febbc422451354b3d0dd9b3
    condition = #language# = 'DE'
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/conditions/add?url_id=39c34e5e32333c2c41d082d5f7dddd3e&controller_id=6f4090539febbc422451354b3d0dd9b3&condition=%23language%23+%3D+%27DE%27&format=plain

Query parameters

       url_id = 39c34e5e32333c2c41d082d5f7dddd3e
controller_id = 6f4090539febbc422451354b3d0dd9b3
    condition = #language# = 'DE'
       format = plain

Response

Required parameters

parameter	description
conditionHTML	if this condition is met, the engine redirects to the tracking link identified by `url_id`
controller_idID	ID of the root tracking link
url_idID	ID of the tracking link to be used if the `condition` is met

Optional parameters

parameter	description
old_url_idID	ID of the existing tracking link in the hub to be replaced with the new one identified by `url_id`

Return values

parameter	description
added	1 on success (the new condition is added/replaced), 0 otherwise

/urls/hub/conditions/check

access: [READ]

This method check the validity of a condition to be used with the hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27

Query parameters

condition = #language# = 'FR'

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": 1
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27&format=xml

Query parameters

condition = #language# = 'FR'
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>1</result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27&format=txt

Query parameters

condition = #language# = 'FR'
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27&format=plain

Query parameters

condition = #language# = 'FR'
   format = plain

Response

Required parameters

parameter	description
conditionHTML	condition to check

Return values

parameter	description
result	1 if the condition is valid, an invalid parameter error with a detailed error is returned otherwise

/urls/hub/conditions/decompile

access: [READ]

This method decompiles a condition by exploding it into parts.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27

Query parameters

condition = #language# = 'FR'

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "parts": [
      {
        "level": 0,
        "variable": "language",
        "operator": "=",
        "value": "FR"
      }
    ],
    "operators": {
      "language": {
        "=": "equal to",
        "!=": "not equal to"
      }
    },
    "values": {
      "language": {
        "AF": "Afrikaans",
        "AR": "Arabic - \u0627\u0644\u0639\u0631\u0628\u064a\u0629",
        "[...]": "[...]",
        "*": "custom (replace * with the ISO 639-1 code of the language)"
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27&format=xml

Query parameters

condition = #language# = 'FR'
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <parts>
      <i0>
        <level>0</level>  
        <variable>language</variable>  
        <operator>=</operator>  
        <value>FR</value>  
      </i0>  
    </parts>  
    <operators>
      <language>
        <=>equal to</=>  
        <!=>not equal to</!=>  
      </language>  
    </operators>  
    <values>
      <language>
        <AF>Afrikaans</AF>  
        <AR>Arabic - العربية</AR>  
        <[...]>[...]</[...]>  
        <*>custom (replace * with the ISO 639-1 code of the language)</*>  
      </language>  
    </values>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27&format=txt

Query parameters

condition = #language# = 'FR'
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_parts_0_level=0
result_parts_0_variable=language
result_parts_0_operator==
result_parts_0_value=FR
result_operators_language_==equal to
result_operators_language_!==not equal to
result_values_language_AF=Afrikaans
result_values_language_AR=Arabic - العربية
result_values_language_[...]=[...]
result_values_language_*=custom (replace * with the ISO 639-1 code of the language)

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27&format=plain

Query parameters

condition = #language# = 'FR'
   format = plain

Response

0
language
=
FR
equal to
not equal to
Afrikaans
Arabic - العربية
[...]
custom (replace * with the ISO 639-1 code of the language)

Example 5 (json)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29

Query parameters

condition = #country# != 'AT'  AND ( #language# = 'AF'  OR  #language# = 'DA' )

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "parts": [
      {
        "level": 0,
        "variable": "country",
        "operator": "!=",
        "value": "AT"
      },
      {
        "level": 0,
        "boolean": "AND"
      },
      {
        "level": 1,
        "variable": "language",
        "operator": "=",
        "value": "AF"
      },
      {
        "level": 1,
        "boolean": "OR"
      },
      {
        "level": 1,
        "variable": "language",
        "operator": "=",
        "value": "DA"
      }
    ],
    "operators": {
      "country": {
        "=": "equal to",
        "!=": "not equal to"
      },
      "language": {
        "=": "equal to",
        "!=": "not equal to"
      }
    },
    "values": {
      "country": {
        "AF": "Afghanistan (\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646)",
        "AX": "Aland Islands",
        "[...]": "[...]",
        "unk": "Other or unrecognized"
      },
      "language": {
        "AF": "Afrikaans",
        "AR": "Arabic - \u0627\u0644\u0639\u0631\u0628\u064a\u0629",
        "[...]": "[...]",
        "*": "custom (replace * with the ISO 639-1 code of the language)"
      }
    }
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29&format=xml

Query parameters

condition = #country# != 'AT'  AND ( #language# = 'AF'  OR  #language# = 'DA' )
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <parts>
      <i0>
        <level>0</level>  
        <variable>country</variable>  
        <operator>!=</operator>  
        <value>AT</value>  
      </i0>  
      <i1>
        <level>0</level>  
        <boolean>AND</boolean>  
      </i1>  
      <i2>
        <level>1</level>  
        <variable>language</variable>  
        <operator>=</operator>  
        <value>AF</value>  
      </i2>  
      <i3>
        <level>1</level>  
        <boolean>OR</boolean>  
      </i3>  
      <i4>
        <level>1</level>  
        <variable>language</variable>  
        <operator>=</operator>  
        <value>DA</value>  
      </i4>  
    </parts>  
    <operators>
      <country>
        <=>equal to</=>  
        <!=>not equal to</!=>  
      </country>  
      <language>
        <=>equal to</=>  
        <!=>not equal to</!=>  
      </language>  
    </operators>  
    <values>
      <country>
        <AF>Afghanistan (افغانستان)</AF>  
        <AX>Aland Islands</AX>  
        <[...]>[...]</[...]>  
        <unk>Other or unrecognized</unk>  
      </country>  
      <language>
        <AF>Afrikaans</AF>  
        <AR>Arabic - العربية</AR>  
        <[...]>[...]</[...]>  
        <*>custom (replace * with the ISO 639-1 code of the language)</*>  
      </language>  
    </values>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29&format=txt

Query parameters

condition = #country# != 'AT'  AND ( #language# = 'AF'  OR  #language# = 'DA' )
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_parts_0_level=0
result_parts_0_variable=country
result_parts_0_operator=!=
result_parts_0_value=AT
result_parts_1_level=0
result_parts_1_boolean=AND
result_parts_2_level=1
result_parts_2_variable=language
result_parts_2_operator==
result_parts_2_value=AF
result_parts_3_level=1
result_parts_3_boolean=OR
result_parts_4_level=1
result_parts_4_variable=language
result_parts_4_operator==
result_parts_4_value=DA
result_operators_country_==equal to
result_operators_country_!==not equal to
result_operators_language_==equal to
result_operators_language_!==not equal to
result_values_country_AF=Afghanistan (افغانستان)
result_values_country_AX=Aland Islands
result_values_country_[...]=[...]
result_values_country_unk=Other or unrecognized
result_values_language_AF=Afrikaans
result_values_language_AR=Arabic - العربية
result_values_language_[...]=[...]
result_values_language_*=custom (replace * with the ISO 639-1 code of the language)

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29&format=plain

Query parameters

condition = #country# != 'AT'  AND ( #language# = 'AF'  OR  #language# = 'DA' )
   format = plain

Response

0
country
!=
AT
0
AND
1
language
=
AF
1
OR
1
language
=
DA
equal to
not equal to
equal to
not equal to
Afghanistan (افغانستان)
Aland Islands
[...]
Other or unrecognized
Afrikaans
Arabic - العربية
[...]
custom (replace * with the ISO 639-1 code of the language)

Required parameters

parameter	description
conditionHTML	condition to decompile

Return values

parameter	description
operators	foreach varible in `parts`, it contains the allowed operators
parts	parts of the condition in the format (level,variable,operator,value) or (level,boolean), where `level` is the variable of the boolean level (variables/booleans with the same level must be considered in brackets), `variable` is its name, `operator` and `value` are its operator and value, respectively; `boolean` can be `AND` or `OR`
values	foreach varible in `parts`, it contains the allowed values

/urls/hub/conditions/delete

access: [WRITE]

This method allows you to remove a tracking link from the URL hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=735cb5bca4fe8c7651447e0a400c2192&controller_id=d6524cab0aed396f987dcbb4287ccdaf

Query parameters

       url_id = 735cb5bca4fe8c7651447e0a400c2192
controller_id = d6524cab0aed396f987dcbb4287ccdaf

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1,
    "isActive": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=735cb5bca4fe8c7651447e0a400c2192&controller_id=d6524cab0aed396f987dcbb4287ccdaf&format=xml

Query parameters

       url_id = 735cb5bca4fe8c7651447e0a400c2192
controller_id = d6524cab0aed396f987dcbb4287ccdaf
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
    <isActive>1</isActive>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=735cb5bca4fe8c7651447e0a400c2192&controller_id=d6524cab0aed396f987dcbb4287ccdaf&format=txt

Query parameters

       url_id = 735cb5bca4fe8c7651447e0a400c2192
controller_id = d6524cab0aed396f987dcbb4287ccdaf
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
result_isActive=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=735cb5bca4fe8c7651447e0a400c2192&controller_id=d6524cab0aed396f987dcbb4287ccdaf&format=plain

Query parameters

       url_id = 735cb5bca4fe8c7651447e0a400c2192
controller_id = d6524cab0aed396f987dcbb4287ccdaf
       format = plain

Response

1
1

Required parameters

parameter	description
controller_idID	ID of the root tracking link
url_idID	ID of the tracking link to remove

Return values

parameter	description
deleted	1 on success (the new tracking link is deleted), 0 otherwise
isActive	1 if the hub is still active after deleting the tracking link identified by `url_id` (i.e., the hub has at least 2 tracking links, including the root tracking link), 0 otherwise

/urls/hub/conditions/order

access: [WRITE]

This method allows you to set the order for the tracking links of a hub URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=f75e09f1345c23f6bf2b50063f76f2ea&ids%5B0%5D=e6edc86387370d37bdbcf29fb37799c9&ids%5B1%5D=f41df425c448e85d784a0559d4e577ca&orders%5B0%5D=2&orders%5B1%5D=1

Query parameters

controller_id = f75e09f1345c23f6bf2b50063f76f2ea
       ids[0] = e6edc86387370d37bdbcf29fb37799c9
       ids[1] = f41df425c448e85d784a0559d4e577ca
    orders[0] = 2
    orders[1] = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "modified": 2,
    "isActive": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=f75e09f1345c23f6bf2b50063f76f2ea&ids%5B0%5D=e6edc86387370d37bdbcf29fb37799c9&ids%5B1%5D=f41df425c448e85d784a0559d4e577ca&orders%5B0%5D=2&orders%5B1%5D=1&format=xml

Query parameters

controller_id = f75e09f1345c23f6bf2b50063f76f2ea
       ids[0] = e6edc86387370d37bdbcf29fb37799c9
       ids[1] = f41df425c448e85d784a0559d4e577ca
    orders[0] = 2
    orders[1] = 1
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <modified>2</modified>  
    <isActive>1</isActive>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=f75e09f1345c23f6bf2b50063f76f2ea&ids%5B0%5D=e6edc86387370d37bdbcf29fb37799c9&ids%5B1%5D=f41df425c448e85d784a0559d4e577ca&orders%5B0%5D=2&orders%5B1%5D=1&format=txt

Query parameters

controller_id = f75e09f1345c23f6bf2b50063f76f2ea
       ids[0] = e6edc86387370d37bdbcf29fb37799c9
       ids[1] = f41df425c448e85d784a0559d4e577ca
    orders[0] = 2
    orders[1] = 1
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_modified=2
result_isActive=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=f75e09f1345c23f6bf2b50063f76f2ea&ids%5B0%5D=e6edc86387370d37bdbcf29fb37799c9&ids%5B1%5D=f41df425c448e85d784a0559d4e577ca&orders%5B0%5D=2&orders%5B1%5D=1&format=plain

Query parameters

controller_id = f75e09f1345c23f6bf2b50063f76f2ea
       ids[0] = e6edc86387370d37bdbcf29fb37799c9
       ids[1] = f41df425c448e85d784a0559d4e577ca
    orders[0] = 2
    orders[1] = 1
       format = plain

Response

2
1

Required parameters

parameter	description
controller_idID	ID of the root tracking link
idsARRAY_OF_IDS	list of tracking link IDs for which to set the order
ordersARRAY	list of integers defining the order of tracking links identified by `ids`

Return values

parameter	description
isActive	1 if the hub is still active after reordering the tracking links, 0 otherwise
modified	tracking link number whose ordering has actually changed

/urls/hub/debug

access: [READ]

Get a debug URL for a specific hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/debug?controller_id=287cd5be6bf2f62a1d21ef06dee56505

Query parameters

controller_id = 287cd5be6bf2f62a1d21ef06dee56505

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "debug_url": "https:\/\/jo.my\/joturl?9774AA75!dbg",
    "valid_until": "2026-05-26T14:00:32+00:00"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/debug?controller_id=287cd5be6bf2f62a1d21ef06dee56505&format=xml

Query parameters

controller_id = 287cd5be6bf2f62a1d21ef06dee56505
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <debug_url>https://jo.my/joturl?9774AA75!dbg</debug_url>  
    <valid_until>2026-05-26T14:00:32+00:00</valid_until>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/debug?controller_id=287cd5be6bf2f62a1d21ef06dee56505&format=txt

Query parameters

controller_id = 287cd5be6bf2f62a1d21ef06dee56505
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_debug_url=https://jo.my/joturl?9774AA75!dbg
result_valid_until=2026-05-26T14:00:32+00:00

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/debug?controller_id=287cd5be6bf2f62a1d21ef06dee56505&format=plain

Query parameters

controller_id = 287cd5be6bf2f62a1d21ef06dee56505
       format = plain

Response

https://jo.my/joturl?9774AA75!dbg
2026-05-26T14:00:32+00:00

Required parameters

parameter	description
controller_idID	ID of the root tracking link

Return values

parameter	description
debug_url	debug URL
valid_until	expiration date for the debug URL (ISO 8601 date format, e.g., 2026-05-26T14:00:32+00:00)

/urls/hub/delete

access: [WRITE]

Delete a URL hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/delete?controller_id=f8c625114ab9931ef4105cad31a3c3e5

Query parameters

controller_id = f8c625114ab9931ef4105cad31a3c3e5

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/delete?controller_id=f8c625114ab9931ef4105cad31a3c3e5&format=xml

Query parameters

controller_id = f8c625114ab9931ef4105cad31a3c3e5
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/delete?controller_id=f8c625114ab9931ef4105cad31a3c3e5&format=txt

Query parameters

controller_id = f8c625114ab9931ef4105cad31a3c3e5
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/delete?controller_id=f8c625114ab9931ef4105cad31a3c3e5&format=plain

Query parameters

controller_id = f8c625114ab9931ef4105cad31a3c3e5
       format = plain

Response

Required parameters

parameter	description
controller_idID	ID of the tracking link from which to remove a URL hub

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/hub/info

access: [READ]

Returns the URLs associated with a URL hub.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/info?controller_id=bbe88aa5c0939e27230cf7c096bf8059

Query parameters

controller_id = bbe88aa5c0939e27230cf7c096bf8059

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    {
      "url_id": "25f84a83472311739c36bed299e795a1",
      "short_url": "https:\/\/jo.my\/tracking_link_condition_1",
      "condition": "#language# = 'IT'"
    },
    {
      "url_id": "c5ee1d4be9a24e79ef3f9ab9a65a789b",
      "short_url": "https:\/\/jo.my\/tracking_link_condition_2",
      "condition": "#language# = 'DE'"
    }
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/info?controller_id=bbe88aa5c0939e27230cf7c096bf8059&format=xml

Query parameters

controller_id = bbe88aa5c0939e27230cf7c096bf8059
       format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>
      <url_id>25f84a83472311739c36bed299e795a1</url_id>  
      <short_url>https://jo.my/tracking_link_condition_1</short_url>  
      <condition>#language# = 'IT'</condition>  
    </i0>  
    <i1>
      <url_id>c5ee1d4be9a24e79ef3f9ab9a65a789b</url_id>  
      <short_url>https://jo.my/tracking_link_condition_2</short_url>  
      <condition>#language# = 'DE'</condition>  
    </i1>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/info?controller_id=bbe88aa5c0939e27230cf7c096bf8059&format=txt

Query parameters

controller_id = bbe88aa5c0939e27230cf7c096bf8059
       format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0_url_id=25f84a83472311739c36bed299e795a1
result_0_short_url=https://jo.my/tracking_link_condition_1
result_0_condition=#language# = 'IT'
result_1_url_id=c5ee1d4be9a24e79ef3f9ab9a65a789b
result_1_short_url=https://jo.my/tracking_link_condition_2
result_1_condition=#language# = 'DE'

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/info?controller_id=bbe88aa5c0939e27230cf7c096bf8059&format=plain

Query parameters

controller_id = bbe88aa5c0939e27230cf7c096bf8059
       format = plain

Response

https://jo.my/tracking_link_condition_1
https://jo.my/tracking_link_condition_2

Required parameters

parameter	description
controller_idID	ID of the controller tracking link

Return values

parameter	description
data	array of objects in the format ( `url_id`, `short_url`, `condition`), where `url_id` is the tracking link ID, `short_url` is the tracking link itself and `condition` is the condition to be satisfied to redirect to the aforementioned tracking link. A maximum of 100 items are returned (the limit on the number of conditions that can be created)

/urls/hub/variable

access: [READ]

This method returns a list of variables that can be used with the Smart Redirector. Furthermore, if parameter name is passed, possible accepted operators and values are returned.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/hub/variable

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "variables": {
      "language": "Language",
      "country": "Country",
      "os": "Operating system",
      "os_version": "Operating system version",
      "mobile_device": "Mobile device",
      "browser": "Browser",
      "browser_type": "Browser type",
      "browser_version": "Main browser version",
      "visits": "Visits",
      "unique_visits": "Unique visits",
      "is_qrcode": "QR-Code?",
      "visited": "Already visited?",
      "time": "Time (UTC)",
      "datetime": "Date\/Time (UTC)",
      "referrer": "Referrer",
      "user_agent": "User agent"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/hub/variable?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <variables>
      <language>Language</language>  
      <country>Country</country>  
      <os>Operating system</os>  
      <os_version>Operating system version</os_version>  
      <mobile_device>Mobile device</mobile_device>  
      <browser>Browser</browser>  
      <browser_type>Browser type</browser_type>  
      <browser_version>Main browser version</browser_version>  
      <visits>Visits</visits>  
      <unique_visits>Unique visits</unique_visits>  
      <is_qrcode>QR-Code?</is_qrcode>  
      <visited>Already visited?</visited>  
      <time>Time (UTC)</time>  
      <datetime>Date/Time (UTC)</datetime>  
      <referrer>Referrer</referrer>  
      <user_agent>User agent</user_agent>  
    </variables>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/hub/variable?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_variables_language=Language
result_variables_country=Country
result_variables_os=Operating system
result_variables_os_version=Operating system version
result_variables_mobile_device=Mobile device
result_variables_browser=Browser
result_variables_browser_type=Browser type
result_variables_browser_version=Main browser version
result_variables_visits=Visits
result_variables_unique_visits=Unique visits
result_variables_is_qrcode=QR-Code?
result_variables_visited=Already visited?
result_variables_time=Time (UTC)
result_variables_datetime=Date/Time (UTC)
result_variables_referrer=Referrer
result_variables_user_agent=User agent

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/hub/variable?format=plain

Query parameters

format = plain

Response

Language
Country
Operating system
Operating system version
Mobile device
Browser
Browser type
Main browser version
Visits
Unique visits
QR-Code?
Already visited?
Time (UTC)
Date/Time (UTC)
Referrer
User agent

Example 5 (json)

Request

https://joturl.com/a/i1/urls/hub/variable?0=14

Query parameters

0 = 14

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": []
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/hub/variable?0=14&format=xml

Query parameters

     0 = 14
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>

  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/hub/variable?0=14&format=txt

Query parameters

     0 = 14
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result=

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/hub/variable?0=14&format=plain

Query parameters

     0 = 14
format = plain

Response

Optional parameters

parameter	description
nameSTRING	name of the variable for which to extract the possible operators and values

Return values

parameter	description
operators	[OPTIONAL] array containing a list of available operators for the given variable `name`, it is passed only if `name` is passed
values	[OPTIONAL] array containing a list of available values for the given variable `name`, it is passed only if `name` is passed
variables	array containing a list of available variables

/urls/import

access: [WRITE]

This method import tracking links into a specific project.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/import?domain_id=2ca864dac296f6b8da5fad253f05050d

Query parameters

domain_id = 2ca864dac296f6b8da5fad253f05050d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "imported": 551,
    "errors": []
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/import?domain_id=2ca864dac296f6b8da5fad253f05050d&format=xml

Query parameters

domain_id = 2ca864dac296f6b8da5fad253f05050d
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <imported>551</imported>  
    <errors>

    </errors>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/import?domain_id=2ca864dac296f6b8da5fad253f05050d&format=txt

Query parameters

domain_id = 2ca864dac296f6b8da5fad253f05050d
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_imported=551
result_errors=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/import?domain_id=2ca864dac296f6b8da5fad253f05050d&format=plain

Query parameters

domain_id = 2ca864dac296f6b8da5fad253f05050d
   format = plain

Response

Required parameters

parameter	description
domain_idID	ID of the domain on which to import tracking links
inputSTRING	name of the HTML form field that is used to transfer the CSV file

Optional parameters

parameter	description
check_onlyBOOLEAN	if 1 only a file check is required, no tracking link will be imported, default: 0
csv_has_headerBOOLEAN	1 if the CSV file has a header line, default: 0
csv_sepSTRING	CSV delimiter, default: ; (semicolon)
project_idID	ID of the project on which to import tracking links, if not specified the `default` will be used

Return values

parameter	description
_accepted_id	ID to be used to retrieve the current import status or to stop the import procedure
_accepted_key	a string representing the current import operation
_accepted_perc	percentage of completion of the import (floating point number)
check_only	echo back of the input parameter `check_only`
csv_has_header	echo back of the input parameter `csv_has_header`
csv_sep	echo back of the input parameter `csv_sep`
domain_id	echo back of the input parameter `domain_id`
errors	array containing errors that occurred during the import (one element for each error)
imported	number of imported tracking links
project_id	echo back of the input parameter `project_id`

/urls/info

access: [READ]

This method returns the info about a tracking link, returned fields are specified by parameter fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/info?fields=id,short_url&id=ef28479bdb066b2c31d90fb0db372e4f

Query parameters

fields = id,short_url
    id = ef28479bdb066b2c31d90fb0db372e4f

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "ef28479bdb066b2c31d90fb0db372e4f",
        "short_url": "http:\/\/jo.my\/5747d5c1"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/info?fields=id,short_url&id=ef28479bdb066b2c31d90fb0db372e4f&format=xml

Query parameters

fields = id,short_url
    id = ef28479bdb066b2c31d90fb0db372e4f
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>ef28479bdb066b2c31d90fb0db372e4f</id>  
        <short_url>http://jo.my/5747d5c1</short_url>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/info?fields=id,short_url&id=ef28479bdb066b2c31d90fb0db372e4f&format=txt

Query parameters

fields = id,short_url
    id = ef28479bdb066b2c31d90fb0db372e4f
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=ef28479bdb066b2c31d90fb0db372e4f
result_data_0_short_url=http://jo.my/5747d5c1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/info?fields=id,short_url&id=ef28479bdb066b2c31d90fb0db372e4f&format=plain

Query parameters

fields = id,short_url
    id = ef28479bdb066b2c31d90fb0db372e4f
format = plain

Response

http://jo.my/5747d5c1

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, see method i1/urls/list for reference
idID	ID of the tracking link whose information is required

Return values

parameter	description
data	array containing 1 item on success, the returned information depends on the fields parameter.

/urls/instaurls

/urls/instaurls/clone

access: [WRITE]

Clone the InstaUrl configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=3c15f1d8fef09977a52cb8802c780598&to_url_id=b1a1c54990db8fe53a87d59c7771e886

Query parameters

from_url_id = 3c15f1d8fef09977a52cb8802c780598
  to_url_id = b1a1c54990db8fe53a87d59c7771e886

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=3c15f1d8fef09977a52cb8802c780598&to_url_id=b1a1c54990db8fe53a87d59c7771e886&format=xml

Query parameters

from_url_id = 3c15f1d8fef09977a52cb8802c780598
  to_url_id = b1a1c54990db8fe53a87d59c7771e886
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=3c15f1d8fef09977a52cb8802c780598&to_url_id=b1a1c54990db8fe53a87d59c7771e886&format=txt

Query parameters

from_url_id = 3c15f1d8fef09977a52cb8802c780598
  to_url_id = b1a1c54990db8fe53a87d59c7771e886
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=3c15f1d8fef09977a52cb8802c780598&to_url_id=b1a1c54990db8fe53a87d59c7771e886&format=plain

Query parameters

from_url_id = 3c15f1d8fef09977a52cb8802c780598
  to_url_id = b1a1c54990db8fe53a87d59c7771e886
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the InstaUrl configuration from
to_url_idID	ID of the tracking link you want to the InstaUrl configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/instaurls/delete

access: [WRITE]

Delete InstaUrl settings for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/delete?id=85bca1dad7c4b6ad299eb00e6380c4d3

Query parameters

id = 85bca1dad7c4b6ad299eb00e6380c4d3

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/instaurls/delete?id=85bca1dad7c4b6ad299eb00e6380c4d3&format=xml

Query parameters

    id = 85bca1dad7c4b6ad299eb00e6380c4d3
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/instaurls/delete?id=85bca1dad7c4b6ad299eb00e6380c4d3&format=txt

Query parameters

    id = 85bca1dad7c4b6ad299eb00e6380c4d3
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/instaurls/delete?id=85bca1dad7c4b6ad299eb00e6380c4d3&format=plain

Query parameters

    id = 85bca1dad7c4b6ad299eb00e6380c4d3
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove an InstaUrl configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/instaurls/icons

/urls/instaurls/icons/info

access: [READ]

This method returns info on a SVG icon for InstaUrl.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/icons/info?id=fe06529f18b28716fbc4e60192bcdc54

Query parameters

id = fe06529f18b28716fbc4e60192bcdc54

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "fe06529f18b28716fbc4e60192bcdc54",
    "svg": "<svg>[...]<\/svg>"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/instaurls/icons/info?id=fe06529f18b28716fbc4e60192bcdc54&format=xml

Query parameters

    id = fe06529f18b28716fbc4e60192bcdc54
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>fe06529f18b28716fbc4e60192bcdc54</id>  
    <svg><[CDATA[&lt;svg&gt;[...]&lt;/svg&gt;]]></svg>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/instaurls/icons/info?id=fe06529f18b28716fbc4e60192bcdc54&format=txt

Query parameters

    id = fe06529f18b28716fbc4e60192bcdc54
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=fe06529f18b28716fbc4e60192bcdc54
result_svg=&lt;svg&gt;[...]&lt;/svg&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/instaurls/icons/info?id=fe06529f18b28716fbc4e60192bcdc54&format=plain

Query parameters

    id = fe06529f18b28716fbc4e60192bcdc54
format = plain

Response

fe06529f18b28716fbc4e60192bcdc54
&lt;svg&gt;[...]&lt;/svg&gt;

Required parameters

parameter	description
idSTRING	ID of the icon as returned by the i1/urls/instaurls/icons/list method

Return values

parameter	description
svg	SVG of the requested icon

/urls/instaurls/icons/list

access: [READ]

This method returns a list of SVG icons for InstaUrl.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/icons/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1590,
    "icons": {
      "id": "3054b4cab977897b89044e5e35ba8246",
      "svg": "<svg>[...]<\/svg>"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/instaurls/icons/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1590</count>  
    <icons>
      <id>3054b4cab977897b89044e5e35ba8246</id>  
      <svg><[CDATA[&lt;svg&gt;[...]&lt;/svg&gt;]]></svg>  
    </icons>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/instaurls/icons/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1590
result_icons_id=3054b4cab977897b89044e5e35ba8246
result_icons_svg=&lt;svg&gt;[...]&lt;/svg&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/instaurls/icons/list?format=plain

Query parameters

format = plain

Response

1590
3054b4cab977897b89044e5e35ba8246
&lt;svg&gt;[...]&lt;/svg&gt;

Optional parameters

parameter	description
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
searchSTRING	filters items to be extracted by searching them
startINTEGER	starts to extract items from this position

Return values

parameter	description
count	total number of icons
icons	array containing icons in the format {"id":"[id of the icon]","svg":"[SVG of the icon"}

/urls/jotbars

/urls/jotbars/clone

access: [WRITE]

Clone the jotbar configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=67e59919a7c6c5a3e5e1f1037d8375e3&to_url_id=4ff5d7929dc03adab4ef730e8ffd82e9

Query parameters

from_url_id = 67e59919a7c6c5a3e5e1f1037d8375e3
  to_url_id = 4ff5d7929dc03adab4ef730e8ffd82e9

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=67e59919a7c6c5a3e5e1f1037d8375e3&to_url_id=4ff5d7929dc03adab4ef730e8ffd82e9&format=xml

Query parameters

from_url_id = 67e59919a7c6c5a3e5e1f1037d8375e3
  to_url_id = 4ff5d7929dc03adab4ef730e8ffd82e9
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=67e59919a7c6c5a3e5e1f1037d8375e3&to_url_id=4ff5d7929dc03adab4ef730e8ffd82e9&format=txt

Query parameters

from_url_id = 67e59919a7c6c5a3e5e1f1037d8375e3
  to_url_id = 4ff5d7929dc03adab4ef730e8ffd82e9
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=67e59919a7c6c5a3e5e1f1037d8375e3&to_url_id=4ff5d7929dc03adab4ef730e8ffd82e9&format=plain

Query parameters

from_url_id = 67e59919a7c6c5a3e5e1f1037d8375e3
  to_url_id = 4ff5d7929dc03adab4ef730e8ffd82e9
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the jotbar configuration from
to_url_idID	ID of the tracking link you want to the jotbar configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/jotbars/delete

access: [WRITE]

Remove a jotbar option for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/jotbars/delete?id=621a071118f253b3132d4ab6e4575f65

Query parameters

id = 621a071118f253b3132d4ab6e4575f65

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/jotbars/delete?id=621a071118f253b3132d4ab6e4575f65&format=xml

Query parameters

    id = 621a071118f253b3132d4ab6e4575f65
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/jotbars/delete?id=621a071118f253b3132d4ab6e4575f65&format=txt

Query parameters

    id = 621a071118f253b3132d4ab6e4575f65
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/jotbars/delete?id=621a071118f253b3132d4ab6e4575f65&format=plain

Query parameters

    id = 621a071118f253b3132d4ab6e4575f65
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a jotbar configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/jotbars/edit

access: [WRITE]

Set a jotbar option for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/jotbars/edit?id=5652c7b6979580eec0d23153c24c57cd&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D

Query parameters

                   id = 5652c7b6979580eec0d23153c24c57cd
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/jotbars/edit?id=5652c7b6979580eec0d23153c24c57cd&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=xml

Query parameters

                   id = 5652c7b6979580eec0d23153c24c57cd
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
               format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/jotbars/edit?id=5652c7b6979580eec0d23153c24c57cd&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=txt

Query parameters

                   id = 5652c7b6979580eec0d23153c24c57cd
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
               format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/jotbars/edit?id=5652c7b6979580eec0d23153c24c57cd&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=plain

Query parameters

                   id = 5652c7b6979580eec0d23153c24c57cd
                 logo = https://joturl.com/logo.svg
             logo_url = https://joturl.com/
             template = right
        template_size = big
            languages = en,it
     default_language = 
user_default_language = en
                 info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
               format = plain

Response

Required parameters

parameter	description
idID	ID of the project

Optional parameters

parameter	description
embed_codeHTML	embed code for videos (for example the YouTube embedding code <iframe ...></iframe>), if available
infoJSON	JSON containing page_title, description_title, description, questions_title, questions for each language in languages, see i1/urls/jotbars/info for details on info
logoSTRING	0 to disable logo, the URL of the logo to be shown, empty or `null` to inherit the configuration from the account-level settings
logo_urlSTRING	when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo
show_feedbackSTRING	1 to show feedback, 0 to do not show it, empty or `null` to inherit the configuration from the account-level settings
templateSTRING	position of the jotbar, empty or `null` to inherit the configuration from the account-level settings, for available positions see i1/jotbars/property
template_sizeSTRING	dimension of the jotbar, empty or `null` to inherit the configuration from the account-level settings,for available dimensions see i1/jotbars/property
video_durationSTRING	it represents the duration of the video in embed_code, if available

Return values

parameter	description
data	NA

/urls/jotbars/info

access: [READ]

Get jotbar information of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/jotbars/info?id=91baf8803a9c17aa64c8c5d81d6e9222

Query parameters

id = 91baf8803a9c17aa64c8c5d81d6e9222

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "logo": "https:\/\/joturl.com\/logo.svg",
    "logo_url": "https:\/\/joturl.com\/",
    "template": "right",
    "template_size": "big",
    "show_feedback": null,
    "embed_code": null,
    "video_duration": null,
    "info": {
      "en": {
        "page_title": "English page title",
        "description_title": null,
        "description": "<p>[EN] HTML description<\/p>",
        "questions_title": null,
        "questions": "<p>[EN] HTML questions<\/p>"
      },
      "it": {
        "page_title": "Titolo pagina in italiano",
        "description_title": null,
        "description": "<p>[IT] HTML description<\/p>",
        "questions_title": null,
        "questions": "<p>[IT] HTML questions<\/p>"
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/jotbars/info?id=91baf8803a9c17aa64c8c5d81d6e9222&format=xml

Query parameters

    id = 91baf8803a9c17aa64c8c5d81d6e9222
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <logo>https://joturl.com/logo.svg</logo>  
    <logo_url>https://joturl.com/</logo_url>  
    <template>right</template>  
    <template_size>big</template_size>  
    <show_feedback></show_feedback>  
    <embed_code></embed_code>  
    <video_duration></video_duration>  
    <info>
      <en>
        <page_title>English page title</page_title>  
        <description_title></description_title>  
        <description><[CDATA[&lt;p&gt;[EN] HTML description&lt;/p&gt;]]></description>  
        <questions_title></questions_title>  
        <questions><[CDATA[&lt;p&gt;[EN] HTML questions&lt;/p&gt;]]></questions>  
      </en>  
      <it>
        <page_title>Titolo pagina in italiano</page_title>  
        <description_title></description_title>  
        <description><[CDATA[&lt;p&gt;[IT] HTML description&lt;/p&gt;]]></description>  
        <questions_title></questions_title>  
        <questions><[CDATA[&lt;p&gt;[IT] HTML questions&lt;/p&gt;]]></questions>  
      </it>  
    </info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/jotbars/info?id=91baf8803a9c17aa64c8c5d81d6e9222&format=txt

Query parameters

    id = 91baf8803a9c17aa64c8c5d81d6e9222
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_logo=https://joturl.com/logo.svg
result_logo_url=https://joturl.com/
result_template=right
result_template_size=big
result_show_feedback=
result_embed_code=
result_video_duration=
result_info_en_page_title=English page title
result_info_en_description_title=
result_info_en_description=&lt;p&gt;[EN] HTML description&lt;/p&gt;
result_info_en_questions_title=
result_info_en_questions=&lt;p&gt;[EN] HTML questions&lt;/p&gt;
result_info_it_page_title=Titolo pagina in italiano
result_info_it_description_title=
result_info_it_description=&lt;p&gt;[IT] HTML description&lt;/p&gt;
result_info_it_questions_title=
result_info_it_questions=&lt;p&gt;[IT] HTML questions&lt;/p&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/jotbars/info?id=91baf8803a9c17aa64c8c5d81d6e9222&format=plain

Query parameters

    id = 91baf8803a9c17aa64c8c5d81d6e9222
format = plain

Response

https://joturl.com/logo.svg
https://joturl.com/
right
big



English page title

&lt;p&gt;[EN] HTML description&lt;/p&gt;

&lt;p&gt;[EN] HTML questions&lt;/p&gt;
Titolo pagina in italiano

&lt;p&gt;[IT] HTML description&lt;/p&gt;

&lt;p&gt;[IT] HTML questions&lt;/p&gt;

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
embed_code	embed code for videos (for example the YouTube embedding code <iframe ...></iframe>), if available
info	for each language in languages, it contains page_title, description_title, description, questions_title, questions, see the following notes for details
logo	0 to disable logo, the URL of the logo to be shown, empty or `null` to inherit the configuration from the account-level settings
logo_url	when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo
show_feedback	1 to show feedback, 0 to do not show it, empty or `null` to inherit the configuration from the account-level settings
template	position of the jotbar, for available positions see i1/jotbars/property
template_size	dimension of the jotbar, for available dimensions see i1/jotbars/property
video_duration	it represents the duration of the video in embed_code, if available

/urls/languages

/urls/languages/list

access: [READ]

This method returns a list of available languages for specific options (e.g., Masking, jotBar) of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/languages/list?id=b0bc11ffed3b5dfaf8f342c6b5c2386c

Query parameters

id = b0bc11ffed3b5dfaf8f342c6b5c2386c

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    {
      "name": "en",
      "label": "English"
    },
    {
      "name": "it",
      "label": "Italiano"
    }
  ]
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/languages/list?id=b0bc11ffed3b5dfaf8f342c6b5c2386c&format=xml

Query parameters

    id = b0bc11ffed3b5dfaf8f342c6b5c2386c
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>
      <name>en</name>  
      <label>English</label>  
    </i0>  
    <i1>
      <name>it</name>  
      <label>Italiano</label>  
    </i1>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/languages/list?id=b0bc11ffed3b5dfaf8f342c6b5c2386c&format=txt

Query parameters

    id = b0bc11ffed3b5dfaf8f342c6b5c2386c
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0_name=en
result_0_label=English
result_1_name=it
result_1_label=Italiano

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/languages/list?id=b0bc11ffed3b5dfaf8f342c6b5c2386c&format=plain

Query parameters

    id = b0bc11ffed3b5dfaf8f342c6b5c2386c
format = plain

Response

en
English
it
Italiano

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
[ARRAY]	array containing available languages

/urls/last

access: [READ]

This method returns the list of the last 100 tracking links strictly created by the logged user. Returned fields are that specified in the parameter fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/last?fields=id,short_url,creation

Query parameters

fields = id,short_url,creation

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "creation": "2026-05-26 14:00:32",
        "id": "f73450d5982dd5d37508e4aa99529963",
        "short_url": "http:\/\/jo.my\/cebf485f"
      },
      {
        "creation": "2026-05-26 13:00:32",
        "id": "aecbecacf9a451d4c60ea621aed03989",
        "short_url": "http:\/\/jo.my\/3f36a75f"
      },
      {
        "creation": "2026-05-26 12:00:32",
        "id": "05caf7ba816c8ae38ed0c729e012fa22",
        "short_url": "http:\/\/jo.my\/3d9957a3"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/last?fields=id,short_url,creation&format=xml

Query parameters

fields = id,short_url,creation
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <creation>2026-05-26 14:00:32</creation>  
        <id>f73450d5982dd5d37508e4aa99529963</id>  
        <short_url>http://jo.my/cebf485f</short_url>  
      </i0>  
      <i1>
        <creation>2026-05-26 13:00:32</creation>  
        <id>aecbecacf9a451d4c60ea621aed03989</id>  
        <short_url>http://jo.my/3f36a75f</short_url>  
      </i1>  
      <i2>
        <creation>2026-05-26 12:00:32</creation>  
        <id>05caf7ba816c8ae38ed0c729e012fa22</id>  
        <short_url>http://jo.my/3d9957a3</short_url>  
      </i2>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/last?fields=id,short_url,creation&format=txt

Query parameters

fields = id,short_url,creation
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_creation=2026-05-26 14:00:32
result_data_0_id=f73450d5982dd5d37508e4aa99529963
result_data_0_short_url=http://jo.my/cebf485f
result_data_1_creation=2026-05-26 13:00:32
result_data_1_id=aecbecacf9a451d4c60ea621aed03989
result_data_1_short_url=http://jo.my/3f36a75f
result_data_2_creation=2026-05-26 12:00:32
result_data_2_id=05caf7ba816c8ae38ed0c729e012fa22
result_data_2_short_url=http://jo.my/3d9957a3

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/last?fields=id,short_url,creation&format=plain

Query parameters

fields = id,short_url,creation
format = plain

Response

http://jo.my/cebf485f
http://jo.my/3f36a75f
http://jo.my/3d9957a3

Required parameters

parameter	description
fieldsARRAY	see method i1/urls/list for reference

Optional parameters

parameter	description
end_dateDATE	see method i1/urls/list for reference
filterSTRING	see method i1/urls/list for reference
is_tracking_pixelBOOLEAN	see method i1/urls/list for reference
lengthINTEGER	see method i1/urls/list for reference
optionSTRING	see method i1/urls/list for reference
orderbyARRAY	orders items by field (see method i1/urls/list for reference). Default is `orderby = creation`
project_idID	ID of the project, if empty or unspecified, this method returns last-created tracking links for the whole account
searchSTRING	see method i1/urls/list for reference
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order. Default is `sort = DESC`
startINTEGER	see method i1/urls/list for reference
start_dateDATE	see method i1/urls/list for reference
whereSTRING	see method i1/urls/list for reference
with_alertsBOOLEAN	see method i1/urls/list for reference

Return values

parameter	description
count	see method i1/urls/list for reference
data	see method i1/urls/list for reference

/urls/list

access: [READ]

This method returns a list of tracking links' data, returned fields are specified by parameter fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=7c00219811e47cd22e20ce6d208d1933

Query parameters

    fields = id,short_url
project_id = 7c00219811e47cd22e20ce6d208d1933

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "685ee89ddea4d9d469a4d232d9756d15",
        "short_url": "http:\/\/jo.my\/a37ef4e0"
      },
      {
        "id": "ed5cc3ba6bc57841e314761761791612",
        "short_url": "http:\/\/jo.my\/64e9bfaf"
      },
      {
        "id": "8aa24ad780443b7f67c5f1acf7d94a10",
        "short_url": "http:\/\/jo.my\/23e1e8d9"
      },
      {
        "id": "50c94f4cd94abab17902fe3b0c2f5473",
        "short_url": "http:\/\/jo.my\/39a298e8"
      },
      {
        "id": "b117311886bdd89311e7aa5a1de31120",
        "short_url": "http:\/\/jo.my\/6b5f5d2d"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=7c00219811e47cd22e20ce6d208d1933&format=xml

Query parameters

    fields = id,short_url
project_id = 7c00219811e47cd22e20ce6d208d1933
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>685ee89ddea4d9d469a4d232d9756d15</id>  
        <short_url>http://jo.my/a37ef4e0</short_url>  
      </i0>  
      <i1>
        <id>ed5cc3ba6bc57841e314761761791612</id>  
        <short_url>http://jo.my/64e9bfaf</short_url>  
      </i1>  
      <i2>
        <id>8aa24ad780443b7f67c5f1acf7d94a10</id>  
        <short_url>http://jo.my/23e1e8d9</short_url>  
      </i2>  
      <i3>
        <id>50c94f4cd94abab17902fe3b0c2f5473</id>  
        <short_url>http://jo.my/39a298e8</short_url>  
      </i3>  
      <i4>
        <id>b117311886bdd89311e7aa5a1de31120</id>  
        <short_url>http://jo.my/6b5f5d2d</short_url>  
      </i4>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=7c00219811e47cd22e20ce6d208d1933&format=txt

Query parameters

    fields = id,short_url
project_id = 7c00219811e47cd22e20ce6d208d1933
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=685ee89ddea4d9d469a4d232d9756d15
result_data_0_short_url=http://jo.my/a37ef4e0
result_data_1_id=ed5cc3ba6bc57841e314761761791612
result_data_1_short_url=http://jo.my/64e9bfaf
result_data_2_id=8aa24ad780443b7f67c5f1acf7d94a10
result_data_2_short_url=http://jo.my/23e1e8d9
result_data_3_id=50c94f4cd94abab17902fe3b0c2f5473
result_data_3_short_url=http://jo.my/39a298e8
result_data_4_id=b117311886bdd89311e7aa5a1de31120
result_data_4_short_url=http://jo.my/6b5f5d2d

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=7c00219811e47cd22e20ce6d208d1933&format=plain

Query parameters

    fields = id,short_url
project_id = 7c00219811e47cd22e20ce6d208d1933
    format = plain

Response

http://jo.my/a37ef4e0
http://jo.my/64e9bfaf
http://jo.my/23e1e8d9
http://jo.my/39a298e8
http://jo.my/6b5f5d2d

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: count, id, short_url, creation, url_tags, visits, unique_visits, qrcodes_visits, conversions_visits, long_url, notes, alias, options, is_tracking_pixel, project_id, project_name, domain_id, domain_host, domain_nickname

Optional parameters

parameter	description
end_dateDATE	filter tracking links created up to this date (inclusive)
filterSTRING	filter tracking links based on specific criteria, see notes for available filters
is_tracking_pixelBOOLEAN	1 to return only tracking pixels, 0 to return only tracking links, do not pass this parameter to return both
lengthINTEGER	extracts this number of items (maxmimum allowed: 100)
optionSTRING	filter tracking links by option, see i1/urls/options/list for a list of available options
orderbyARRAY	orders items by field, available fields: count, id, short_url, creation, url_tags, visits, unique_visits, qrcodes_visits, conversions_visits, long_url, notes, alias, options, is_tracking_pixel, project_id, project_name, domain_id, domain_host, domain_nickname
project_idID	ID of the project, if empty or unspecified, the default project will be assumed
searchSTRING	filters items to be extracted by searching them
sortSTRING	sorts items in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract items from this position
start_dateDATE	filter tracking links created from this date (inclusive)
whereSTRING	to be used in conjunction with search, specifies where to search and it can be [alias,domain,destination,notes,tags,utms];
with_alertsBOOLEAN	filter tracking links with security alerts

Available values for the where parameter:

alias: searches for tracking links with alias containing search
domain: searches for tracking links with domain containing search
destination: searches for tracking links with destination URL containing search
notes: searches for tracking links with notes containing search
tags: searches for tracking links with tags containing search, multiple tags must be separated by space; you can specify the search operator by placing AND: or OR: at the beginning of search, if search starts with AND:, tags will be searched using the logic operator AND, if search starts with OR:, tags will be searched using the logic operator OR (default, if you specify neither AND: nor OR:)
utms: searches for tracking links with UTM templates containing search
if empty or unspecified, it searches for tracking links in all the above fields and with the above criteria ("containing")

Please note that the search behaviour changes when it involves at least 10000 tracking links, and, in this case, based on the parameter where will be:

alias: searches for tracking links with alias exactly equal to search
domain: searches for tracking links with domain exactly equal to search
destination: searches for tracking links with destination URL exactly equal to search
notes: searches for tracking links with notes exactly equal to search
tags: searches for tracking links with tags exactly equal to search (i.e., exactly in the same order)
utms: searches for tracking links with UTM templates exactly equal to search
if empty or unspecified, it searches for tracking links in all the above fields and with the above criteria ("exactly equal to")

When the limit of 10000 tracking has been reached or exceeded, the following restrictions are also applied:

parameters oderby and sort are ignored, tracking links will be sorted according to the creation date (descending)

Available values for the filter parameter:

visit0: shows tracking links that have no visits
qrcodes0: shows tracking links that have no visits from QR codes
unique_visits0: shows tracking links that have no unique visits

Return values

parameter	description
count	[OPTIONAL] total number of tracking links, returned only if count is passed in fields
data	array containing information on the tracking links, the returned information depends on the fields parameter.

Available fields in the data array:

id: ID of the tracking link
short_url: short URL for the tracking link
creation: date/time of creation of the tracking link
url_tags: space separated list of tags associated with the tracking link
visits: number of visits to the tracking link
unique_visits: number of unique visits to the tracking link
qrcodes_visits: number of visits to the tracking link coming from QR codes
conversions_visits: number of conversions clicks to the tracking link
long_url: destination URL of the tracking link
notes: notes for tracking link
alias: alias of the tracking link
options: list of enabled options on the tracking link, see i1/urls/options/list for a list of available options
is_tracking_pixel: 1 if it is a tracking pixel, 0 otherwise
project_id: ID of the project of the tracking link
project_name: name of the project containing the tracking link
domain_id: ID of the domain of the tracking link
domain_host: domain of the tracking link
domain_nickname: nickname of the domain of the tracking link

/urls/masking

/urls/masking/clone

access: [WRITE]

Clone the masking configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/masking/clone?from_url_id=57b4397c7f1e7ee453daa97e11541358&to_url_id=e8b59d769c484a33d94d7eb2b99ee24c

Query parameters

from_url_id = 57b4397c7f1e7ee453daa97e11541358
  to_url_id = e8b59d769c484a33d94d7eb2b99ee24c

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/masking/clone?from_url_id=57b4397c7f1e7ee453daa97e11541358&to_url_id=e8b59d769c484a33d94d7eb2b99ee24c&format=xml

Query parameters

from_url_id = 57b4397c7f1e7ee453daa97e11541358
  to_url_id = e8b59d769c484a33d94d7eb2b99ee24c
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/masking/clone?from_url_id=57b4397c7f1e7ee453daa97e11541358&to_url_id=e8b59d769c484a33d94d7eb2b99ee24c&format=txt

Query parameters

from_url_id = 57b4397c7f1e7ee453daa97e11541358
  to_url_id = e8b59d769c484a33d94d7eb2b99ee24c
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/masking/clone?from_url_id=57b4397c7f1e7ee453daa97e11541358&to_url_id=e8b59d769c484a33d94d7eb2b99ee24c&format=plain

Query parameters

from_url_id = 57b4397c7f1e7ee453daa97e11541358
  to_url_id = e8b59d769c484a33d94d7eb2b99ee24c
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the masking configuration from
to_url_idID	ID of the tracking link you want to copy the masking configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/masking/delete

access: [WRITE]

Delete the masking option from a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/masking/delete?id=c36575e3fcee189ee11714654a5cda50

Query parameters

id = c36575e3fcee189ee11714654a5cda50

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/masking/delete?id=c36575e3fcee189ee11714654a5cda50&format=xml

Query parameters

    id = c36575e3fcee189ee11714654a5cda50
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/masking/delete?id=c36575e3fcee189ee11714654a5cda50&format=txt

Query parameters

    id = c36575e3fcee189ee11714654a5cda50
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/masking/delete?id=c36575e3fcee189ee11714654a5cda50&format=plain

Query parameters

    id = c36575e3fcee189ee11714654a5cda50
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a Masking configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/masking/edit

access: [WRITE]

Set a masking option for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/masking/edit?id=ddc27f329e5d2f34e7856c95d471b6bc&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3687863627

Query parameters

             id = ddc27f329e5d2f34e7856c95d471b6bc
     titles[en] = This is title for the page in English
     titles[it] = Questo è un titolo per la pagina in Italiano
     obfuscated = 1
        favicon = https://www.joturl.com/favicon.ico
    otc_enabled = 1
   otc_validity = 50
otc_private_key = 3687863627

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/masking/edit?id=ddc27f329e5d2f34e7856c95d471b6bc&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3687863627&format=xml

Query parameters

             id = ddc27f329e5d2f34e7856c95d471b6bc
     titles[en] = This is title for the page in English
     titles[it] = Questo è un titolo per la pagina in Italiano
     obfuscated = 1
        favicon = https://www.joturl.com/favicon.ico
    otc_enabled = 1
   otc_validity = 50
otc_private_key = 3687863627
         format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/masking/edit?id=ddc27f329e5d2f34e7856c95d471b6bc&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3687863627&format=txt

Query parameters

             id = ddc27f329e5d2f34e7856c95d471b6bc
     titles[en] = This is title for the page in English
     titles[it] = Questo è un titolo per la pagina in Italiano
     obfuscated = 1
        favicon = https://www.joturl.com/favicon.ico
    otc_enabled = 1
   otc_validity = 50
otc_private_key = 3687863627
         format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/masking/edit?id=ddc27f329e5d2f34e7856c95d471b6bc&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3687863627&format=plain

Query parameters

             id = ddc27f329e5d2f34e7856c95d471b6bc
     titles[en] = This is title for the page in English
     titles[it] = Questo è un titolo per la pagina in Italiano
     obfuscated = 1
        favicon = https://www.joturl.com/favicon.ico
    otc_enabled = 1
   otc_validity = 50
otc_private_key = 3687863627
         format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link

Optional parameters

parameter	description	max length
faviconURL	complete URL for the favicon to be used, this URL must be in HTTPS to avoid securiy issues	4000
obfuscatedBOOLEAN	1 if the destiantion URL should be obfuscated, 0 otherwise
otc_enabledBOOLEAN	1 to enable one-time code feature, 0 otherwise
otc_validityINTEGER	the time in seconds that the one-time code remains valid, too short times can cause malfunctions, too long times can give other users access to the one-time code. Available times: 10, 20, 30, 40, 50, 60, 180, 360, 540, 720, 1440, 2880, 4320, 5760, 7200, 8640, 10080
titlesJSON	titles for the masking page, one for each supported language; it contains couples (language codes, title), each title can contain maximum 500 characters	500

Return values

parameter	description
enabled	1 on success, 0 otherwise

/urls/masking/info

access: [READ]

Get masking information for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/masking/info?id=2b12d7ba8a8c1c8a0966cecb56073388

Query parameters

id = 2b12d7ba8a8c1c8a0966cecb56073388

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "titles": {
      "en": "This is title for the page in English",
      "it": "Questo è un titolo per la pagina in Italiano"
    },
    "obfuscated": 1,
    "favicon": "https:\/\/www.joturl.com\/favicon.ico",
    "otc_enabled": 1,
    "otc_validity": 50,
    "otc_private_key": "4181447777"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/masking/info?id=2b12d7ba8a8c1c8a0966cecb56073388&format=xml

Query parameters

    id = 2b12d7ba8a8c1c8a0966cecb56073388
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <titles>
      <en>This is title for the page in English</en>  
      <it><[CDATA[Questo &egrave; un titolo per la pagina in Italiano]]></it>  
    </titles>  
    <obfuscated>1</obfuscated>  
    <favicon>https://www.joturl.com/favicon.ico</favicon>  
    <otc_enabled>1</otc_enabled>  
    <otc_validity>50</otc_validity>  
    <otc_private_key>4181447777</otc_private_key>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/masking/info?id=2b12d7ba8a8c1c8a0966cecb56073388&format=txt

Query parameters

    id = 2b12d7ba8a8c1c8a0966cecb56073388
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_titles_en=This is title for the page in English
result_titles_it=Questo &egrave; un titolo per la pagina in Italiano
result_obfuscated=1
result_favicon=https://www.joturl.com/favicon.ico
result_otc_enabled=1
result_otc_validity=50
result_otc_private_key=4181447777

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/masking/info?id=2b12d7ba8a8c1c8a0966cecb56073388&format=plain

Query parameters

    id = 2b12d7ba8a8c1c8a0966cecb56073388
format = plain

Response

This is title for the page in English
Questo &egrave; un titolo per la pagina in Italiano
1
https://www.joturl.com/favicon.ico
1
50
4181447777

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
favicon	[OPTIONAL] complete URL for the favicon to be used, this URL must be in HTTPS to avoid securiy issues
obfuscated	[OPTIONAL] 1 if the destiantion URL should be obfuscated, 0 otherwise
otc_enabled	[OPTIONAL] 1 if the one-time code feature is enabled, 0 otherwise
otc_private_key	[OPTIONAL] one-time code private key, it is the key to be used to generate one-time codes
otc_validity	[OPTIONAL] the time in seconds that the one-time code remains valid, see i1/urls/masking/edit for details
titles	[OPTIONAL] titles for the masking page, one for each supported language

/urls/minipages

/urls/minipages/clone

access: [WRITE]

Clone the minpages configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/minipages/clone?from_url_id=eba10605e2fa6c25f186f78db09fe1bf&to_url_id=af634a8ccc1cda3c4d2318c2625c6e5e

Query parameters

from_url_id = eba10605e2fa6c25f186f78db09fe1bf
  to_url_id = af634a8ccc1cda3c4d2318c2625c6e5e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/minipages/clone?from_url_id=eba10605e2fa6c25f186f78db09fe1bf&to_url_id=af634a8ccc1cda3c4d2318c2625c6e5e&format=xml

Query parameters

from_url_id = eba10605e2fa6c25f186f78db09fe1bf
  to_url_id = af634a8ccc1cda3c4d2318c2625c6e5e
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/minipages/clone?from_url_id=eba10605e2fa6c25f186f78db09fe1bf&to_url_id=af634a8ccc1cda3c4d2318c2625c6e5e&format=txt

Query parameters

from_url_id = eba10605e2fa6c25f186f78db09fe1bf
  to_url_id = af634a8ccc1cda3c4d2318c2625c6e5e
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/minipages/clone?from_url_id=eba10605e2fa6c25f186f78db09fe1bf&to_url_id=af634a8ccc1cda3c4d2318c2625c6e5e&format=plain

Query parameters

from_url_id = eba10605e2fa6c25f186f78db09fe1bf
  to_url_id = af634a8ccc1cda3c4d2318c2625c6e5e
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the minpages configuration from
to_url_idID	ID of the tracking link you want to the minpages configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/minipages/delete

access: [WRITE]

Unset (delete) a minipage for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/minipages/delete?id=b0edf14e9019707ff0fe8ec0bb794621

Query parameters

id = b0edf14e9019707ff0fe8ec0bb794621

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/minipages/delete?id=b0edf14e9019707ff0fe8ec0bb794621&format=xml

Query parameters

    id = b0edf14e9019707ff0fe8ec0bb794621
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/minipages/delete?id=b0edf14e9019707ff0fe8ec0bb794621&format=txt

Query parameters

    id = b0edf14e9019707ff0fe8ec0bb794621
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/minipages/delete?id=b0edf14e9019707ff0fe8ec0bb794621&format=plain

Query parameters

    id = b0edf14e9019707ff0fe8ec0bb794621
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a Minipage configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/move

access: [WRITE]

Moves a tracking link from a project to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/move?src_project_id=91979ed627b722cfbbaa2b55a593949c&dst_project_id=6bbc27e99c8698bcd17b9832a661caa1&id=f28199e0773f83fc6346f6cf0e7432e8

Query parameters

src_project_id = 91979ed627b722cfbbaa2b55a593949c
dst_project_id = 6bbc27e99c8698bcd17b9832a661caa1
            id = f28199e0773f83fc6346f6cf0e7432e8

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "moved": [
      {
        "src_project_id": "91979ed627b722cfbbaa2b55a593949c",
        "id": "f28199e0773f83fc6346f6cf0e7432e8"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/move?src_project_id=91979ed627b722cfbbaa2b55a593949c&dst_project_id=6bbc27e99c8698bcd17b9832a661caa1&id=f28199e0773f83fc6346f6cf0e7432e8&format=xml

Query parameters

src_project_id = 91979ed627b722cfbbaa2b55a593949c
dst_project_id = 6bbc27e99c8698bcd17b9832a661caa1
            id = f28199e0773f83fc6346f6cf0e7432e8
        format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <moved>
      <i0>
        <src_project_id>91979ed627b722cfbbaa2b55a593949c</src_project_id>  
        <id>f28199e0773f83fc6346f6cf0e7432e8</id>  
      </i0>  
    </moved>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/move?src_project_id=91979ed627b722cfbbaa2b55a593949c&dst_project_id=6bbc27e99c8698bcd17b9832a661caa1&id=f28199e0773f83fc6346f6cf0e7432e8&format=txt

Query parameters

src_project_id = 91979ed627b722cfbbaa2b55a593949c
dst_project_id = 6bbc27e99c8698bcd17b9832a661caa1
            id = f28199e0773f83fc6346f6cf0e7432e8
        format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_moved_0_src_project_id=91979ed627b722cfbbaa2b55a593949c
result_moved_0_id=f28199e0773f83fc6346f6cf0e7432e8

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/move?src_project_id=91979ed627b722cfbbaa2b55a593949c&dst_project_id=6bbc27e99c8698bcd17b9832a661caa1&id=f28199e0773f83fc6346f6cf0e7432e8&format=plain

Query parameters

src_project_id = 91979ed627b722cfbbaa2b55a593949c
dst_project_id = 6bbc27e99c8698bcd17b9832a661caa1
            id = f28199e0773f83fc6346f6cf0e7432e8
        format = plain

Response

91979ed627b722cfbbaa2b55a593949c
f28199e0773f83fc6346f6cf0e7432e8

Required parameters

parameter	description
dst_project_idID	ID of the project the tracking link have to be moved to
src_project_idID	ID of the project the tracking link is currently in

Optional parameters

parameter	description
fieldsARRAY	see method i1/urls/list for a list of available fields
idID	ID of the tracking link to move
idsARRAY_OF_IDS	comma separated list of tracking link IDs to be moved

Return values

parameter	description
moved	array containing information on the moved tracking links, errors occurred while moving are ignored and this array can be empty. The information returned depends on the fields parameter. If fields is not passed, IDs of the tracking links and of the source project are returned. See method i1/urls/list for a list of return fields.

/urls/options

/urls/options/check

access: [READ]

Checks if an option is compatible with those active on the tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/options/check?id=2795797892805cd71bc7e70ebe09d927&option=easydeeplink

Query parameters

    id = 2795797892805cd71bc7e70ebe09d927
option = easydeeplink

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "compatible": 0,
    "incompatible": "split"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/options/check?id=2795797892805cd71bc7e70ebe09d927&option=easydeeplink&format=xml

Query parameters

    id = 2795797892805cd71bc7e70ebe09d927
option = easydeeplink
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <compatible>0</compatible>  
    <incompatible>split</incompatible>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/options/check?id=2795797892805cd71bc7e70ebe09d927&option=easydeeplink&format=txt

Query parameters

    id = 2795797892805cd71bc7e70ebe09d927
option = easydeeplink
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_compatible=0
result_incompatible=split

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/options/check?id=2795797892805cd71bc7e70ebe09d927&option=easydeeplink&format=plain

Query parameters

    id = 2795797892805cd71bc7e70ebe09d927
option = easydeeplink
format = plain

Response

0
split

Required parameters

parameter	description
idID	ID of the tracking link
optionSTRING	Option to be checked

Return values

parameter	description
compatible	1 if the option is compatible with the options that are active on the tracking link, 0 otherwise
incompatible	if `compatible = 0`, it contains the option that is not compatible with the passed `option`, if `compatible = 1` it is empty. `incompatible` is not a list of all incompatible options, but just the first option detected

/urls/options/info

access: [READ]

Returns the list of available options for a specific TLs. Further, this method returns the exclusion list (options that cannot be used with other options), the list of options that are disabled for the user plan and the list of options that can be used to filter tracking links.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/options/info?id=179893

Query parameters

id = 179893

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "options": [
      "balancer",
      "cloaking",
      "conversions",
      "ctas",
      "deeplink",
      "easydeeplink",
      "browserdeeplink",
      "instaurl",
      "jotbar",
      "masking",
      "minipage",
      "parameters",
      "preview",
      "redirector",
      "remarketings",
      "selfdestruction",
      "split",
      "whatsapp"
    ],
    "exclusions": {
      "balancer": [
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "cloaking": [],
      "conversions": [
        "split"
      ],
      "ctas": [
        "balancer",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "deeplink": [
        "balancer",
        "ctas",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "easydeeplink": [
        "balancer",
        "ctas",
        "browserdeeplink",
        "deeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "browserdeeplink": [
        "balancer",
        "ctas",
        "easydeeplink",
        "deeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "instaurl": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "jotbar": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "masking",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "masking": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "minipage": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "redirector",
        "split",
        "whatsapp"
      ],
      "parameters": [],
      "preview": [],
      "redirector": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "remarketings": [
        "balancer",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "redirector",
        "split",
        "whatsapp"
      ],
      "selfdestruction": [],
      "split": [
        "balancer",
        "conversions",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "whatsapp"
      ],
      "whatsapp": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split"
      ]
    },
    "disabled": [],
    "filters": [
      "balancer",
      "cloaking",
      "conversions",
      "ctas",
      "deeplink",
      "easydeeplink",
      "browserdeeplink",
      "instaurl",
      "jotbar",
      "masking",
      "minipage",
      "parameters",
      "preview",
      "redirector",
      "remarketings",
      "selfdestruction",
      "split",
      "whatsapp"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/options/info?id=179893&format=xml

Query parameters

    id = 179893
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <options>
      <i0>balancer</i0>  
      <i1>cloaking</i1>  
      <i2>conversions</i2>  
      <i3>ctas</i3>  
      <i4>deeplink</i4>  
      <i5>easydeeplink</i5>  
      <i6>browserdeeplink</i6>  
      <i7>instaurl</i7>  
      <i8>jotbar</i8>  
      <i9>masking</i9>  
      <i10>minipage</i10>  
      <i11>parameters</i11>  
      <i12>preview</i12>  
      <i13>redirector</i13>  
      <i14>remarketings</i14>  
      <i15>selfdestruction</i15>  
      <i16>split</i16>  
      <i17>whatsapp</i17>  
    </options>  
    <exclusions>
      <balancer>
        <i0>ctas</i0>  
        <i1>deeplink</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </balancer>  
      <cloaking>

      </cloaking>  
      <conversions>
        <i0>split</i0>  
      </conversions>  
      <ctas>
        <i0>balancer</i0>  
        <i1>deeplink</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </ctas>  
      <deeplink>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </deeplink>  
      <easydeeplink>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>browserdeeplink</i2>  
        <i3>deeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </easydeeplink>  
      <browserdeeplink>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>easydeeplink</i2>  
        <i3>deeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </browserdeeplink>  
      <instaurl>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </instaurl>  
      <jotbar>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </jotbar>  
      <masking>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </masking>  
      <minipage>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>masking</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </minipage>  
      <parameters>

      </parameters>  
      <preview>

      </preview>  
      <redirector>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>masking</i7>  
        <i8>minipage</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </redirector>  
      <remarketings>
        <i0>balancer</i0>  
        <i1>deeplink</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>redirector</i4>  
        <i5>split</i5>  
        <i6>whatsapp</i6>  
      </remarketings>  
      <selfdestruction>

      </selfdestruction>  
      <split>
        <i0>balancer</i0>  
        <i1>conversions</i1>  
        <i2>ctas</i2>  
        <i3>deeplink</i3>  
        <i4>easydeeplink</i4>  
        <i5>browserdeeplink</i5>  
        <i6>instaurl</i6>  
        <i7>jotbar</i7>  
        <i8>masking</i8>  
        <i9>minipage</i9>  
        <i10>redirector</i10>  
        <i11>remarketings</i11>  
        <i12>whatsapp</i12>  
      </split>  
      <whatsapp>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>masking</i7>  
        <i8>minipage</i8>  
        <i9>redirector</i9>  
        <i10>remarketings</i10>  
        <i11>split</i11>  
      </whatsapp>  
    </exclusions>  
    <disabled>

    </disabled>  
    <filters>
      <i0>balancer</i0>  
      <i1>cloaking</i1>  
      <i2>conversions</i2>  
      <i3>ctas</i3>  
      <i4>deeplink</i4>  
      <i5>easydeeplink</i5>  
      <i6>browserdeeplink</i6>  
      <i7>instaurl</i7>  
      <i8>jotbar</i8>  
      <i9>masking</i9>  
      <i10>minipage</i10>  
      <i11>parameters</i11>  
      <i12>preview</i12>  
      <i13>redirector</i13>  
      <i14>remarketings</i14>  
      <i15>selfdestruction</i15>  
      <i16>split</i16>  
      <i17>whatsapp</i17>  
    </filters>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/options/info?id=179893&format=txt

Query parameters

    id = 179893
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_options_0=balancer
result_options_1=cloaking
result_options_2=conversions
result_options_3=ctas
result_options_4=deeplink
result_options_5=easydeeplink
result_options_6=browserdeeplink
result_options_7=instaurl
result_options_8=jotbar
result_options_9=masking
result_options_10=minipage
result_options_11=parameters
result_options_12=preview
result_options_13=redirector
result_options_14=remarketings
result_options_15=selfdestruction
result_options_16=split
result_options_17=whatsapp
result_exclusions_balancer_0=ctas
result_exclusions_balancer_1=deeplink
result_exclusions_balancer_2=easydeeplink
result_exclusions_balancer_3=browserdeeplink
result_exclusions_balancer_4=instaurl
result_exclusions_balancer_5=jotbar
result_exclusions_balancer_6=masking
result_exclusions_balancer_7=minipage
result_exclusions_balancer_8=redirector
result_exclusions_balancer_9=remarketings
result_exclusions_balancer_10=split
result_exclusions_balancer_11=whatsapp
result_exclusions_cloaking=
result_exclusions_conversions_0=split
result_exclusions_ctas_0=balancer
result_exclusions_ctas_1=deeplink
result_exclusions_ctas_2=easydeeplink
result_exclusions_ctas_3=browserdeeplink
result_exclusions_ctas_4=instaurl
result_exclusions_ctas_5=jotbar
result_exclusions_ctas_6=masking
result_exclusions_ctas_7=minipage
result_exclusions_ctas_8=redirector
result_exclusions_ctas_9=split
result_exclusions_ctas_10=whatsapp
result_exclusions_deeplink_0=balancer
result_exclusions_deeplink_1=ctas
result_exclusions_deeplink_2=easydeeplink
result_exclusions_deeplink_3=browserdeeplink
result_exclusions_deeplink_4=instaurl
result_exclusions_deeplink_5=jotbar
result_exclusions_deeplink_6=masking
result_exclusions_deeplink_7=minipage
result_exclusions_deeplink_8=redirector
result_exclusions_deeplink_9=remarketings
result_exclusions_deeplink_10=split
result_exclusions_deeplink_11=whatsapp
result_exclusions_easydeeplink_0=balancer
result_exclusions_easydeeplink_1=ctas
result_exclusions_easydeeplink_2=browserdeeplink
result_exclusions_easydeeplink_3=deeplink
result_exclusions_easydeeplink_4=instaurl
result_exclusions_easydeeplink_5=jotbar
result_exclusions_easydeeplink_6=masking
result_exclusions_easydeeplink_7=minipage
result_exclusions_easydeeplink_8=redirector
result_exclusions_easydeeplink_9=remarketings
result_exclusions_easydeeplink_10=split
result_exclusions_easydeeplink_11=whatsapp
result_exclusions_browserdeeplink_0=balancer
result_exclusions_browserdeeplink_1=ctas
result_exclusions_browserdeeplink_2=easydeeplink
result_exclusions_browserdeeplink_3=deeplink
result_exclusions_browserdeeplink_4=instaurl
result_exclusions_browserdeeplink_5=jotbar
result_exclusions_browserdeeplink_6=masking
result_exclusions_browserdeeplink_7=minipage
result_exclusions_browserdeeplink_8=redirector
result_exclusions_browserdeeplink_9=remarketings
result_exclusions_browserdeeplink_10=split
result_exclusions_browserdeeplink_11=whatsapp
result_exclusions_instaurl_0=balancer
result_exclusions_instaurl_1=ctas
result_exclusions_instaurl_2=deeplink
result_exclusions_instaurl_3=easydeeplink
result_exclusions_instaurl_4=browserdeeplink
result_exclusions_instaurl_5=jotbar
result_exclusions_instaurl_6=masking
result_exclusions_instaurl_7=minipage
result_exclusions_instaurl_8=redirector
result_exclusions_instaurl_9=split
result_exclusions_instaurl_10=whatsapp
result_exclusions_jotbar_0=balancer
result_exclusions_jotbar_1=ctas
result_exclusions_jotbar_2=deeplink
result_exclusions_jotbar_3=easydeeplink
result_exclusions_jotbar_4=browserdeeplink
result_exclusions_jotbar_5=instaurl
result_exclusions_jotbar_6=masking
result_exclusions_jotbar_7=minipage
result_exclusions_jotbar_8=redirector
result_exclusions_jotbar_9=split
result_exclusions_jotbar_10=whatsapp
result_exclusions_masking_0=balancer
result_exclusions_masking_1=ctas
result_exclusions_masking_2=deeplink
result_exclusions_masking_3=easydeeplink
result_exclusions_masking_4=browserdeeplink
result_exclusions_masking_5=instaurl
result_exclusions_masking_6=jotbar
result_exclusions_masking_7=minipage
result_exclusions_masking_8=redirector
result_exclusions_masking_9=split
result_exclusions_masking_10=whatsapp
result_exclusions_minipage_0=balancer
result_exclusions_minipage_1=ctas
result_exclusions_minipage_2=deeplink
result_exclusions_minipage_3=easydeeplink
result_exclusions_minipage_4=browserdeeplink
result_exclusions_minipage_5=instaurl
result_exclusions_minipage_6=jotbar
result_exclusions_minipage_7=masking
result_exclusions_minipage_8=redirector
result_exclusions_minipage_9=split
result_exclusions_minipage_10=whatsapp
result_exclusions_parameters=
result_exclusions_preview=
result_exclusions_redirector_0=balancer
result_exclusions_redirector_1=ctas
result_exclusions_redirector_2=deeplink
result_exclusions_redirector_3=easydeeplink
result_exclusions_redirector_4=browserdeeplink
result_exclusions_redirector_5=instaurl
result_exclusions_redirector_6=jotbar
result_exclusions_redirector_7=masking
result_exclusions_redirector_8=minipage
result_exclusions_redirector_9=remarketings
result_exclusions_redirector_10=split
result_exclusions_redirector_11=whatsapp
result_exclusions_remarketings_0=balancer
result_exclusions_remarketings_1=deeplink
result_exclusions_remarketings_2=easydeeplink
result_exclusions_remarketings_3=browserdeeplink
result_exclusions_remarketings_4=redirector
result_exclusions_remarketings_5=split
result_exclusions_remarketings_6=whatsapp
result_exclusions_selfdestruction=
result_exclusions_split_0=balancer
result_exclusions_split_1=conversions
result_exclusions_split_2=ctas
result_exclusions_split_3=deeplink
result_exclusions_split_4=easydeeplink
result_exclusions_split_5=browserdeeplink
result_exclusions_split_6=instaurl
result_exclusions_split_7=jotbar
result_exclusions_split_8=masking
result_exclusions_split_9=minipage
result_exclusions_split_10=redirector
result_exclusions_split_11=remarketings
result_exclusions_split_12=whatsapp
result_exclusions_whatsapp_0=balancer
result_exclusions_whatsapp_1=ctas
result_exclusions_whatsapp_2=deeplink
result_exclusions_whatsapp_3=easydeeplink
result_exclusions_whatsapp_4=browserdeeplink
result_exclusions_whatsapp_5=instaurl
result_exclusions_whatsapp_6=jotbar
result_exclusions_whatsapp_7=masking
result_exclusions_whatsapp_8=minipage
result_exclusions_whatsapp_9=redirector
result_exclusions_whatsapp_10=remarketings
result_exclusions_whatsapp_11=split
result_disabled=
result_filters_0=balancer
result_filters_1=cloaking
result_filters_2=conversions
result_filters_3=ctas
result_filters_4=deeplink
result_filters_5=easydeeplink
result_filters_6=browserdeeplink
result_filters_7=instaurl
result_filters_8=jotbar
result_filters_9=masking
result_filters_10=minipage
result_filters_11=parameters
result_filters_12=preview
result_filters_13=redirector
result_filters_14=remarketings
result_filters_15=selfdestruction
result_filters_16=split
result_filters_17=whatsapp

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/options/info?id=179893&format=plain

Query parameters

    id = 179893
format = plain

Response

balancer
cloaking
conversions
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp

split
balancer
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
browserdeeplink
deeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
easydeeplink
deeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
redirector
split
whatsapp


balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
remarketings
split
whatsapp
balancer
deeplink
easydeeplink
browserdeeplink
redirector
split
whatsapp

balancer
conversions
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split

balancer
cloaking
conversions
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
disabled	List of options that are not available for the current user
exclusions	List of options that are not compatible with other options. Each option of the list contains an array of incompatible options
filters	List of options that are can be used to filter tracking links
options	List of options available for the specified tracking link

/urls/options/list

access: [READ]

Returns the list of available options for TLs. Further, this method returns the exlusion list (options that cannot be used in conjuction of other options), the list of options that are disabled for the user plan and the list of options that can be used to filter tracking links.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/options/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "options": [
      "balancer",
      "cloaking",
      "conversions",
      "ctas",
      "deeplink",
      "easydeeplink",
      "browserdeeplink",
      "instaurl",
      "jotbar",
      "masking",
      "minipage",
      "parameters",
      "preview",
      "redirector",
      "remarketings",
      "selfdestruction",
      "split",
      "whatsapp"
    ],
    "exclusions": {
      "balancer": [
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "cloaking": [],
      "conversions": [
        "split"
      ],
      "ctas": [
        "balancer",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "deeplink": [
        "balancer",
        "ctas",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "easydeeplink": [
        "balancer",
        "ctas",
        "browserdeeplink",
        "deeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "browserdeeplink": [
        "balancer",
        "ctas",
        "easydeeplink",
        "deeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "instaurl": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "jotbar": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "masking",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "masking": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "minipage",
        "redirector",
        "split",
        "whatsapp"
      ],
      "minipage": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "redirector",
        "split",
        "whatsapp"
      ],
      "parameters": [],
      "preview": [],
      "redirector": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "remarketings",
        "split",
        "whatsapp"
      ],
      "remarketings": [
        "balancer",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "redirector",
        "split",
        "whatsapp"
      ],
      "selfdestruction": [],
      "split": [
        "balancer",
        "conversions",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "whatsapp"
      ],
      "whatsapp": [
        "balancer",
        "ctas",
        "deeplink",
        "easydeeplink",
        "browserdeeplink",
        "instaurl",
        "jotbar",
        "masking",
        "minipage",
        "redirector",
        "remarketings",
        "split"
      ]
    },
    "disabled": [],
    "filters": [
      "balancer",
      "cloaking",
      "conversions",
      "ctas",
      "deeplink",
      "easydeeplink",
      "browserdeeplink",
      "instaurl",
      "jotbar",
      "masking",
      "minipage",
      "parameters",
      "preview",
      "redirector",
      "remarketings",
      "selfdestruction",
      "split",
      "whatsapp"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/options/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <options>
      <i0>balancer</i0>  
      <i1>cloaking</i1>  
      <i2>conversions</i2>  
      <i3>ctas</i3>  
      <i4>deeplink</i4>  
      <i5>easydeeplink</i5>  
      <i6>browserdeeplink</i6>  
      <i7>instaurl</i7>  
      <i8>jotbar</i8>  
      <i9>masking</i9>  
      <i10>minipage</i10>  
      <i11>parameters</i11>  
      <i12>preview</i12>  
      <i13>redirector</i13>  
      <i14>remarketings</i14>  
      <i15>selfdestruction</i15>  
      <i16>split</i16>  
      <i17>whatsapp</i17>  
    </options>  
    <exclusions>
      <balancer>
        <i0>ctas</i0>  
        <i1>deeplink</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </balancer>  
      <cloaking>

      </cloaking>  
      <conversions>
        <i0>split</i0>  
      </conversions>  
      <ctas>
        <i0>balancer</i0>  
        <i1>deeplink</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </ctas>  
      <deeplink>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </deeplink>  
      <easydeeplink>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>browserdeeplink</i2>  
        <i3>deeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </easydeeplink>  
      <browserdeeplink>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>easydeeplink</i2>  
        <i3>deeplink</i3>  
        <i4>instaurl</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </browserdeeplink>  
      <instaurl>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>jotbar</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </instaurl>  
      <jotbar>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>masking</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </jotbar>  
      <masking>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>minipage</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </masking>  
      <minipage>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>masking</i7>  
        <i8>redirector</i8>  
        <i9>split</i9>  
        <i10>whatsapp</i10>  
      </minipage>  
      <parameters>

      </parameters>  
      <preview>

      </preview>  
      <redirector>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>masking</i7>  
        <i8>minipage</i8>  
        <i9>remarketings</i9>  
        <i10>split</i10>  
        <i11>whatsapp</i11>  
      </redirector>  
      <remarketings>
        <i0>balancer</i0>  
        <i1>deeplink</i1>  
        <i2>easydeeplink</i2>  
        <i3>browserdeeplink</i3>  
        <i4>redirector</i4>  
        <i5>split</i5>  
        <i6>whatsapp</i6>  
      </remarketings>  
      <selfdestruction>

      </selfdestruction>  
      <split>
        <i0>balancer</i0>  
        <i1>conversions</i1>  
        <i2>ctas</i2>  
        <i3>deeplink</i3>  
        <i4>easydeeplink</i4>  
        <i5>browserdeeplink</i5>  
        <i6>instaurl</i6>  
        <i7>jotbar</i7>  
        <i8>masking</i8>  
        <i9>minipage</i9>  
        <i10>redirector</i10>  
        <i11>remarketings</i11>  
        <i12>whatsapp</i12>  
      </split>  
      <whatsapp>
        <i0>balancer</i0>  
        <i1>ctas</i1>  
        <i2>deeplink</i2>  
        <i3>easydeeplink</i3>  
        <i4>browserdeeplink</i4>  
        <i5>instaurl</i5>  
        <i6>jotbar</i6>  
        <i7>masking</i7>  
        <i8>minipage</i8>  
        <i9>redirector</i9>  
        <i10>remarketings</i10>  
        <i11>split</i11>  
      </whatsapp>  
    </exclusions>  
    <disabled>

    </disabled>  
    <filters>
      <i0>balancer</i0>  
      <i1>cloaking</i1>  
      <i2>conversions</i2>  
      <i3>ctas</i3>  
      <i4>deeplink</i4>  
      <i5>easydeeplink</i5>  
      <i6>browserdeeplink</i6>  
      <i7>instaurl</i7>  
      <i8>jotbar</i8>  
      <i9>masking</i9>  
      <i10>minipage</i10>  
      <i11>parameters</i11>  
      <i12>preview</i12>  
      <i13>redirector</i13>  
      <i14>remarketings</i14>  
      <i15>selfdestruction</i15>  
      <i16>split</i16>  
      <i17>whatsapp</i17>  
    </filters>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/options/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_options_0=balancer
result_options_1=cloaking
result_options_2=conversions
result_options_3=ctas
result_options_4=deeplink
result_options_5=easydeeplink
result_options_6=browserdeeplink
result_options_7=instaurl
result_options_8=jotbar
result_options_9=masking
result_options_10=minipage
result_options_11=parameters
result_options_12=preview
result_options_13=redirector
result_options_14=remarketings
result_options_15=selfdestruction
result_options_16=split
result_options_17=whatsapp
result_exclusions_balancer_0=ctas
result_exclusions_balancer_1=deeplink
result_exclusions_balancer_2=easydeeplink
result_exclusions_balancer_3=browserdeeplink
result_exclusions_balancer_4=instaurl
result_exclusions_balancer_5=jotbar
result_exclusions_balancer_6=masking
result_exclusions_balancer_7=minipage
result_exclusions_balancer_8=redirector
result_exclusions_balancer_9=remarketings
result_exclusions_balancer_10=split
result_exclusions_balancer_11=whatsapp
result_exclusions_cloaking=
result_exclusions_conversions_0=split
result_exclusions_ctas_0=balancer
result_exclusions_ctas_1=deeplink
result_exclusions_ctas_2=easydeeplink
result_exclusions_ctas_3=browserdeeplink
result_exclusions_ctas_4=instaurl
result_exclusions_ctas_5=jotbar
result_exclusions_ctas_6=masking
result_exclusions_ctas_7=minipage
result_exclusions_ctas_8=redirector
result_exclusions_ctas_9=split
result_exclusions_ctas_10=whatsapp
result_exclusions_deeplink_0=balancer
result_exclusions_deeplink_1=ctas
result_exclusions_deeplink_2=easydeeplink
result_exclusions_deeplink_3=browserdeeplink
result_exclusions_deeplink_4=instaurl
result_exclusions_deeplink_5=jotbar
result_exclusions_deeplink_6=masking
result_exclusions_deeplink_7=minipage
result_exclusions_deeplink_8=redirector
result_exclusions_deeplink_9=remarketings
result_exclusions_deeplink_10=split
result_exclusions_deeplink_11=whatsapp
result_exclusions_easydeeplink_0=balancer
result_exclusions_easydeeplink_1=ctas
result_exclusions_easydeeplink_2=browserdeeplink
result_exclusions_easydeeplink_3=deeplink
result_exclusions_easydeeplink_4=instaurl
result_exclusions_easydeeplink_5=jotbar
result_exclusions_easydeeplink_6=masking
result_exclusions_easydeeplink_7=minipage
result_exclusions_easydeeplink_8=redirector
result_exclusions_easydeeplink_9=remarketings
result_exclusions_easydeeplink_10=split
result_exclusions_easydeeplink_11=whatsapp
result_exclusions_browserdeeplink_0=balancer
result_exclusions_browserdeeplink_1=ctas
result_exclusions_browserdeeplink_2=easydeeplink
result_exclusions_browserdeeplink_3=deeplink
result_exclusions_browserdeeplink_4=instaurl
result_exclusions_browserdeeplink_5=jotbar
result_exclusions_browserdeeplink_6=masking
result_exclusions_browserdeeplink_7=minipage
result_exclusions_browserdeeplink_8=redirector
result_exclusions_browserdeeplink_9=remarketings
result_exclusions_browserdeeplink_10=split
result_exclusions_browserdeeplink_11=whatsapp
result_exclusions_instaurl_0=balancer
result_exclusions_instaurl_1=ctas
result_exclusions_instaurl_2=deeplink
result_exclusions_instaurl_3=easydeeplink
result_exclusions_instaurl_4=browserdeeplink
result_exclusions_instaurl_5=jotbar
result_exclusions_instaurl_6=masking
result_exclusions_instaurl_7=minipage
result_exclusions_instaurl_8=redirector
result_exclusions_instaurl_9=split
result_exclusions_instaurl_10=whatsapp
result_exclusions_jotbar_0=balancer
result_exclusions_jotbar_1=ctas
result_exclusions_jotbar_2=deeplink
result_exclusions_jotbar_3=easydeeplink
result_exclusions_jotbar_4=browserdeeplink
result_exclusions_jotbar_5=instaurl
result_exclusions_jotbar_6=masking
result_exclusions_jotbar_7=minipage
result_exclusions_jotbar_8=redirector
result_exclusions_jotbar_9=split
result_exclusions_jotbar_10=whatsapp
result_exclusions_masking_0=balancer
result_exclusions_masking_1=ctas
result_exclusions_masking_2=deeplink
result_exclusions_masking_3=easydeeplink
result_exclusions_masking_4=browserdeeplink
result_exclusions_masking_5=instaurl
result_exclusions_masking_6=jotbar
result_exclusions_masking_7=minipage
result_exclusions_masking_8=redirector
result_exclusions_masking_9=split
result_exclusions_masking_10=whatsapp
result_exclusions_minipage_0=balancer
result_exclusions_minipage_1=ctas
result_exclusions_minipage_2=deeplink
result_exclusions_minipage_3=easydeeplink
result_exclusions_minipage_4=browserdeeplink
result_exclusions_minipage_5=instaurl
result_exclusions_minipage_6=jotbar
result_exclusions_minipage_7=masking
result_exclusions_minipage_8=redirector
result_exclusions_minipage_9=split
result_exclusions_minipage_10=whatsapp
result_exclusions_parameters=
result_exclusions_preview=
result_exclusions_redirector_0=balancer
result_exclusions_redirector_1=ctas
result_exclusions_redirector_2=deeplink
result_exclusions_redirector_3=easydeeplink
result_exclusions_redirector_4=browserdeeplink
result_exclusions_redirector_5=instaurl
result_exclusions_redirector_6=jotbar
result_exclusions_redirector_7=masking
result_exclusions_redirector_8=minipage
result_exclusions_redirector_9=remarketings
result_exclusions_redirector_10=split
result_exclusions_redirector_11=whatsapp
result_exclusions_remarketings_0=balancer
result_exclusions_remarketings_1=deeplink
result_exclusions_remarketings_2=easydeeplink
result_exclusions_remarketings_3=browserdeeplink
result_exclusions_remarketings_4=redirector
result_exclusions_remarketings_5=split
result_exclusions_remarketings_6=whatsapp
result_exclusions_selfdestruction=
result_exclusions_split_0=balancer
result_exclusions_split_1=conversions
result_exclusions_split_2=ctas
result_exclusions_split_3=deeplink
result_exclusions_split_4=easydeeplink
result_exclusions_split_5=browserdeeplink
result_exclusions_split_6=instaurl
result_exclusions_split_7=jotbar
result_exclusions_split_8=masking
result_exclusions_split_9=minipage
result_exclusions_split_10=redirector
result_exclusions_split_11=remarketings
result_exclusions_split_12=whatsapp
result_exclusions_whatsapp_0=balancer
result_exclusions_whatsapp_1=ctas
result_exclusions_whatsapp_2=deeplink
result_exclusions_whatsapp_3=easydeeplink
result_exclusions_whatsapp_4=browserdeeplink
result_exclusions_whatsapp_5=instaurl
result_exclusions_whatsapp_6=jotbar
result_exclusions_whatsapp_7=masking
result_exclusions_whatsapp_8=minipage
result_exclusions_whatsapp_9=redirector
result_exclusions_whatsapp_10=remarketings
result_exclusions_whatsapp_11=split
result_disabled=
result_filters_0=balancer
result_filters_1=cloaking
result_filters_2=conversions
result_filters_3=ctas
result_filters_4=deeplink
result_filters_5=easydeeplink
result_filters_6=browserdeeplink
result_filters_7=instaurl
result_filters_8=jotbar
result_filters_9=masking
result_filters_10=minipage
result_filters_11=parameters
result_filters_12=preview
result_filters_13=redirector
result_filters_14=remarketings
result_filters_15=selfdestruction
result_filters_16=split
result_filters_17=whatsapp

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/options/list?format=plain

Query parameters

format = plain

Response

balancer
cloaking
conversions
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp

split
balancer
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
browserdeeplink
deeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
easydeeplink
deeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
redirector
split
whatsapp


balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
remarketings
split
whatsapp
balancer
deeplink
easydeeplink
browserdeeplink
redirector
split
whatsapp

balancer
conversions
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
whatsapp
balancer
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split

balancer
cloaking
conversions
ctas
deeplink
easydeeplink
browserdeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp

Return values

parameter	description
disabled	List of options that are not available for the current user
exclusions	List of options that are not compatible with other options. Each option of the list contains an array of incompatible options
filters	List of options that are can be used to filter tracking links
options	List of options available for tracking links

/urls/parameters

/urls/parameters/clone

access: [WRITE]

Clone the UTM paramters from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/parameters/clone?from_url_id=7c44c34c0c740e2c77ab8275e81c1ef0&to_url_id=734cf0b4c37152eb94a58e0c9d7f0c63

Query parameters

from_url_id = 7c44c34c0c740e2c77ab8275e81c1ef0
  to_url_id = 734cf0b4c37152eb94a58e0c9d7f0c63

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/parameters/clone?from_url_id=7c44c34c0c740e2c77ab8275e81c1ef0&to_url_id=734cf0b4c37152eb94a58e0c9d7f0c63&format=xml

Query parameters

from_url_id = 7c44c34c0c740e2c77ab8275e81c1ef0
  to_url_id = 734cf0b4c37152eb94a58e0c9d7f0c63
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/parameters/clone?from_url_id=7c44c34c0c740e2c77ab8275e81c1ef0&to_url_id=734cf0b4c37152eb94a58e0c9d7f0c63&format=txt

Query parameters

from_url_id = 7c44c34c0c740e2c77ab8275e81c1ef0
  to_url_id = 734cf0b4c37152eb94a58e0c9d7f0c63
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/parameters/clone?from_url_id=7c44c34c0c740e2c77ab8275e81c1ef0&to_url_id=734cf0b4c37152eb94a58e0c9d7f0c63&format=plain

Query parameters

from_url_id = 7c44c34c0c740e2c77ab8275e81c1ef0
  to_url_id = 734cf0b4c37152eb94a58e0c9d7f0c63
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the UTM paramters from
to_url_idID	ID of the tracking link you want to copy the UTM paramters to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/parameters/delete

access: [WRITE]

Delete UTM parameters from the destination URL of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/parameters/delete?url_id=5d28aa7fe5c7d7f83e1f98d81e501fba

Query parameters

url_id = 5d28aa7fe5c7d7f83e1f98d81e501fba

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/parameters/delete?url_id=5d28aa7fe5c7d7f83e1f98d81e501fba&format=xml

Query parameters

url_id = 5d28aa7fe5c7d7f83e1f98d81e501fba
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/parameters/delete?url_id=5d28aa7fe5c7d7f83e1f98d81e501fba&format=txt

Query parameters

url_id = 5d28aa7fe5c7d7f83e1f98d81e501fba
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/parameters/delete?url_id=5d28aa7fe5c7d7f83e1f98d81e501fba&format=plain

Query parameters

url_id = 5d28aa7fe5c7d7f83e1f98d81e501fba
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link from which to remove the UTM parameters

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/parameters/edit

access: [WRITE]

Set query and UTM parameters of the destination URL of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/parameters/edit?url_id=19a299d0aaa4d3a342947c01699242f1&utm_template_id=632e9a7d3c4790e7052629c68ff19470&params%5Bp1%5D=v1&params%5Bp2%5D=v2

Query parameters

         url_id = 19a299d0aaa4d3a342947c01699242f1
utm_template_id = 632e9a7d3c4790e7052629c68ff19470
     params[p1] = v1
     params[p2] = v2

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1,
    "url_id": "19a299d0aaa4d3a342947c01699242f1",
    "enabled": 1,
    "utm_template_id": "632e9a7d3c4790e7052629c68ff19470",
    "utm_source": "",
    "utm_medium": "",
    "utm_campaign": "",
    "utm_term": "",
    "utm_content": "",
    "long_url": "https:\/\/www.joturl.com\/reserved\/projects.html?p1=v1&p2=v2"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/parameters/edit?url_id=19a299d0aaa4d3a342947c01699242f1&utm_template_id=632e9a7d3c4790e7052629c68ff19470&params%5Bp1%5D=v1&params%5Bp2%5D=v2&format=xml

Query parameters

         url_id = 19a299d0aaa4d3a342947c01699242f1
utm_template_id = 632e9a7d3c4790e7052629c68ff19470
     params[p1] = v1
     params[p2] = v2
         format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
    <url_id>19a299d0aaa4d3a342947c01699242f1</url_id>  
    <enabled>1</enabled>  
    <utm_template_id>632e9a7d3c4790e7052629c68ff19470</utm_template_id>  
    <utm_source></utm_source>  
    <utm_medium></utm_medium>  
    <utm_campaign></utm_campaign>  
    <utm_term></utm_term>  
    <utm_content></utm_content>  
    <long_url><[CDATA[https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2]]></long_url>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/parameters/edit?url_id=19a299d0aaa4d3a342947c01699242f1&utm_template_id=632e9a7d3c4790e7052629c68ff19470&params%5Bp1%5D=v1&params%5Bp2%5D=v2&format=txt

Query parameters

         url_id = 19a299d0aaa4d3a342947c01699242f1
utm_template_id = 632e9a7d3c4790e7052629c68ff19470
     params[p1] = v1
     params[p2] = v2
         format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
result_url_id=19a299d0aaa4d3a342947c01699242f1
result_enabled=1
result_utm_template_id=632e9a7d3c4790e7052629c68ff19470
result_utm_source=
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=
result_long_url=https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/parameters/edit?url_id=19a299d0aaa4d3a342947c01699242f1&utm_template_id=632e9a7d3c4790e7052629c68ff19470&params%5Bp1%5D=v1&params%5Bp2%5D=v2&format=plain

Query parameters

         url_id = 19a299d0aaa4d3a342947c01699242f1
utm_template_id = 632e9a7d3c4790e7052629c68ff19470
     params[p1] = v1
     params[p2] = v2
         format = plain

Response

1
19a299d0aaa4d3a342947c01699242f1
1
632e9a7d3c4790e7052629c68ff19470





https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2

Required parameters

parameter	description
url_idID	ID of the tracking link

Optional parameters

parameter	description
paramsJSON	couples (key,value) to be set in the destination URL of the tracking link, this only affects the main destination URL, other destination URLs coming from other options (e.g., balancer, timing) are not changed. Old parameters are deleted or changed with the passed values.
utm_campaignSTRING	UTM campaign parameter
utm_contentSTRING	UTM content parameter
utm_mediumSTRING	UTM medium parameter
utm_sourceSTRING	UTM source parameter
utm_template_idID	ID of the UTM template to associate to the tracking link
utm_termSTRING	UTM term parameter

Return values

parameter	description
added	1 on success, 0 otherwise
enabled	1 if UTM parameters have been set for the tracking link, 0 otherwise
long_url	[OPTIONAL] returned only if input paramter params is passed
utm_campaign	echo back of the input utm_campaign parameter if utm_template_id is not passed, empty otherwise
utm_content	echo back of the input utm_content parameter if utm_template_id is not passed, empty otherwise
utm_medium	echo back of the input utm_medium parameter if utm_template_id is not passed, empty otherwise
utm_source	echo back of the input utm_source parameter if utm_template_id is not passed, empty otherwise
utm_template_id	echo back of the input utm_template_id parameter
utm_term	echo back of the input utm_term parameter if utm_template_id is not passed, empty otherwise

/urls/parameters/info

access: [READ]

Get query and UTM parameters of the destination URL of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/parameters/info?url_id=d7f0b5e1a244a0653d09dbbc6c0bb168

Query parameters

url_id = d7f0b5e1a244a0653d09dbbc6c0bb168

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "params": {
      "p1": "v1",
      "p2": "v2"
    },
    "utm_template_id": "03eef3821e65234edd34fa300fb5e33d",
    "name": "template name",
    "utm_source": "",
    "utm_medium": "",
    "utm_campaign": "",
    "utm_term": "",
    "utm_content": "",
    "long_url": "https:\/\/www.joturl.com\/reserved\/projects.html?p1=v1&p2=v2"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/parameters/info?url_id=d7f0b5e1a244a0653d09dbbc6c0bb168&format=xml

Query parameters

url_id = d7f0b5e1a244a0653d09dbbc6c0bb168
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <params>
      <p1>v1</p1>  
      <p2>v2</p2>  
    </params>  
    <utm_template_id>03eef3821e65234edd34fa300fb5e33d</utm_template_id>  
    <name>template name</name>  
    <utm_source></utm_source>  
    <utm_medium></utm_medium>  
    <utm_campaign></utm_campaign>  
    <utm_term></utm_term>  
    <utm_content></utm_content>  
    <long_url><[CDATA[https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2]]></long_url>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/parameters/info?url_id=d7f0b5e1a244a0653d09dbbc6c0bb168&format=txt

Query parameters

url_id = d7f0b5e1a244a0653d09dbbc6c0bb168
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_params_p1=v1
result_params_p2=v2
result_utm_template_id=03eef3821e65234edd34fa300fb5e33d
result_name=template name
result_utm_source=
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=
result_long_url=https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/parameters/info?url_id=d7f0b5e1a244a0653d09dbbc6c0bb168&format=plain

Query parameters

url_id = d7f0b5e1a244a0653d09dbbc6c0bb168
format = plain

Response

v1
v2
03eef3821e65234edd34fa300fb5e33d
template name





https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2

Required parameters

parameter	description
url_idID	ID of the tracking link

Return values

parameter	description
long_url	destination URL of the tracking link
name	name of the UTM template if utm_template_id is not empty
params	couples (key,value) representing query parameters of the destination URL
utm_campaign	utm_campaign parameter, it is the utm_campaign defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_campaign defined in the tracking link (if available)
utm_content	utm_content parameter, it is the utm_content defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_content defined in the tracking link (if available)
utm_medium	utm_medium parameter, it is the utm_medium defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_medium defined in the tracking link (if available)
utm_source	utm_source parameter, it is the utm_source defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_source defined in the tracking link (if available)
utm_template_id	ID of the applied UTM template, if available
utm_term	utm_term parameter, it is the utm_term defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_term defined in the tracking link (if available)

/urls/password

/urls/password/clone

access: [WRITE]

Clone a password from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/password/clone?from_url_id=ce288fe827f68059279bf10321678db9&to_url_id=1c13a0c361a1773a062a2e26ce24e94e

Query parameters

from_url_id = ce288fe827f68059279bf10321678db9
  to_url_id = 1c13a0c361a1773a062a2e26ce24e94e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/password/clone?from_url_id=ce288fe827f68059279bf10321678db9&to_url_id=1c13a0c361a1773a062a2e26ce24e94e&format=xml

Query parameters

from_url_id = ce288fe827f68059279bf10321678db9
  to_url_id = 1c13a0c361a1773a062a2e26ce24e94e
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/password/clone?from_url_id=ce288fe827f68059279bf10321678db9&to_url_id=1c13a0c361a1773a062a2e26ce24e94e&format=txt

Query parameters

from_url_id = ce288fe827f68059279bf10321678db9
  to_url_id = 1c13a0c361a1773a062a2e26ce24e94e
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/password/clone?from_url_id=ce288fe827f68059279bf10321678db9&to_url_id=1c13a0c361a1773a062a2e26ce24e94e&format=plain

Query parameters

from_url_id = ce288fe827f68059279bf10321678db9
  to_url_id = 1c13a0c361a1773a062a2e26ce24e94e
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy password from
to_url_idID	ID of the tracking link you want to copy password to

Return values

parameter	description
cloned	1 on success, 0 otherwise (e.g., the password is empty)

/urls/password/delete

access: [WRITE]

Delete the password of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/password/delete?id=bfc8485a4ec241ffd11dd53c3cacd50d

Query parameters

id = bfc8485a4ec241ffd11dd53c3cacd50d

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/password/delete?id=bfc8485a4ec241ffd11dd53c3cacd50d&format=xml

Query parameters

    id = bfc8485a4ec241ffd11dd53c3cacd50d
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/password/delete?id=bfc8485a4ec241ffd11dd53c3cacd50d&format=txt

Query parameters

    id = bfc8485a4ec241ffd11dd53c3cacd50d
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/password/delete?id=bfc8485a4ec241ffd11dd53c3cacd50d&format=plain

Query parameters

    id = bfc8485a4ec241ffd11dd53c3cacd50d
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove the password

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/password/edit

access: [WRITE]

Define a password for the tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/password/edit?id=0f4429117e3dec683f35216c33972fc1&password=2d3d9e35

Query parameters

      id = 0f4429117e3dec683f35216c33972fc1
password = 2d3d9e35

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "password": "2d3d9e35"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/password/edit?id=0f4429117e3dec683f35216c33972fc1&password=2d3d9e35&format=xml

Query parameters

      id = 0f4429117e3dec683f35216c33972fc1
password = 2d3d9e35
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <password>2d3d9e35</password>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/password/edit?id=0f4429117e3dec683f35216c33972fc1&password=2d3d9e35&format=txt

Query parameters

      id = 0f4429117e3dec683f35216c33972fc1
password = 2d3d9e35
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_password=2d3d9e35

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/password/edit?id=0f4429117e3dec683f35216c33972fc1&password=2d3d9e35&format=plain

Query parameters

      id = 0f4429117e3dec683f35216c33972fc1
password = 2d3d9e35
  format = plain

Response

2d3d9e35

Required parameters

parameter	description	max length
idID	ID of the tracking link
passwordSTRING	password to use to protect the tracking link	15

Return values

parameter	description
password	echo back of parameter password

/urls/password/info

access: [READ]

Get the password of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/password/info?id=f066e775a7c43ab693e1556efdc6fddb

Query parameters

id = f066e775a7c43ab693e1556efdc6fddb

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "password": "e2319ffd"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/password/info?id=f066e775a7c43ab693e1556efdc6fddb&format=xml

Query parameters

    id = f066e775a7c43ab693e1556efdc6fddb
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <password>e2319ffd</password>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/password/info?id=f066e775a7c43ab693e1556efdc6fddb&format=txt

Query parameters

    id = f066e775a7c43ab693e1556efdc6fddb
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_password=e2319ffd

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/password/info?id=f066e775a7c43ab693e1556efdc6fddb&format=plain

Query parameters

    id = f066e775a7c43ab693e1556efdc6fddb
format = plain

Response

e2319ffd

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
password	password used to pretect the tracking link, empty otherwise

/urls/preview

/urls/preview/clone

access: [WRITE]

Clone the preview configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/preview/clone?from_url_id=1bfb3a5dd5e51efce5cc2d524d4c5e21&to_url_id=3263ef5492630633401796b3fbdb6000

Query parameters

from_url_id = 1bfb3a5dd5e51efce5cc2d524d4c5e21
  to_url_id = 3263ef5492630633401796b3fbdb6000

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/preview/clone?from_url_id=1bfb3a5dd5e51efce5cc2d524d4c5e21&to_url_id=3263ef5492630633401796b3fbdb6000&format=xml

Query parameters

from_url_id = 1bfb3a5dd5e51efce5cc2d524d4c5e21
  to_url_id = 3263ef5492630633401796b3fbdb6000
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/preview/clone?from_url_id=1bfb3a5dd5e51efce5cc2d524d4c5e21&to_url_id=3263ef5492630633401796b3fbdb6000&format=txt

Query parameters

from_url_id = 1bfb3a5dd5e51efce5cc2d524d4c5e21
  to_url_id = 3263ef5492630633401796b3fbdb6000
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/preview/clone?from_url_id=1bfb3a5dd5e51efce5cc2d524d4c5e21&to_url_id=3263ef5492630633401796b3fbdb6000&format=plain

Query parameters

from_url_id = 1bfb3a5dd5e51efce5cc2d524d4c5e21
  to_url_id = 3263ef5492630633401796b3fbdb6000
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the preview configuration from
to_url_idID	ID of the tracking link you want to copy the preview configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/preview/delete

access: [WRITE]

Delete the preview option from a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/preview/delete?id=5ef1e4073467858d44141dc782bb2985

Query parameters

id = 5ef1e4073467858d44141dc782bb2985

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/preview/delete?id=5ef1e4073467858d44141dc782bb2985&format=xml

Query parameters

    id = 5ef1e4073467858d44141dc782bb2985
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/preview/delete?id=5ef1e4073467858d44141dc782bb2985&format=txt

Query parameters

    id = 5ef1e4073467858d44141dc782bb2985
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/preview/delete?id=5ef1e4073467858d44141dc782bb2985&format=plain

Query parameters

    id = 5ef1e4073467858d44141dc782bb2985
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a preview configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/preview/edit

access: [WRITE]

Set a preview option for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/preview/edit?id=6ce41836354a9db8399673341f59002f&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg

Query parameters

         id = 6ce41836354a9db8399673341f59002f
      title = This is a custom title
description = This is a custom description
      image = https://path.to/link/preview/image.jpg

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/preview/edit?id=6ce41836354a9db8399673341f59002f&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg&format=xml

Query parameters

         id = 6ce41836354a9db8399673341f59002f
      title = This is a custom title
description = This is a custom description
      image = https://path.to/link/preview/image.jpg
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/preview/edit?id=6ce41836354a9db8399673341f59002f&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg&format=txt

Query parameters

         id = 6ce41836354a9db8399673341f59002f
      title = This is a custom title
description = This is a custom description
      image = https://path.to/link/preview/image.jpg
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/preview/edit?id=6ce41836354a9db8399673341f59002f&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg&format=plain

Query parameters

         id = 6ce41836354a9db8399673341f59002f
      title = This is a custom title
description = This is a custom description
      image = https://path.to/link/preview/image.jpg
     format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link

Optional parameters

parameter	description	max length
cdn_imageJSON	JSON containing info on the CDN image to be used, if present it overrides the `image` parameter, see i1/cdns/list for details on this object
descriptionSTRING	Open Graph description for the preview page	2000
imageURL	complete URL for the Open Graph image to be used, this URL must be in HTTPS to avoid securiy issues, alternatively you can pass a CDN image by using the `cdn_image` parameter	4000
titleSTRING	Open Graph title for the preview page	2000

Return values

parameter	description
enabled	1 on success, 0 otherwise

/urls/preview/info

access: [READ]

Get link preview information for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/preview/info?id=16133b8ae2835a1aa584f158ede56a11

Query parameters

id = 16133b8ae2835a1aa584f158ede56a11

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "title": "This is a custom title",
    "description": "This is a custom description",
    "image": "https:\/\/path.to\/link\/preview\/image.jpg"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/preview/info?id=16133b8ae2835a1aa584f158ede56a11&format=xml

Query parameters

    id = 16133b8ae2835a1aa584f158ede56a11
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <title>This is a custom title</title>  
    <description>This is a custom description</description>  
    <image>https://path.to/link/preview/image.jpg</image>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/preview/info?id=16133b8ae2835a1aa584f158ede56a11&format=txt

Query parameters

    id = 16133b8ae2835a1aa584f158ede56a11
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_title=This is a custom title
result_description=This is a custom description
result_image=https://path.to/link/preview/image.jpg

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/preview/info?id=16133b8ae2835a1aa584f158ede56a11&format=plain

Query parameters

    id = 16133b8ae2835a1aa584f158ede56a11
format = plain

Response

This is a custom title
This is a custom description
https://path.to/link/preview/image.jpg

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
cdn_image	[OPTIONAL] JSON containing info on the CDN image, see i1/urls/preview/edit for details
description	[OPTIONAL] description to be shown in the link preview
image	[OPTIONAL] image to be shown in the link preview
title	[OPTIONAL] title to be shown in the link preview

/urls/preview/property

access: [READ]

Returns the list of available properties for the Preview option.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/preview/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "image": {
      "max_size": 512000,
      "max_width": 1200,
      "max_height": 630
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/preview/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <image>
      <max_size>512000</max_size>  
      <max_width>1200</max_width>  
      <max_height>630</max_height>  
    </image>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/preview/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_image_max_size=512000
result_image_max_width=1200
result_image_max_height=630

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/preview/property?format=plain

Query parameters

format = plain

Response

512000
1200
630

Return values

parameter	description
image	limits ( `max_size` in bytes, `max_width` in pixels, `max_height` in pixels) for the preview image

/urls/qrcodes

/urls/qrcodes/add

access: [WRITE]

Set a Qr code template for a short URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/qrcodes/add?id=8a1ba689d85df2dff73e361dcce0a7a8&qrcode_id=06900670fac7b5cc87b4862edb90d797

Query parameters

       id = 8a1ba689d85df2dff73e361dcce0a7a8
qrcode_id = 06900670fac7b5cc87b4862edb90d797

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/qrcodes/add?id=8a1ba689d85df2dff73e361dcce0a7a8&qrcode_id=06900670fac7b5cc87b4862edb90d797&format=xml

Query parameters

       id = 8a1ba689d85df2dff73e361dcce0a7a8
qrcode_id = 06900670fac7b5cc87b4862edb90d797
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>1</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/qrcodes/add?id=8a1ba689d85df2dff73e361dcce0a7a8&qrcode_id=06900670fac7b5cc87b4862edb90d797&format=txt

Query parameters

       id = 8a1ba689d85df2dff73e361dcce0a7a8
qrcode_id = 06900670fac7b5cc87b4862edb90d797
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/qrcodes/add?id=8a1ba689d85df2dff73e361dcce0a7a8&qrcode_id=06900670fac7b5cc87b4862edb90d797&format=plain

Query parameters

       id = 8a1ba689d85df2dff73e361dcce0a7a8
qrcode_id = 06900670fac7b5cc87b4862edb90d797
   format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link
qrcode_idID	ID of the QR code template to associate to the tracking link

Return values

parameter	description
added	1 on success, 0 otherwise

/urls/qrcodes/clone

access: [WRITE]

Clone the qrcodes configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=46b47bdd03dc116d21a730daf599b366&to_url_id=fee6bad69db9d8840006d808c80bc736

Query parameters

from_url_id = 46b47bdd03dc116d21a730daf599b366
  to_url_id = fee6bad69db9d8840006d808c80bc736

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=46b47bdd03dc116d21a730daf599b366&to_url_id=fee6bad69db9d8840006d808c80bc736&format=xml

Query parameters

from_url_id = 46b47bdd03dc116d21a730daf599b366
  to_url_id = fee6bad69db9d8840006d808c80bc736
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=46b47bdd03dc116d21a730daf599b366&to_url_id=fee6bad69db9d8840006d808c80bc736&format=txt

Query parameters

from_url_id = 46b47bdd03dc116d21a730daf599b366
  to_url_id = fee6bad69db9d8840006d808c80bc736
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=46b47bdd03dc116d21a730daf599b366&to_url_id=fee6bad69db9d8840006d808c80bc736&format=plain

Query parameters

from_url_id = 46b47bdd03dc116d21a730daf599b366
  to_url_id = fee6bad69db9d8840006d808c80bc736
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy qrcode configuration from
to_url_idID	ID of the tracking link you want to copy qrcode configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/qrcodes/delete

access: [WRITE]

Unset a Qr code template for a short URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/qrcodes/delete?id=b332fca21f823bd5d7ee17781af8ed5e&qrcode_id=1a855710eb0c9c71d6dad141968e473b

Query parameters

       id = b332fca21f823bd5d7ee17781af8ed5e
qrcode_id = 1a855710eb0c9c71d6dad141968e473b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/qrcodes/delete?id=b332fca21f823bd5d7ee17781af8ed5e&qrcode_id=1a855710eb0c9c71d6dad141968e473b&format=xml

Query parameters

       id = b332fca21f823bd5d7ee17781af8ed5e
qrcode_id = 1a855710eb0c9c71d6dad141968e473b
   format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/qrcodes/delete?id=b332fca21f823bd5d7ee17781af8ed5e&qrcode_id=1a855710eb0c9c71d6dad141968e473b&format=txt

Query parameters

       id = b332fca21f823bd5d7ee17781af8ed5e
qrcode_id = 1a855710eb0c9c71d6dad141968e473b
   format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/qrcodes/delete?id=b332fca21f823bd5d7ee17781af8ed5e&qrcode_id=1a855710eb0c9c71d6dad141968e473b&format=plain

Query parameters

       id = b332fca21f823bd5d7ee17781af8ed5e
qrcode_id = 1a855710eb0c9c71d6dad141968e473b
   format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove the QR code configuration

Optional parameters

parameter	description
qrcode_idID	ID of the QR code configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/qrcodes/info

access: [READ]

Returns information on QR code customization, if present.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/qrcodes/info?id=fd46e9e5b0efe13abddd659fe7f5706d&fields=id,name,shape

Query parameters

    id = fd46e9e5b0efe13abddd659fe7f5706d
fields = id,name,shape

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "949cb8262db5fa8a0870aee44841722b",
    "name": "QR code template name",
    "shape": "rhombus"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/qrcodes/info?id=fd46e9e5b0efe13abddd659fe7f5706d&fields=id,name,shape&format=xml

Query parameters

    id = fd46e9e5b0efe13abddd659fe7f5706d
fields = id,name,shape
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>949cb8262db5fa8a0870aee44841722b</id>  
    <name>QR code template name</name>  
    <shape>rhombus</shape>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/qrcodes/info?id=fd46e9e5b0efe13abddd659fe7f5706d&fields=id,name,shape&format=txt

Query parameters

    id = fd46e9e5b0efe13abddd659fe7f5706d
fields = id,name,shape
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=949cb8262db5fa8a0870aee44841722b
result_name=QR code template name
result_shape=rhombus

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/qrcodes/info?id=fd46e9e5b0efe13abddd659fe7f5706d&fields=id,name,shape&format=plain

Query parameters

    id = fd46e9e5b0efe13abddd659fe7f5706d
fields = id,name,shape
format = plain

Response

949cb8262db5fa8a0870aee44841722b
QR code template name
rhombus

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, see i1/qrcodes/info for details
idID	ID of the tracking link

Return values

parameter	description
data	see i1/qrcodes/info for details

/urls/qrcodes/preview

access: [READ]

This method returns a preview of the QR code associated to the tracking link (if any).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=72a1c2c6fd3297e7eaf3746e6c367142

Query parameters

size = big
  id = 72a1c2c6fd3297e7eaf3746e6c367142

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "img": "data:image\/png;base64,ZGYwYTIwNjNlOTEyMTRkNjA0Y2QzMThiYzlkNDdkOTU="
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=72a1c2c6fd3297e7eaf3746e6c367142&format=xml

Query parameters

  size = big
    id = 72a1c2c6fd3297e7eaf3746e6c367142
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <img>data:image/png;base64,ZGYwYTIwNjNlOTEyMTRkNjA0Y2QzMThiYzlkNDdkOTU=</img>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=72a1c2c6fd3297e7eaf3746e6c367142&format=txt

Query parameters

  size = big
    id = 72a1c2c6fd3297e7eaf3746e6c367142
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_img=data:image/png;base64,ZGYwYTIwNjNlOTEyMTRkNjA0Y2QzMThiYzlkNDdkOTU=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=72a1c2c6fd3297e7eaf3746e6c367142&format=plain

Query parameters

  size = big
    id = 72a1c2c6fd3297e7eaf3746e6c367142
format = plain

Response

data:image/png;base64,ZGYwYTIwNjNlOTEyMTRkNjA0Y2QzMThiYzlkNDdkOTU=

Required parameters

parameter	description
idID	ID of the tracking link

Optional parameters

parameter	description
downloadBOOLEAN	see i1/qrcodes/preview for details
return_imageBOOLEAN	see i1/qrcodes/preview for details
sizeSTRING	see i1/qrcodes/preview for details
typeSTRING	see i1/qrcodes/preview for details

Return values

parameter	description
[BINARY DATA]	see i1/qrcodes/preview for details
img	see i1/qrcodes/preview for details

/urls/remarketings

/urls/remarketings/add

access: [WRITE]

Add remarketing pixels to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/remarketings/add?url_id=9ec4ae148db59656e1efe8c5175b10e3&ids=dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9

Query parameters

url_id = 9ec4ae148db59656e1efe8c5175b10e3
   ids = dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/remarketings/add?url_id=9ec4ae148db59656e1efe8c5175b10e3&ids=dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9&format=xml

Query parameters

url_id = 9ec4ae148db59656e1efe8c5175b10e3
   ids = dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>5</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/remarketings/add?url_id=9ec4ae148db59656e1efe8c5175b10e3&ids=dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9&format=txt

Query parameters

url_id = 9ec4ae148db59656e1efe8c5175b10e3
   ids = dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=5

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/remarketings/add?url_id=9ec4ae148db59656e1efe8c5175b10e3&ids=dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9&format=plain

Query parameters

url_id = 9ec4ae148db59656e1efe8c5175b10e3
   ids = dc8e885c175516345ab388758ab75307,12748f764098adb8976cb939982484bf,dec2333769e0ef2b7fdad86701e07abe,a1f27109ae5eea6d79e6cc89b27352d0,7b01977d86bddee689d258cad45da8c9
format = plain

Response

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of remarketing pixels to add (maxmimum number of remarketing pixels: 5)
url_idID	ID of the tracking link to which to add one or more remarketing pixels

Return values

parameter	description
added	0 on error, the number of added remarketing pixels otherwise

/urls/remarketings/clone

access: [WRITE]

Clone the remarketings configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=9f4670dbf96c845a1837e4c73d3013ea&to_url_id=599cc169aa0a911d5cd03e2b90e0fa50

Query parameters

from_url_id = 9f4670dbf96c845a1837e4c73d3013ea
  to_url_id = 599cc169aa0a911d5cd03e2b90e0fa50

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=9f4670dbf96c845a1837e4c73d3013ea&to_url_id=599cc169aa0a911d5cd03e2b90e0fa50&format=xml

Query parameters

from_url_id = 9f4670dbf96c845a1837e4c73d3013ea
  to_url_id = 599cc169aa0a911d5cd03e2b90e0fa50
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=9f4670dbf96c845a1837e4c73d3013ea&to_url_id=599cc169aa0a911d5cd03e2b90e0fa50&format=txt

Query parameters

from_url_id = 9f4670dbf96c845a1837e4c73d3013ea
  to_url_id = 599cc169aa0a911d5cd03e2b90e0fa50
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=9f4670dbf96c845a1837e4c73d3013ea&to_url_id=599cc169aa0a911d5cd03e2b90e0fa50&format=plain

Query parameters

from_url_id = 9f4670dbf96c845a1837e4c73d3013ea
  to_url_id = 599cc169aa0a911d5cd03e2b90e0fa50
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the remarketings configuration from
to_url_idID	ID of the tracking link you want to copy the remarketings configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/remarketings/count

access: [READ]

This method returns the number of remarketing pixels linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/remarketings/count?url_id=8b0c5d09b15b9fc9602cbac3cdcebe39

Query parameters

url_id = 8b0c5d09b15b9fc9602cbac3cdcebe39

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 5
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/remarketings/count?url_id=8b0c5d09b15b9fc9602cbac3cdcebe39&format=xml

Query parameters

url_id = 8b0c5d09b15b9fc9602cbac3cdcebe39
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>5</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/remarketings/count?url_id=8b0c5d09b15b9fc9602cbac3cdcebe39&format=txt

Query parameters

url_id = 8b0c5d09b15b9fc9602cbac3cdcebe39
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/remarketings/count?url_id=8b0c5d09b15b9fc9602cbac3cdcebe39&format=plain

Query parameters

url_id = 8b0c5d09b15b9fc9602cbac3cdcebe39
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link to check

Return values

parameter	description
count	the number of linked remakerting pixels

/urls/remarketings/delete

access: [WRITE]

Delete one or more remarketing pixels linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/remarketings/delete?url_id=30209ad80de2ae4f70b236ed9fe74ecf

Query parameters

url_id = 30209ad80de2ae4f70b236ed9fe74ecf

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/remarketings/delete?url_id=30209ad80de2ae4f70b236ed9fe74ecf&format=xml

Query parameters

url_id = 30209ad80de2ae4f70b236ed9fe74ecf
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/remarketings/delete?url_id=30209ad80de2ae4f70b236ed9fe74ecf&format=txt

Query parameters

url_id = 30209ad80de2ae4f70b236ed9fe74ecf
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/remarketings/delete?url_id=30209ad80de2ae4f70b236ed9fe74ecf&format=plain

Query parameters

url_id = 30209ad80de2ae4f70b236ed9fe74ecf
format = plain

Response

Required parameters

parameter	description
url_idID	ID of the tracking link from which to remove one or more remarketing pixels

Optional parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of remarketing pixels to remove, if empty all remarketing pixels will be removed

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/remarketings/edit

access: [WRITE]

Edit the list of tracking pixels linked to a tracking link (all previous tracking pixels are removed).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/remarketings/edit?url_id=08d99c557fb6916fd73d4dc2b06dcac9&ids=d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af

Query parameters

url_id = 08d99c557fb6916fd73d4dc2b06dcac9
   ids = d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ids": "d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/remarketings/edit?url_id=08d99c557fb6916fd73d4dc2b06dcac9&ids=d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af&format=xml

Query parameters

url_id = 08d99c557fb6916fd73d4dc2b06dcac9
   ids = d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ids>d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af</ids>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/remarketings/edit?url_id=08d99c557fb6916fd73d4dc2b06dcac9&ids=d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af&format=txt

Query parameters

url_id = 08d99c557fb6916fd73d4dc2b06dcac9
   ids = d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/remarketings/edit?url_id=08d99c557fb6916fd73d4dc2b06dcac9&ids=d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af&format=plain

Query parameters

url_id = 08d99c557fb6916fd73d4dc2b06dcac9
   ids = d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af
format = plain

Response

d292ca6513060c51802a958db76b4ce0,cf619f645c82613a1547b4ade090b452,b36ea27f6caab3e7f1443adb1ea2641c,2f89fbe089811990cd3c466aa7873027,05df3b41112de3088e2b62c7c4a644af

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of remarketing pixels to add (maxmimum number of remarketing pixels: 5)
url_idID	ID of the tracking link to which to add one or more remarketing pixels

Return values

parameter	description
ids	comma-separated list of added remarketing pixels

/urls/remarketings/list

access: [READ]

This method returns a list of remarketing pixels linked to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=e5023240f4c615e7ba462df53ea2f088

Query parameters

fields = count,id,name,notes,code_type,code_id
url_id = e5023240f4c615e7ba462df53ea2f088

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "id": "4497b9bf1717e2b362d1862cd40ccacd",
        "name": "remarketing pixel (bing)",
        "notes": "",
        "code_type": "bing",
        "code_id": "1234567890A"
      },
      {
        "id": "74963062a97bb5122daff4067efe05c2",
        "name": "remarketing pixel (facebook)",
        "notes": "remarketing pixel for FB",
        "code_type": "facebook",
        "code_id": "A0987654321"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=e5023240f4c615e7ba462df53ea2f088&format=xml

Query parameters

fields = count,id,name,notes,code_type,code_id
url_id = e5023240f4c615e7ba462df53ea2f088
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <id>4497b9bf1717e2b362d1862cd40ccacd</id>  
        <name>remarketing pixel (bing)</name>  
        <notes></notes>  
        <code_type>bing</code_type>  
        <code_id>1234567890A</code_id>  
      </i0>  
      <i1>
        <id>74963062a97bb5122daff4067efe05c2</id>  
        <name>remarketing pixel (facebook)</name>  
        <notes>remarketing pixel for FB</notes>  
        <code_type>facebook</code_type>  
        <code_id>A0987654321</code_id>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=e5023240f4c615e7ba462df53ea2f088&format=txt

Query parameters

fields = count,id,name,notes,code_type,code_id
url_id = e5023240f4c615e7ba462df53ea2f088
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=4497b9bf1717e2b362d1862cd40ccacd
result_data_0_name=remarketing pixel (bing)
result_data_0_notes=
result_data_0_code_type=bing
result_data_0_code_id=1234567890A
result_data_1_id=74963062a97bb5122daff4067efe05c2
result_data_1_name=remarketing pixel (facebook)
result_data_1_notes=remarketing pixel for FB
result_data_1_code_type=facebook
result_data_1_code_id=A0987654321

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=e5023240f4c615e7ba462df53ea2f088&format=plain

Query parameters

fields = count,id,name,notes,code_type,code_id
url_id = e5023240f4c615e7ba462df53ea2f088
format = plain

Response

2
4497b9bf1717e2b362d1862cd40ccacd
remarketing pixel (bing)

bing
1234567890A
74963062a97bb5122daff4067efe05c2
remarketing pixel (facebook)
remarketing pixel for FB
facebook
A0987654321

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, name, notes, code_type, code_id
url_idID	ID of the liked tracking link

Optional parameters

parameter	description
lengthINTEGER	extracts this number of remarketing pixels (maxmimum allowed: 100)
orderbyARRAY	orders remarketing pixels by field, available fields: id, name, notes, code_type, code_id
searchSTRING	filters remarketing pixels to be extracted by searching them
sortSTRING	sorts remarketing pixels in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract remarketing pixels from this position

Return values

parameter	description
data	array containing information on the remarketing pixels, returned information depends on the fields parameter.

/urls/selfdestruction

/urls/selfdestruction/clone

access: [WRITE]

Clone a self destruction configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=82e4fd05671f7ebd54b26e0bb06151ee&to_url_id=e7bf702bb444fa66e98188550ae64270

Query parameters

from_url_id = 82e4fd05671f7ebd54b26e0bb06151ee
  to_url_id = e7bf702bb444fa66e98188550ae64270

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=82e4fd05671f7ebd54b26e0bb06151ee&to_url_id=e7bf702bb444fa66e98188550ae64270&format=xml

Query parameters

from_url_id = 82e4fd05671f7ebd54b26e0bb06151ee
  to_url_id = e7bf702bb444fa66e98188550ae64270
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=82e4fd05671f7ebd54b26e0bb06151ee&to_url_id=e7bf702bb444fa66e98188550ae64270&format=txt

Query parameters

from_url_id = 82e4fd05671f7ebd54b26e0bb06151ee
  to_url_id = e7bf702bb444fa66e98188550ae64270
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=82e4fd05671f7ebd54b26e0bb06151ee&to_url_id=e7bf702bb444fa66e98188550ae64270&format=plain

Query parameters

from_url_id = 82e4fd05671f7ebd54b26e0bb06151ee
  to_url_id = e7bf702bb444fa66e98188550ae64270
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy self destruction configuration from
to_url_idID	ID of the tracking link you want to copy self destruction configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/selfdestruction/delete

access: [WRITE]

Delete the self destruction configuration of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/selfdestruction/delete?id=89afc45eba56d1f40ea3c7fe716ce459

Query parameters

id = 89afc45eba56d1f40ea3c7fe716ce459

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/selfdestruction/delete?id=89afc45eba56d1f40ea3c7fe716ce459&format=xml

Query parameters

    id = 89afc45eba56d1f40ea3c7fe716ce459
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/selfdestruction/delete?id=89afc45eba56d1f40ea3c7fe716ce459&format=txt

Query parameters

    id = 89afc45eba56d1f40ea3c7fe716ce459
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/selfdestruction/delete?id=89afc45eba56d1f40ea3c7fe716ce459&format=plain

Query parameters

    id = 89afc45eba56d1f40ea3c7fe716ce459
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a self destruction configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/selfdestruction/edit

access: [WRITE]

Given the ID of a tracking link, sets a self destruction configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/selfdestruction/edit?id=f221b2e8962b71eff712915207ce91aa&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100

Query parameters

               id = f221b2e8962b71eff712915207ce91aa
      time_offset = 1
        time_base = years
        from_what = creation
    condition_var = visits
condition_operand = <=
  condition_value = 100

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "time_offset": "1",
    "time_base": "years",
    "from_what": "creation",
    "condition_var": "visits",
    "condition_operand": "<=",
    "condition_value": "100"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/selfdestruction/edit?id=f221b2e8962b71eff712915207ce91aa&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100&format=xml

Query parameters

               id = f221b2e8962b71eff712915207ce91aa
      time_offset = 1
        time_base = years
        from_what = creation
    condition_var = visits
condition_operand = <=
  condition_value = 100
           format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <time_offset>1</time_offset>  
    <time_base>years</time_base>  
    <from_what>creation</from_what>  
    <condition_var>visits</condition_var>  
    <condition_operand><[CDATA[&lt;=]]></condition_operand>  
    <condition_value>100</condition_value>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/selfdestruction/edit?id=f221b2e8962b71eff712915207ce91aa&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100&format=txt

Query parameters

               id = f221b2e8962b71eff712915207ce91aa
      time_offset = 1
        time_base = years
        from_what = creation
    condition_var = visits
condition_operand = <=
  condition_value = 100
           format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_time_offset=1
result_time_base=years
result_from_what=creation
result_condition_var=visits
result_condition_operand=&lt;=
result_condition_value=100

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/selfdestruction/edit?id=f221b2e8962b71eff712915207ce91aa&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100&format=plain

Query parameters

               id = f221b2e8962b71eff712915207ce91aa
      time_offset = 1
        time_base = years
        from_what = creation
    condition_var = visits
condition_operand = <=
  condition_value = 100
           format = plain

Response

1
years
creation
visits
&lt;=
100

Required parameters

parameter	description
condition_varENUM	the condition to be met in order to delete the tracking link, see notes for a list of available variables
from_whatENUM	time reference, the event from which the `time_offset` is evaluated, see notes for a list of available time references
idID	ID of the tracking link
time_baseENUM	time base, see notes for a list of available time bases
time_offsetINTEGER	time offset (integer greater than 0)

Available values for time_base:

seconds: seconds
minutes: minutes
hours: hours
days: days
weeks: weeks
months: months
years: years

Available values for from_what:

creation: tracking link creation
lastvisit: last visit to the tracking link
now: the date/time when the option is enabled
datetime: custom date/time

Available values for condition_var:

inanycase: delete the tracking link in any case
visits: delete the tracking link only if a specific condition is met on visits to the tracking link
uniquevisits: delete the tracking link only if a specific condition is met on unique visits to the tracking link
qrvisits: delete the tracking link only if a specific condition is met on QR code visits to the tracking link

WARNING 1: the moment at which the condition is evaluated (i.e., the evaluation time) is obtained with the formula

time_offset [time_base] + from_what

for example if time_offset = 3, time_base = months, from_what = creation and creation = 2026-05-26 14:00:32, the evaluation time will be 3 months + 2026-05-26 14:00:32, i.e., 2026-08-26 14:00:32 (all times are in UTC).

WARNING 2: the evaluation time cannot be in the past with respect to the moment at which the option is enabled.

WARNING 3: The evaluation time has a tolerance of at least 20 minutes, there is no guarantee that the elimination will occur exactly at the moment of the evaluation time.

WARNING 4: When from_what = lastvisit, two evaluation times may be needed, the first evaluation time is obtained with the following algorithm:

if the date/time of the last visit to the tracking link is available, this date/time is taken as the reference, however, if the date/time of the last visit is not available (no visit occurred), the date/time of creation of the tracking link is taken as the reference,
the first evaluation time is set to the maximum between time_offset [time_base] + date/time of activation of the "self destruction" option and time_offset [time_base] + date/time calculated in the previous point.

At the first evaluation time, 3 scenarios may occur:

the tracking link has not received any visits, in this scenario a second evaluation time is calculated using the formula time_offset [time_base] + date/time of the first evaluation time,
the tracking link has received at least one visit and the date/time obtained from the formula time_offset [time_base] + date/time of last visit is less than or equal to the first evaluation time, in this scenario the deletion condition is evaluated and the tracking link is deleted only if that condition is satisfied, no other attempt is made,
the tracking link has received at least one visit and the date/time obtained from the formula time_offset [time_base] + date/time of last visit is greater than the first evaluation time, in this scenario a second evaluation time is calculated using the formula time_offset [time_base] + date/time of last visit.

At the second evaluation stage, available only for scenarios 1 and 3, the deletion condition is evaluated and the tracking link is deleted only if this condition is met, without making any further attempts.

Optional parameters

parameter	description
condition_operandENUM	the operand for the `condition_var`, see notes for a list of available operands; mandatory if `condition_var` is different from `inanycase`
condition_valueINTEGER	the value to be used with `condition_var` (integer greater than or equal to 0), mandatory if `condition_var` is different from `inanycase`
from_dtDATETIME/EMPTY	custom date/time, it cannot be in the past, mandatory when `from_what = datetime`, otherwise it is ignored

Return values

parameter	description
condition_operand	echo back of the input parameter `condition_operand`
condition_value	echo back of the input parameter `condition_value`
condition_var	echo back of the input parameter `condition_var`
from_dt	echo back of the input parameter `from_dt`
from_what	echo back of the input parameter `from_what`
id	echo back of the input parameter `id`
time_base	echo back of the input parameter `time_base`
time_offset	echo back of the input parameter `time_offset`

/urls/selfdestruction/info

access: [READ]

Returns information on the self destruction configuration.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/selfdestruction/info?id=49c6082bf720a55424e5fc3ca721c0d7

Query parameters

id = 49c6082bf720a55424e5fc3ca721c0d7

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "49c6082bf720a55424e5fc3ca721c0d7",
    "time_offset": "1",
    "time_base": "years",
    "from_what": "creation",
    "condition_var": "visits",
    "condition_operand": "<=",
    "condition_value": "100"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/selfdestruction/info?id=49c6082bf720a55424e5fc3ca721c0d7&format=xml

Query parameters

    id = 49c6082bf720a55424e5fc3ca721c0d7
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>49c6082bf720a55424e5fc3ca721c0d7</id>  
    <time_offset>1</time_offset>  
    <time_base>years</time_base>  
    <from_what>creation</from_what>  
    <condition_var>visits</condition_var>  
    <condition_operand><[CDATA[&lt;=]]></condition_operand>  
    <condition_value>100</condition_value>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/selfdestruction/info?id=49c6082bf720a55424e5fc3ca721c0d7&format=txt

Query parameters

    id = 49c6082bf720a55424e5fc3ca721c0d7
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=49c6082bf720a55424e5fc3ca721c0d7
result_time_offset=1
result_time_base=years
result_from_what=creation
result_condition_var=visits
result_condition_operand=&lt;=
result_condition_value=100

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/selfdestruction/info?id=49c6082bf720a55424e5fc3ca721c0d7&format=plain

Query parameters

    id = 49c6082bf720a55424e5fc3ca721c0d7
format = plain

Response

49c6082bf720a55424e5fc3ca721c0d7
1
years
creation
visits
&lt;=
100

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
condition_operand	see i1/urls/selfdestruction/edit for details
condition_value	see i1/urls/selfdestruction/edit for details
condition_var	see i1/urls/selfdestruction/edit for details
from_dt	see i1/urls/selfdestruction/edit for details
from_what	see i1/urls/selfdestruction/edit for details
id	see i1/urls/selfdestruction/edit for details
time_base	see i1/urls/selfdestruction/edit for details
time_offset	see i1/urls/selfdestruction/edit for details

/urls/shorten

access: [WRITE]

Creates a shorten tracking link for a given destination URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)Example 9 (json)Example 10 (xml)Example 11 (txt)Example 12 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=18a769796c5ff79831b4297a86d63415&project_id=7b88aa01def3e6c2e18ae87c2b96d751&long_url=https%3A%2F%2Fwww.joturl.com%2F

Query parameters

     alias = jot
 domain_id = 18a769796c5ff79831b4297a86d63415
project_id = 7b88aa01def3e6c2e18ae87c2b96d751
  long_url = https://www.joturl.com/

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "537b756a56995bba2daa9b1facf8c591",
    "alias": "jot",
    "domain_id": "18a769796c5ff79831b4297a86d63415",
    "domain_host": "jo.my",
    "domain_nickname": "",
    "project_id": "7b88aa01def3e6c2e18ae87c2b96d751",
    "project_name": "project name",
    "short_url": "\/\/jo.my\/jot",
    "long_url": "https:\/\/www.joturl.com\/",
    "template_type": 1,
    "notes": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=18a769796c5ff79831b4297a86d63415&project_id=7b88aa01def3e6c2e18ae87c2b96d751&long_url=https%3A%2F%2Fwww.joturl.com%2F&format=xml

Query parameters

     alias = jot
 domain_id = 18a769796c5ff79831b4297a86d63415
project_id = 7b88aa01def3e6c2e18ae87c2b96d751
  long_url = https://www.joturl.com/
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>537b756a56995bba2daa9b1facf8c591</id>  
    <alias>jot</alias>  
    <domain_id>18a769796c5ff79831b4297a86d63415</domain_id>  
    <domain_host>jo.my</domain_host>  
    <domain_nickname></domain_nickname>  
    <project_id>7b88aa01def3e6c2e18ae87c2b96d751</project_id>  
    <project_name>project name</project_name>  
    <short_url>//jo.my/jot</short_url>  
    <long_url>https://www.joturl.com/</long_url>  
    <template_type>1</template_type>  
    <notes></notes>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=18a769796c5ff79831b4297a86d63415&project_id=7b88aa01def3e6c2e18ae87c2b96d751&long_url=https%3A%2F%2Fwww.joturl.com%2F&format=txt

Query parameters

     alias = jot
 domain_id = 18a769796c5ff79831b4297a86d63415
project_id = 7b88aa01def3e6c2e18ae87c2b96d751
  long_url = https://www.joturl.com/
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=537b756a56995bba2daa9b1facf8c591
result_alias=jot
result_domain_id=18a769796c5ff79831b4297a86d63415
result_domain_host=jo.my
result_domain_nickname=
result_project_id=7b88aa01def3e6c2e18ae87c2b96d751
result_project_name=project name
result_short_url=//jo.my/jot
result_long_url=https://www.joturl.com/
result_template_type=1
result_notes=

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=18a769796c5ff79831b4297a86d63415&project_id=7b88aa01def3e6c2e18ae87c2b96d751&long_url=https%3A%2F%2Fwww.joturl.com%2F&format=plain

Query parameters

     alias = jot
 domain_id = 18a769796c5ff79831b4297a86d63415
project_id = 7b88aa01def3e6c2e18ae87c2b96d751
  long_url = https://www.joturl.com/
    format = plain

Response

//jo.my/jot

Example 5 (json)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=434a66c4453183ea5fc53216bb1805e3&project_id=9c008c479432cd99774935ed43affd61&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=trying+to+shorten+a+URL+whose+alias+was+already+used

Query parameters

     alias = jot
 domain_id = 434a66c4453183ea5fc53216bb1805e3
project_id = 9c008c479432cd99774935ed43affd61
  long_url = https://www.joturl.com/
     notes = trying to shorten a URL whose alias was already used

Response

{
  "status": {
    "code": 503,
    "text": "GENERIC ERROR",
    "error": "The chosen alias is not available.",
    "rate": 3
  },
  "result": []
}

Example 6 (xml)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=434a66c4453183ea5fc53216bb1805e3&project_id=9c008c479432cd99774935ed43affd61&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=trying+to+shorten+a+URL+whose+alias+was+already+used&format=xml

Query parameters

     alias = jot
 domain_id = 434a66c4453183ea5fc53216bb1805e3
project_id = 9c008c479432cd99774935ed43affd61
  long_url = https://www.joturl.com/
     notes = trying to shorten a URL whose alias was already used
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>503</code>  
    <text>GENERIC ERROR</text>  
    <error>The chosen alias is not available.</error>  
    <rate>3</rate>  
  </status>  
  <result>

  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=434a66c4453183ea5fc53216bb1805e3&project_id=9c008c479432cd99774935ed43affd61&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=trying+to+shorten+a+URL+whose+alias+was+already+used&format=txt

Query parameters

     alias = jot
 domain_id = 434a66c4453183ea5fc53216bb1805e3
project_id = 9c008c479432cd99774935ed43affd61
  long_url = https://www.joturl.com/
     notes = trying to shorten a URL whose alias was already used
    format = txt

Response

status_code=503
status_text=GENERIC ERROR
status_error=The chosen alias is not available.
status_rate=3
result=

Example 8 (plain)

Request

https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=434a66c4453183ea5fc53216bb1805e3&project_id=9c008c479432cd99774935ed43affd61&long_url=https%3A%2F%2Fwww.joturl.com%2F&notes=trying+to+shorten+a+URL+whose+alias+was+already+used&format=plain

Query parameters

     alias = jot
 domain_id = 434a66c4453183ea5fc53216bb1805e3
project_id = 9c008c479432cd99774935ed43affd61
  long_url = https://www.joturl.com/
     notes = trying to shorten a URL whose alias was already used
    format = plain

Response

Example 9 (json)

Request

https://joturl.com/a/i1/urls/shorten?domain_id=304a8342debc829d03880aa8a83578c0&project_id=048d91c5e3cf84a0b492f6963d48afc6&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D

Query parameters

 domain_id = 304a8342debc829d03880aa8a83578c0
project_id = 048d91c5e3cf84a0b492f6963d48afc6
      bulk = 1
      info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": [
    {
      "id": "9cc47fac5f8a0bc1f3c2e9d1f2e40c9e",
      "alias": "alias0",
      "domain_id": "7548cc2de5c89a8cd34ca614e0f7cfbb",
      "domain_host": "my.custom.domain",
      "domain_nickname": "",
      "project_id": "480c2aaa7c6b38fa7b03963614ebb5b4",
      "project_name": "project name",
      "short_url": "\/\/my.custom.domain\/alias0",
      "long_url": "https:\/\/www.joturl.com\/?p=0",
      "template_type": 1
    },
    {
      "id": "c9f0c03a472f86a9ffde5cb0626aa49e",
      "alias": "alias1",
      "domain_id": "9bc441b1e1ae2d9b5a5a131b4f46dfa1",
      "domain_host": "my.custom.domain",
      "domain_nickname": "",
      "project_id": "68ccd36f91f784fbe3623b4a842401fb",
      "project_name": "project name",
      "short_url": "\/\/my.custom.domain\/alias1",
      "long_url": "https:\/\/www.joturl.com\/?p=1",
      "template_type": 1
    },
    {
      "error": "FAILED at 2",
      "details": "The chosen alias is not available. (alias1)"
    }
  ]
}

Example 10 (xml)

Request

https://joturl.com/a/i1/urls/shorten?domain_id=304a8342debc829d03880aa8a83578c0&project_id=048d91c5e3cf84a0b492f6963d48afc6&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D&format=xml

Query parameters

 domain_id = 304a8342debc829d03880aa8a83578c0
project_id = 048d91c5e3cf84a0b492f6963d48afc6
      bulk = 1
      info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <i0>
      <id>9cc47fac5f8a0bc1f3c2e9d1f2e40c9e</id>  
      <alias>alias0</alias>  
      <domain_id>7548cc2de5c89a8cd34ca614e0f7cfbb</domain_id>  
      <domain_host>my.custom.domain</domain_host>  
      <domain_nickname></domain_nickname>  
      <project_id>480c2aaa7c6b38fa7b03963614ebb5b4</project_id>  
      <project_name>project name</project_name>  
      <short_url>//my.custom.domain/alias0</short_url>  
      <long_url>https://www.joturl.com/?p=0</long_url>  
      <template_type>1</template_type>  
    </i0>  
    <i1>
      <id>c9f0c03a472f86a9ffde5cb0626aa49e</id>  
      <alias>alias1</alias>  
      <domain_id>9bc441b1e1ae2d9b5a5a131b4f46dfa1</domain_id>  
      <domain_host>my.custom.domain</domain_host>  
      <domain_nickname></domain_nickname>  
      <project_id>68ccd36f91f784fbe3623b4a842401fb</project_id>  
      <project_name>project name</project_name>  
      <short_url>//my.custom.domain/alias1</short_url>  
      <long_url>https://www.joturl.com/?p=1</long_url>  
      <template_type>1</template_type>  
    </i1>  
    <i2>
      <error>FAILED at 2</error>  
      <details>The chosen alias is not available. (alias1)</details>  
    </i2>  
  </result>  
</response>

Example 11 (txt)

Request

https://joturl.com/a/i1/urls/shorten?domain_id=304a8342debc829d03880aa8a83578c0&project_id=048d91c5e3cf84a0b492f6963d48afc6&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D&format=txt

Query parameters

 domain_id = 304a8342debc829d03880aa8a83578c0
project_id = 048d91c5e3cf84a0b492f6963d48afc6
      bulk = 1
      info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=9cc47fac5f8a0bc1f3c2e9d1f2e40c9e
result_0_alias=alias0
result_0_domain_id=7548cc2de5c89a8cd34ca614e0f7cfbb
result_0_domain_host=my.custom.domain
result_0_domain_nickname=
result_0_project_id=480c2aaa7c6b38fa7b03963614ebb5b4
result_0_project_name=project name
result_0_short_url=//my.custom.domain/alias0
result_0_long_url=https://www.joturl.com/?p=0
result_0_template_type=1
result_1_id=c9f0c03a472f86a9ffde5cb0626aa49e
result_1_alias=alias1
result_1_domain_id=9bc441b1e1ae2d9b5a5a131b4f46dfa1
result_1_domain_host=my.custom.domain
result_1_domain_nickname=
result_1_project_id=68ccd36f91f784fbe3623b4a842401fb
result_1_project_name=project name
result_1_short_url=//my.custom.domain/alias1
result_1_long_url=https://www.joturl.com/?p=1
result_1_template_type=1
result_2_error=FAILED at 2
result_2_details=The chosen alias is not available. (alias1)

Example 12 (plain)

Request

https://joturl.com/a/i1/urls/shorten?domain_id=304a8342debc829d03880aa8a83578c0&project_id=048d91c5e3cf84a0b492f6963d48afc6&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D&format=plain

Query parameters

 domain_id = 304a8342debc829d03880aa8a83578c0
project_id = 048d91c5e3cf84a0b492f6963d48afc6
      bulk = 1
      info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
    format = plain

Response

//my.custom.domain/alias0
//my.custom.domain/alias1
FAILED at 2
The chosen alias is not available. (alias1)

Optional parameters

parameter	description	max length
aliasSTRING	available only when `bulk = 0` - alias for the tracking link, if not specified a random and unique alias will be generated. The alias must be at least 3 characters among lower-case letters a-z, numbers 0-9, minus -, underscore _	510
bulkBOOLEAN	1 to enable "bulk shorten" mode (default: 0)
domain_idID	ID of the domain for the tracking link(s), if not specified the default domain for the user will be used
embed_codeHTML	embed code for the JotBars
infoJSON	required when `bulk = 1` - information for creating tracking links, is a JSON like this `[{"url": "destination URL 1", "alias": "alias 1"}, ...]`, a maximum of 100 elements are allowed
long_urlSTRING	required when `bulk = 0` - destination URL for the tracking link	4000
notesSTRING	notes for the tracking link	255
project_idID	ID of the project where the tracking link(s) will be put in, if not specified the default project is used
tagsARRAY_STRING	comma-separated list of tags for the tracking link
video_durationSTRING	if the embed code contains a video, this parameter can be used to specify the video duration

Return values

parameter	description
alias	alias for the tracking link
domain_host	domain used to create the tracking link
domain_id	ID of the domain used to create the tracking link
domain_nickname	nickname of the short url domain
id	ID of the created tracking link
long_url	destination URL for the tracking link
notes	only returned when `bulk = 0` - notes for the tracking link
project_id	ID of the project where the tracking link was created
project_name	name of the project where the tracking link was created
short_url	short URL for the tracking link
tags	only returned when `bulk = 0` - space-separated list of tags associated to the tracking link

/urls/suggest

access: [READ]

Given a domain, suggests a specific number of aliases.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=2c29c6c71aeaea40857f9a1369ea43fd

Query parameters

number_alias = 3
   domain_id = 2c29c6c71aeaea40857f9a1369ea43fd

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      "a072",
      "6f6d204",
      "5d70"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=2c29c6c71aeaea40857f9a1369ea43fd&format=xml

Query parameters

number_alias = 3
   domain_id = 2c29c6c71aeaea40857f9a1369ea43fd
      format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>a072</i0>  
      <i1>6f6d204</i1>  
      <i2>5d70</i2>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=2c29c6c71aeaea40857f9a1369ea43fd&format=txt

Query parameters

number_alias = 3
   domain_id = 2c29c6c71aeaea40857f9a1369ea43fd
      format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0=a072
result_data_1=6f6d204
result_data_2=5d70

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=2c29c6c71aeaea40857f9a1369ea43fd&format=plain

Query parameters

number_alias = 3
   domain_id = 2c29c6c71aeaea40857f9a1369ea43fd
      format = plain

Response

a072
6f6d204
5d70

Required parameters

parameter	description
domain_idID	ID of the domain where to suggest a new and unique alias

Optional parameters

parameter	description	max length
aliasSTRING	base for the alias to suggest	510
number_aliasINTEGER	number of aliases to suggest, default 1, maximum 3

Return values

parameter	description
data	suggested unique aliases

/urls/tags

/urls/tags/add

access: [WRITE]

Add a list of tags to a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/tags/add?url_id=6f2d7625e37fcc938164ccba7a237001&tags=test,tag,api

Query parameters

url_id = 6f2d7625e37fcc938164ccba7a237001
  tags = test,tag,api

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "added": 3
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/tags/add?url_id=6f2d7625e37fcc938164ccba7a237001&tags=test,tag,api&format=xml

Query parameters

url_id = 6f2d7625e37fcc938164ccba7a237001
  tags = test,tag,api
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <added>3</added>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/tags/add?url_id=6f2d7625e37fcc938164ccba7a237001&tags=test,tag,api&format=txt

Query parameters

url_id = 6f2d7625e37fcc938164ccba7a237001
  tags = test,tag,api
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_added=3

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/tags/add?url_id=6f2d7625e37fcc938164ccba7a237001&tags=test,tag,api&format=plain

Query parameters

url_id = 6f2d7625e37fcc938164ccba7a237001
  tags = test,tag,api
format = plain

Response

Required parameters

parameter	description
tagsARRAY_STRING	comma-separated list of tags, these tags will be added to the previous tags
url_idID	ID of the tracking link

Return values

parameter	description
added	numner of added tags, it could be 0 if all passed tags are already associated with the tracking link

/urls/tags/clone

access: [WRITE]

Clone tags from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/tags/clone?from_url_id=127ee0c8d0e79b5283c74422cf4cf76a&to_url_id=ab6a6c3b6aa68b9253d50d4fd5a6e903

Query parameters

from_url_id = 127ee0c8d0e79b5283c74422cf4cf76a
  to_url_id = ab6a6c3b6aa68b9253d50d4fd5a6e903

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/tags/clone?from_url_id=127ee0c8d0e79b5283c74422cf4cf76a&to_url_id=ab6a6c3b6aa68b9253d50d4fd5a6e903&format=xml

Query parameters

from_url_id = 127ee0c8d0e79b5283c74422cf4cf76a
  to_url_id = ab6a6c3b6aa68b9253d50d4fd5a6e903
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/tags/clone?from_url_id=127ee0c8d0e79b5283c74422cf4cf76a&to_url_id=ab6a6c3b6aa68b9253d50d4fd5a6e903&format=txt

Query parameters

from_url_id = 127ee0c8d0e79b5283c74422cf4cf76a
  to_url_id = ab6a6c3b6aa68b9253d50d4fd5a6e903
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/tags/clone?from_url_id=127ee0c8d0e79b5283c74422cf4cf76a&to_url_id=ab6a6c3b6aa68b9253d50d4fd5a6e903&format=plain

Query parameters

from_url_id = 127ee0c8d0e79b5283c74422cf4cf76a
  to_url_id = ab6a6c3b6aa68b9253d50d4fd5a6e903
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy tags from
to_url_idID	ID of the tracking link you want to copy tags to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/tags/count

access: [READ]

This method returns the number of tags.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/tags/count?url_id=7633b6f4adb06c5c268be358c8efd511

Query parameters

url_id = 7633b6f4adb06c5c268be358c8efd511

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/tags/count?url_id=7633b6f4adb06c5c268be358c8efd511&format=xml

Query parameters

url_id = 7633b6f4adb06c5c268be358c8efd511
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/tags/count?url_id=7633b6f4adb06c5c268be358c8efd511&format=txt

Query parameters

url_id = 7633b6f4adb06c5c268be358c8efd511
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/tags/count?url_id=7633b6f4adb06c5c268be358c8efd511&format=plain

Query parameters

url_id = 7633b6f4adb06c5c268be358c8efd511
format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters tags to be extracted by searching them
url_idID	ID of the tracking link from which to extract the tags

Return values

parameter	description
count	number of (filtered) tags

/urls/tags/delete

access: [WRITE]

This method deletes the relationship between a tag and an url. If the tag has no reference with others url, the tag will be deleted. Return 1 if the operation succeeds or 0 otherwise.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/tags/delete?url_id=36b7ad626c9a4a9f8459b68178e42679&tag=tag

Query parameters

url_id = 36b7ad626c9a4a9f8459b68178e42679
   tag = tag

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/tags/delete?url_id=36b7ad626c9a4a9f8459b68178e42679&tag=tag&format=xml

Query parameters

url_id = 36b7ad626c9a4a9f8459b68178e42679
   tag = tag
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/tags/delete?url_id=36b7ad626c9a4a9f8459b68178e42679&tag=tag&format=txt

Query parameters

url_id = 36b7ad626c9a4a9f8459b68178e42679
   tag = tag
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/tags/delete?url_id=36b7ad626c9a4a9f8459b68178e42679&tag=tag&format=plain

Query parameters

url_id = 36b7ad626c9a4a9f8459b68178e42679
   tag = tag
format = plain

Response

Required parameters

parameter	description
tagSTRING	tag to remove
url_idID	ID of the tracking link from which to remove a tag

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/tags/edit

access: [WRITE]

Edit tags for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/tags/edit?url_id=43b2bd734f408e7e30378fff1e4bc342&tags=test,tag,api

Query parameters

url_id = 43b2bd734f408e7e30378fff1e4bc342
  tags = test,tag,api

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "edited": 3,
    "url_id": "43b2bd734f408e7e30378fff1e4bc342",
    "tags": "test,tag,api"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/tags/edit?url_id=43b2bd734f408e7e30378fff1e4bc342&tags=test,tag,api&format=xml

Query parameters

url_id = 43b2bd734f408e7e30378fff1e4bc342
  tags = test,tag,api
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <edited>3</edited>  
    <url_id>43b2bd734f408e7e30378fff1e4bc342</url_id>  
    <tags>test,tag,api</tags>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/tags/edit?url_id=43b2bd734f408e7e30378fff1e4bc342&tags=test,tag,api&format=txt

Query parameters

url_id = 43b2bd734f408e7e30378fff1e4bc342
  tags = test,tag,api
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_edited=3
result_url_id=43b2bd734f408e7e30378fff1e4bc342
result_tags=test,tag,api

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/tags/edit?url_id=43b2bd734f408e7e30378fff1e4bc342&tags=test,tag,api&format=plain

Query parameters

url_id = 43b2bd734f408e7e30378fff1e4bc342
  tags = test,tag,api
format = plain

Response

3
43b2bd734f408e7e30378fff1e4bc342
test,tag,api

Required parameters

parameter	description
url_idID	ID of the tracking link

Optional parameters

parameter	description
tagsARRAY_STRING	comma-separated list of tags, this list will completely replace previous tags (if empty all tags are removed)

Return values

parameter	description
added	number of added tags
deleted	number of deleted tags
edited	number of operations (add+delete) on tags
tags	comma-separated list of tags
url_id	echo back of parameter url_id

/urls/tags/list

access: [READ]

This method returns a list of tags related to an url, the data returned are specified in a comma separated input called fields.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/tags/list?url_id=04d4361f88de7cececdeb2c653536f9e

Query parameters

url_id = 04d4361f88de7cececdeb2c653536f9e

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2,
    "data": [
      {
        "tag": "tag1"
      },
      {
        "tag": "tag2"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/tags/list?url_id=04d4361f88de7cececdeb2c653536f9e&format=xml

Query parameters

url_id = 04d4361f88de7cececdeb2c653536f9e
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
    <data>
      <i0>
        <tag>tag1</tag>  
      </i0>  
      <i1>
        <tag>tag2</tag>  
      </i1>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/tags/list?url_id=04d4361f88de7cececdeb2c653536f9e&format=txt

Query parameters

url_id = 04d4361f88de7cececdeb2c653536f9e
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_tag=tag1
result_data_1_tag=tag2

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/tags/list?url_id=04d4361f88de7cececdeb2c653536f9e&format=plain

Query parameters

url_id = 04d4361f88de7cececdeb2c653536f9e
format = plain

Response

2
tag1
tag2

Optional parameters

parameter	description
lengthINTEGER	extracts this number of tags (maxmimum allowed: 100)
searchSTRING	filters tags to be extracted by searching them
startINTEGER	starts to extract tags from this position
url_idID	ID of the tracking link from which to extract the tags

Return values

parameter	description
data	array containing information on tags, returned information depends on the fields parameter.

/urls/timing

/urls/timing/clone

access: [WRITE]

Clone a timing configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/timing/clone?from_url_id=767c41863aa8f9d888e2384b714d202c&to_url_id=eb5c33f42e4aaf4eb40bd09d1dc9df13

Query parameters

from_url_id = 767c41863aa8f9d888e2384b714d202c
  to_url_id = eb5c33f42e4aaf4eb40bd09d1dc9df13

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/timing/clone?from_url_id=767c41863aa8f9d888e2384b714d202c&to_url_id=eb5c33f42e4aaf4eb40bd09d1dc9df13&format=xml

Query parameters

from_url_id = 767c41863aa8f9d888e2384b714d202c
  to_url_id = eb5c33f42e4aaf4eb40bd09d1dc9df13
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>0</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/timing/clone?from_url_id=767c41863aa8f9d888e2384b714d202c&to_url_id=eb5c33f42e4aaf4eb40bd09d1dc9df13&format=txt

Query parameters

from_url_id = 767c41863aa8f9d888e2384b714d202c
  to_url_id = eb5c33f42e4aaf4eb40bd09d1dc9df13
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/timing/clone?from_url_id=767c41863aa8f9d888e2384b714d202c&to_url_id=eb5c33f42e4aaf4eb40bd09d1dc9df13&format=plain

Query parameters

from_url_id = 767c41863aa8f9d888e2384b714d202c
  to_url_id = eb5c33f42e4aaf4eb40bd09d1dc9df13
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy timing configuration from
to_url_idID	ID of the tracking link you want to copy timing configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/timing/delete

access: [WRITE]

Delete the timing configuration of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/timing/delete?id=184feadf677992c89af6bd8a8d0b0543

Query parameters

id = 184feadf677992c89af6bd8a8d0b0543

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/timing/delete?id=184feadf677992c89af6bd8a8d0b0543&format=xml

Query parameters

    id = 184feadf677992c89af6bd8a8d0b0543
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/timing/delete?id=184feadf677992c89af6bd8a8d0b0543&format=txt

Query parameters

    id = 184feadf677992c89af6bd8a8d0b0543
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/timing/delete?id=184feadf677992c89af6bd8a8d0b0543&format=plain

Query parameters

    id = 184feadf677992c89af6bd8a8d0b0543
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a timing configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/timing/edit

access: [WRITE]

Given a short URL, defines a validity time range. It is possible to define the start datetime, the expire datetime and the URL to be used after expiration. This method is available only to certain user profiles.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/timing/edit?id=011e8508553d34184ae156f61699d63a&valid_from=2026-04-26+14%3A00%3A32&valid_to=2027-05-26+14%3A00%3A32&valid_after_url=&delete_after_expiration=1

Query parameters

                     id = 011e8508553d34184ae156f61699d63a
             valid_from = 2026-04-26 14:00:32
               valid_to = 2027-05-26 14:00:32
        valid_after_url = 
delete_after_expiration = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "valid_from": "2026-04-26 14:00:32",
    "valid_to": "2027-05-26 14:00:32",
    "valid_after_url": "",
    "delete_after_expiration": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/timing/edit?id=011e8508553d34184ae156f61699d63a&valid_from=2026-04-26+14%3A00%3A32&valid_to=2027-05-26+14%3A00%3A32&valid_after_url=&delete_after_expiration=1&format=xml

Query parameters

                     id = 011e8508553d34184ae156f61699d63a
             valid_from = 2026-04-26 14:00:32
               valid_to = 2027-05-26 14:00:32
        valid_after_url = 
delete_after_expiration = 1
                 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <valid_from>2026-04-26 14:00:32</valid_from>  
    <valid_to>2027-05-26 14:00:32</valid_to>  
    <valid_after_url></valid_after_url>  
    <delete_after_expiration>1</delete_after_expiration>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/timing/edit?id=011e8508553d34184ae156f61699d63a&valid_from=2026-04-26+14%3A00%3A32&valid_to=2027-05-26+14%3A00%3A32&valid_after_url=&delete_after_expiration=1&format=txt

Query parameters

                     id = 011e8508553d34184ae156f61699d63a
             valid_from = 2026-04-26 14:00:32
               valid_to = 2027-05-26 14:00:32
        valid_after_url = 
delete_after_expiration = 1
                 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_valid_from=2026-04-26 14:00:32
result_valid_to=2027-05-26 14:00:32
result_valid_after_url=
result_delete_after_expiration=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/timing/edit?id=011e8508553d34184ae156f61699d63a&valid_from=2026-04-26+14%3A00%3A32&valid_to=2027-05-26+14%3A00%3A32&valid_after_url=&delete_after_expiration=1&format=plain

Query parameters

                     id = 011e8508553d34184ae156f61699d63a
             valid_from = 2026-04-26 14:00:32
               valid_to = 2027-05-26 14:00:32
        valid_after_url = 
delete_after_expiration = 1
                 format = plain

Response

2026-04-26 14:00:32
2027-05-26 14:00:32

1

Required parameters

parameter	description
idID	ID of the tracking link

Optional parameters

parameter	description	max length
delete_after_expirationBOOLEAN	1 to delete the tracking link after valid_to
valid_after_urlURL	URL to be used after valid_to	4000
valid_fromSTRING	the tracking link is valid from this date/time, before this date/time our engine returns a 404 error if someone tries to navigate to this tracking link; if empty or `null` it means "valid from now"
valid_toSTRING	the tracking link is valid until this date/time, after this date/time our engine returns a 404 error if `delete_after_expiration = 1` otherwise redirects to valid_after_url; if empty or `null` it means "valid forever"

Return values

parameter	description
delete_after_expiration	NA
valid_after_url	NA
valid_from	NA
valid_to	NA

/urls/timing/info

access: [READ]

Returns information on the validity range of a given short URL. This method is available only to certain user profiles.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/timing/info?id=e6394d94dc968aea7cd62af6d5384a08

Query parameters

id = e6394d94dc968aea7cd62af6d5384a08

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "valid_from": "2026-04-26 14:00:32",
    "valid_to": "2027-05-26 14:00:32",
    "valid_after_url": "",
    "delete_after_expiration": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/timing/info?id=e6394d94dc968aea7cd62af6d5384a08&format=xml

Query parameters

    id = e6394d94dc968aea7cd62af6d5384a08
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <valid_from>2026-04-26 14:00:32</valid_from>  
    <valid_to>2027-05-26 14:00:32</valid_to>  
    <valid_after_url></valid_after_url>  
    <delete_after_expiration>1</delete_after_expiration>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/timing/info?id=e6394d94dc968aea7cd62af6d5384a08&format=txt

Query parameters

    id = e6394d94dc968aea7cd62af6d5384a08
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_valid_from=2026-04-26 14:00:32
result_valid_to=2027-05-26 14:00:32
result_valid_after_url=
result_delete_after_expiration=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/timing/info?id=e6394d94dc968aea7cd62af6d5384a08&format=plain

Query parameters

    id = e6394d94dc968aea7cd62af6d5384a08
format = plain

Response

2026-04-26 14:00:32
2027-05-26 14:00:32

1

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
delete_after_expiration	1 to delete the tracking link after valid_to
valid_after_url	URL to be used after valid_to
valid_from	the tracking link is valid from this date/time, before this date/time our engine returns a 404 error if someone tries to navigate to this tracking link; if empty or `null` it means "valid from now"
valid_to	the tracking link is valid until this date/time, after this date/time our engine returns a 404 error if `delete_after_expiration = 1` otherwise redirects to valid_after_url; if empty or `null` it means "valid forever"

/urls/vcards

/urls/vcards/property

access: [READ]

Returns limits for vCards.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/vcards/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "max_vcard_size": 70000,
    "max_vcard_image_size": 30000,
    "supported_fields": {
      "name": [
        "namePrefix",
        "firstName",
        "middleName",
        "lastName",
        "nameSuffix"
      ],
      "work": [
        "title",
        "role",
        "organization",
        "department",
        "workURL"
      ],
      "emails": [
        "email",
        "workEmail"
      ],
      "phones": [
        "homePhone",
        "workPhone",
        "cellPhone",
        "pagerPhone",
        "homeFax",
        "workFax"
      ],
      "homeAdd": [
        "homeAddLabel",
        "homeAddStreet",
        "homeAddCity",
        "homeAddState",
        "homeAddPostalCode",
        "homeAddCountry"
      ],
      "workAdd": [
        "workAddLabel",
        "workAddStreet",
        "workAddCity",
        "workAddState",
        "workAddPostalCode",
        "workAddCountry"
      ],
      "personal": [
        "birthdayDay",
        "birthdayMonth",
        "birthdayYear",
        "anniversaryDay",
        "anniversaryMonth",
        "anniversaryYear",
        "personalURL",
        "gender"
      ],
      "images": [
        "photo",
        "embed_photo",
        "embedded_photo",
        "logo",
        "embed_logo",
        "embedded_logo"
      ],
      "socials": [
        "linkedin",
        "twitter",
        "facebook",
        "instagram",
        "youtube",
        "tiktok"
      ],
      "other": [
        "note",
        "uid"
      ]
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/vcards/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <max_vcard_size>70000</max_vcard_size>  
    <max_vcard_image_size>30000</max_vcard_image_size>  
    <supported_fields>
      <name>
        <i0>namePrefix</i0>  
        <i1>firstName</i1>  
        <i2>middleName</i2>  
        <i3>lastName</i3>  
        <i4>nameSuffix</i4>  
      </name>  
      <work>
        <i0>title</i0>  
        <i1>role</i1>  
        <i2>organization</i2>  
        <i3>department</i3>  
        <i4>workURL</i4>  
      </work>  
      <emails>
        <i0>email</i0>  
        <i1>workEmail</i1>  
      </emails>  
      <phones>
        <i0>homePhone</i0>  
        <i1>workPhone</i1>  
        <i2>cellPhone</i2>  
        <i3>pagerPhone</i3>  
        <i4>homeFax</i4>  
        <i5>workFax</i5>  
      </phones>  
      <homeAdd>
        <i0>homeAddLabel</i0>  
        <i1>homeAddStreet</i1>  
        <i2>homeAddCity</i2>  
        <i3>homeAddState</i3>  
        <i4>homeAddPostalCode</i4>  
        <i5>homeAddCountry</i5>  
      </homeAdd>  
      <workAdd>
        <i0>workAddLabel</i0>  
        <i1>workAddStreet</i1>  
        <i2>workAddCity</i2>  
        <i3>workAddState</i3>  
        <i4>workAddPostalCode</i4>  
        <i5>workAddCountry</i5>  
      </workAdd>  
      <personal>
        <i0>birthdayDay</i0>  
        <i1>birthdayMonth</i1>  
        <i2>birthdayYear</i2>  
        <i3>anniversaryDay</i3>  
        <i4>anniversaryMonth</i4>  
        <i5>anniversaryYear</i5>  
        <i6>personalURL</i6>  
        <i7>gender</i7>  
      </personal>  
      <images>
        <i0>photo</i0>  
        <i1>embed_photo</i1>  
        <i2>embedded_photo</i2>  
        <i3>logo</i3>  
        <i4>embed_logo</i4>  
        <i5>embedded_logo</i5>  
      </images>  
      <socials>
        <i0>linkedin</i0>  
        <i1>twitter</i1>  
        <i2>facebook</i2>  
        <i3>instagram</i3>  
        <i4>youtube</i4>  
        <i5>tiktok</i5>  
      </socials>  
      <other>
        <i0>note</i0>  
        <i1>uid</i1>  
      </other>  
    </supported_fields>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/vcards/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_max_vcard_size=70000
result_max_vcard_image_size=30000
result_supported_fields_name_0=namePrefix
result_supported_fields_name_1=firstName
result_supported_fields_name_2=middleName
result_supported_fields_name_3=lastName
result_supported_fields_name_4=nameSuffix
result_supported_fields_work_0=title
result_supported_fields_work_1=role
result_supported_fields_work_2=organization
result_supported_fields_work_3=department
result_supported_fields_work_4=workURL
result_supported_fields_emails_0=email
result_supported_fields_emails_1=workEmail
result_supported_fields_phones_0=homePhone
result_supported_fields_phones_1=workPhone
result_supported_fields_phones_2=cellPhone
result_supported_fields_phones_3=pagerPhone
result_supported_fields_phones_4=homeFax
result_supported_fields_phones_5=workFax
result_supported_fields_homeAdd_0=homeAddLabel
result_supported_fields_homeAdd_1=homeAddStreet
result_supported_fields_homeAdd_2=homeAddCity
result_supported_fields_homeAdd_3=homeAddState
result_supported_fields_homeAdd_4=homeAddPostalCode
result_supported_fields_homeAdd_5=homeAddCountry
result_supported_fields_workAdd_0=workAddLabel
result_supported_fields_workAdd_1=workAddStreet
result_supported_fields_workAdd_2=workAddCity
result_supported_fields_workAdd_3=workAddState
result_supported_fields_workAdd_4=workAddPostalCode
result_supported_fields_workAdd_5=workAddCountry
result_supported_fields_personal_0=birthdayDay
result_supported_fields_personal_1=birthdayMonth
result_supported_fields_personal_2=birthdayYear
result_supported_fields_personal_3=anniversaryDay
result_supported_fields_personal_4=anniversaryMonth
result_supported_fields_personal_5=anniversaryYear
result_supported_fields_personal_6=personalURL
result_supported_fields_personal_7=gender
result_supported_fields_images_0=photo
result_supported_fields_images_1=embed_photo
result_supported_fields_images_2=embedded_photo
result_supported_fields_images_3=logo
result_supported_fields_images_4=embed_logo
result_supported_fields_images_5=embedded_logo
result_supported_fields_socials_0=linkedin
result_supported_fields_socials_1=twitter
result_supported_fields_socials_2=facebook
result_supported_fields_socials_3=instagram
result_supported_fields_socials_4=youtube
result_supported_fields_socials_5=tiktok
result_supported_fields_other_0=note
result_supported_fields_other_1=uid

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/vcards/property?format=plain

Query parameters

format = plain

Response

70000
30000
namePrefix
firstName
middleName
lastName
nameSuffix
title
role
organization
department
workURL
email
workEmail
homePhone
workPhone
cellPhone
pagerPhone
homeFax
workFax
homeAddLabel
homeAddStreet
homeAddCity
homeAddState
homeAddPostalCode
homeAddCountry
workAddLabel
workAddStreet
workAddCity
workAddState
workAddPostalCode
workAddCountry
birthdayDay
birthdayMonth
birthdayYear
anniversaryDay
anniversaryMonth
anniversaryYear
personalURL
gender
photo
embed_photo
embedded_photo
logo
embed_logo
embedded_logo
linkedin
twitter
facebook
instagram
youtube
tiktok
note
uid

Return values

parameter	description
max_vcard_image_size	maximum number of bytes allowed in vCard images
max_vcard_size	maximum number of bytes allowed in the vCard
supported_fields	list of fields supported in the vCard divided by groups

/urls/watchdogs

/urls/watchdogs/alerts

/urls/watchdogs/alerts/delete

access: [WRITE]

Reset watchdog's alerts for a given array of URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918

Query parameters

count = 3
  ids = 17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 3,
    "ids": "17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918&format=xml

Query parameters

 count = 3
   ids = 17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>3</count>  
    <ids>17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918</ids>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918&format=txt

Query parameters

 count = 3
   ids = 17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
result_ids=17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918&format=plain

Query parameters

 count = 3
   ids = 17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918
format = plain

Response

3
17779fd1392ff6ce253dfa2d6735faa5,6684d59e889aa40fd43e8f874fffa571,c223cf095ecd5a5ea326b513d2953918

Required parameters

parameter	description
idsARRAY_OF_IDS	comma-separated list of ID of the tracking links from which to reset watchdog's alerts

Return values

parameter	description
count	number of deleted alerts
ids	echo back of the ids imput parameters

/urls/watchdogs/alerts/info

access: [READ]

Returns watchdog's alerts for a given short URL.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=03c2e7d3856882157900ca942e840f65

Query parameters

id = 03c2e7d3856882157900ca942e840f65

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": {
      "alerts": [
        {
          "message": "URL redirects to .",
          "occurrencies": 56,
          "date": {
            "from": "2026-05-14 14:00:32",
            "to": "2026-05-26 14:00:32"
          }
        }
      ],
      "browsers": {
        "mobile": [
          {
            "BrowserName": "Openwave Mobile Browser 6.2.3.3.c.1.101",
            "Platform": "Unix sun",
            "MobileDevice": "Samsung"
          },
          "[...]",
          {
            "BrowserName": "DoCoMo 3.0",
            "Platform": "--",
            "MobileDevice": "--"
          }
        ],
        "desktop": [
          {
            "BrowserName": "Google AdSense",
            "Platform": "--"
          },
          "[...]",
          {
            "BrowserName": "Shiretoko Firefox 3.5",
            "Platform": "Linux"
          }
        ]
      },
      "long_url": "https:\/\/www.example.com\/product\/124141255",
      "last_update": "2026-05-03 14:00:32"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=03c2e7d3856882157900ca942e840f65&format=xml

Query parameters

    id = 03c2e7d3856882157900ca942e840f65
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <alerts>
        <i0>
          <message>URL redirects to .</message>  
          <occurrencies>56</occurrencies>  
          <date>
            <from>2026-05-14 14:00:32</from>  
            <to>2026-05-26 14:00:32</to>  
          </date>  
        </i0>  
      </alerts>  
      <browsers>
        <mobile>
          <i0>
            <BrowserName>Openwave Mobile Browser 6.2.3.3.c.1.101</BrowserName>  
            <Platform>Unix sun</Platform>  
            <MobileDevice>Samsung</MobileDevice>  
          </i0>  
          <i1>[...]</i1>  
          <i2>
            <BrowserName>DoCoMo 3.0</BrowserName>  
            <Platform>--</Platform>  
            <MobileDevice>--</MobileDevice>  
          </i2>  
        </mobile>  
        <desktop>
          <i0>
            <BrowserName>Google AdSense</BrowserName>  
            <Platform>--</Platform>  
          </i0>  
          <i1>[...]</i1>  
          <i2>
            <BrowserName>Shiretoko Firefox 3.5</BrowserName>  
            <Platform>Linux</Platform>  
          </i2>  
        </desktop>  
      </browsers>  
      <long_url>https://www.example.com/product/124141255</long_url>  
      <last_update>2026-05-03 14:00:32</last_update>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=03c2e7d3856882157900ca942e840f65&format=txt

Query parameters

    id = 03c2e7d3856882157900ca942e840f65
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_alerts_0_message=URL redirects to .
result_data_alerts_0_occurrencies=56
result_data_alerts_0_date_from=2026-05-14 14:00:32
result_data_alerts_0_date_to=2026-05-26 14:00:32
result_data_browsers_mobile_0_BrowserName=Openwave Mobile Browser 6.2.3.3.c.1.101
result_data_browsers_mobile_0_Platform=Unix sun
result_data_browsers_mobile_0_MobileDevice=Samsung
result_data_browsers_mobile_1=[...]
result_data_browsers_mobile_2_BrowserName=DoCoMo 3.0
result_data_browsers_mobile_2_Platform=--
result_data_browsers_mobile_2_MobileDevice=--
result_data_browsers_desktop_0_BrowserName=Google AdSense
result_data_browsers_desktop_0_Platform=--
result_data_browsers_desktop_1=[...]
result_data_browsers_desktop_2_BrowserName=Shiretoko Firefox 3.5
result_data_browsers_desktop_2_Platform=Linux
result_data_long_url=https://www.example.com/product/124141255
result_data_last_update=2026-05-03 14:00:32

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=03c2e7d3856882157900ca942e840f65&format=plain

Query parameters

    id = 03c2e7d3856882157900ca942e840f65
format = plain

Response

URL redirects to .
56
2026-05-14 14:00:32
2026-05-26 14:00:32
Openwave Mobile Browser 6.2.3.3.c.1.101
Unix sun
Samsung
[...]
DoCoMo 3.0
--
--
Google AdSense
--
[...]
Shiretoko Firefox 3.5
Linux
https://www.example.com/product/124141255
2026-05-03 14:00:32

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
data	array containing information for the alerts

/urls/whatsapps

/urls/whatsapps/clone

access: [WRITE]

Clone the whatsapps configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=395a51e23e8dbc71b7bf4e9ff8e28eb2&to_url_id=9a4c8dd11f5f710c21badf8de99285d9

Query parameters

from_url_id = 395a51e23e8dbc71b7bf4e9ff8e28eb2
  to_url_id = 9a4c8dd11f5f710c21badf8de99285d9

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=395a51e23e8dbc71b7bf4e9ff8e28eb2&to_url_id=9a4c8dd11f5f710c21badf8de99285d9&format=xml

Query parameters

from_url_id = 395a51e23e8dbc71b7bf4e9ff8e28eb2
  to_url_id = 9a4c8dd11f5f710c21badf8de99285d9
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=395a51e23e8dbc71b7bf4e9ff8e28eb2&to_url_id=9a4c8dd11f5f710c21badf8de99285d9&format=txt

Query parameters

from_url_id = 395a51e23e8dbc71b7bf4e9ff8e28eb2
  to_url_id = 9a4c8dd11f5f710c21badf8de99285d9
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=395a51e23e8dbc71b7bf4e9ff8e28eb2&to_url_id=9a4c8dd11f5f710c21badf8de99285d9&format=plain

Query parameters

from_url_id = 395a51e23e8dbc71b7bf4e9ff8e28eb2
  to_url_id = 9a4c8dd11f5f710c21badf8de99285d9
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy the whatsapps configuration from
to_url_idID	ID of the tracking link you want to the whatsapps configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/urls/whatsapps/delete

access: [WRITE]

Delete a WhatsUrl configuration for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/whatsapps/delete?url_id=df810010d6759da2c36513d7c8940807

Query parameters

url_id = df810010d6759da2c36513d7c8940807

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/whatsapps/delete?url_id=df810010d6759da2c36513d7c8940807&format=xml

Query parameters

url_id = df810010d6759da2c36513d7c8940807
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/whatsapps/delete?url_id=df810010d6759da2c36513d7c8940807&format=txt

Query parameters

url_id = df810010d6759da2c36513d7c8940807
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/whatsapps/delete?url_id=df810010d6759da2c36513d7c8940807&format=plain

Query parameters

url_id = df810010d6759da2c36513d7c8940807
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link from which to remove a WhatsUrl configuration

Return values

parameter	description
deleted	1 on success, 0 otherwise

/urls/whatsapps/edit

access: [WRITE]

Set WhatsApp settings for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/whatsapps/edit?id=921c85fc22f3852a93e07801ccca4b31&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D

Query parameters

      id = 921c85fc22f3852a93e07801ccca4b31
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/whatsapps/edit?id=921c85fc22f3852a93e07801ccca4b31&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D&format=xml

Query parameters

      id = 921c85fc22f3852a93e07801ccca4b31
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/whatsapps/edit?id=921c85fc22f3852a93e07801ccca4b31&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D&format=txt

Query parameters

      id = 921c85fc22f3852a93e07801ccca4b31
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/whatsapps/edit?id=921c85fc22f3852a93e07801ccca4b31&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D&format=plain

Query parameters

      id = 921c85fc22f3852a93e07801ccca4b31
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
  format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link
settingsJSON	stringified JSON containing the Whatsapp settings

Return values

parameter	description
enabled	1 on success, 0 otherwise

/urls/whatsapps/info

access: [READ]

Get settings for the WhatsApp option.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/urls/whatsapps/info?id=c0f6d102ca5e01b8b38057b70e17e71b

Query parameters

id = c0f6d102ca5e01b8b38057b70e17e71b

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "compatible": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/urls/whatsapps/info?id=c0f6d102ca5e01b8b38057b70e17e71b&format=xml

Query parameters

    id = c0f6d102ca5e01b8b38057b70e17e71b
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <compatible>0</compatible>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/urls/whatsapps/info?id=c0f6d102ca5e01b8b38057b70e17e71b&format=txt

Query parameters

    id = c0f6d102ca5e01b8b38057b70e17e71b
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_compatible=0

Example 4 (plain)

Request

https://joturl.com/a/i1/urls/whatsapps/info?id=c0f6d102ca5e01b8b38057b70e17e71b&format=plain

Query parameters

    id = c0f6d102ca5e01b8b38057b70e17e71b
format = plain

Response

Required parameters

parameter	description
idID	ID of the tracking link

Return values

parameter	description
settings	array containing the settings for the WhatsApp option

/users

/users/2fa

/users/2fa/disable

access: [WRITE]

This method disable the 2-factor authentication for the logged in user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/2fa/disable?code=322384

Query parameters

code = 322384

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/2fa/disable?code=322384&format=xml

Query parameters

  code = 322384
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/2fa/disable?code=322384&format=txt

Query parameters

  code = 322384
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/2fa/disable?code=322384&format=plain

Query parameters

  code = 322384
format = plain

Response

Required parameters

parameter	description	max length
codeSTRING	security code given by the authenticator app or one of the backup codes	8

Return values

parameter	description
disabled	1 if the 2-factor authentication deactivation was successful, otherwise an error is returned

/users/2fa/enable

access: [WRITE]

This method enable the 2-factor authentication for the logged in user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/2fa/enable?code=322384

Query parameters

code = 322384

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/2fa/enable?code=322384&format=xml

Query parameters

  code = 322384
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/2fa/enable?code=322384&format=txt

Query parameters

  code = 322384
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/2fa/enable?code=322384&format=plain

Query parameters

  code = 322384
format = plain

Response

Required parameters

parameter	description	max length
codeSTRING	security code given by the authenticator app	6

Return values

parameter	description
enabled	1 if the 2-factor authentication activation was successful, otherwise an error is returned

/users/2fa/info

access: [READ]

This method returns info on the 2-factor authentication status of the logged in user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/2fa/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 0,
    "label": "JotUrl - my@email.address",
    "secret": "83e6793f3f491c8137b750b4d754d757",
    "uri": "otpauth:\/\/totp\/JotUrl+-+my%40email.address?secret=83e6793f3f491c8137b750b4d754d757"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/2fa/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>0</enabled>  
    <label>JotUrl - my@email.address</label>  
    <secret>83e6793f3f491c8137b750b4d754d757</secret>  
    <uri>otpauth://totp/JotUrl+-+my%40email.address?secret=83e6793f3f491c8137b750b4d754d757</uri>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/2fa/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=0
result_label=JotUrl - my@email.address
result_secret=83e6793f3f491c8137b750b4d754d757
result_uri=otpauth://totp/JotUrl+-+my%40email.address?secret=83e6793f3f491c8137b750b4d754d757

Example 4 (plain)

Request

https://joturl.com/a/i1/users/2fa/info?format=plain

Query parameters

format = plain

Response

0
JotUrl - my@email.address
83e6793f3f491c8137b750b4d754d757
otpauth://totp/JotUrl+-+my%40email.address?secret=83e6793f3f491c8137b750b4d754d757

Optional parameters

parameter	description	max length
codeSTRING	security code given by the authenticator app or one of the backup codes	8
statusBOOLEAN	1 to request only the status without generating/returning 2FA information (default: 0)

Return values

parameter	description
backup	[OPTIONAL] returned only if `enabled = 0` or if `code` is passed, backup codes for the 2-factor authentication
enabled	1 if the 2-factor authentication is enabled for the logged in user, 0 otherwise
label	[OPTIONAL] returned only if `enabled = 0` or if `code` is passed, this is the label that will be displayed in the authenticator app
secret	[OPTIONAL] returned only if `enabled = 0` or if `code` is passed, it is the secret key used by the authenticator app
uri	[OPTIONAL] returned only if `enabled = 0` or if `code` is passed, it is the provisioning URI to enable 2-factor authentication

/users/blocked_ips

/users/blocked_ips/add

access: [WRITE]

Add IPs to the block list.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.%2A

Query parameters

ips = 8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.*

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 4
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.%2A&format=xml

Query parameters

   ips = 8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.*
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>4</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.%2A&format=txt

Query parameters

   ips = 8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.*
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4

Example 4 (plain)

Request

https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.%2A&format=plain

Query parameters

   ips = 8.8.69.0,8.8.170.0,8.8.31.0,8.8.219.*
format = plain

Response

Required parameters

parameter	description
ipsARRAY	array of IPs to add to the block list

Return values

parameter	description
count	total number of added IPs

/users/blocked_ips/count

access: [READ]

This method returns the number of blocked IPs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/blocked_ips/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 2
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/blocked_ips/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>2</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/blocked_ips/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2

Example 4 (plain)

Request

https://joturl.com/a/i1/users/blocked_ips/count?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
count	total number of blocked IPs

/users/blocked_ips/delete

access: [WRITE]

Delete one or more blocked IPs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.%2A

Query parameters

ips = 8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.*

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 4
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.%2A&format=xml

Query parameters

   ips = 8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.*
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>4</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.%2A&format=txt

Query parameters

   ips = 8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.*
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4

Example 4 (plain)

Request

https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.%2A&format=plain

Query parameters

   ips = 8.8.50.0,8.8.214.0,8.8.117.0,8.8.181.*
format = plain

Response

Required parameters

parameter	description
ipsARRAY	array of blocked IPs to be deleted

Return values

parameter	description
count	total number of blocked IPs that have been deleted

/users/blocked_ips/is_blacklisted

access: [WRITE]

This method checks if the IPs in a list are blocked.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0

Query parameters

ids = 8.8.49.0,8.8.101.0,8.8.75.0

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ips": {
      "8.8.49.0": {
        "blacklisted": 1
      },
      "8.8.101.0": {
        "blacklisted": 0
      },
      "8.8.75.0": {
        "blacklisted": 0
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0&format=xml

Query parameters

   ids = 8.8.49.0,8.8.101.0,8.8.75.0
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ips>
      <8.8.49.0>
        <blacklisted>1</blacklisted>  
      </8.8.49.0>  
      <8.8.101.0>
        <blacklisted>0</blacklisted>  
      </8.8.101.0>  
      <8.8.75.0>
        <blacklisted>0</blacklisted>  
      </8.8.75.0>  
    </ips>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0&format=txt

Query parameters

   ids = 8.8.49.0,8.8.101.0,8.8.75.0
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ips_8.8.49.0_blacklisted=1
result_ips_8.8.101.0_blacklisted=0
result_ips_8.8.75.0_blacklisted=0

Example 4 (plain)

Request

https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0&format=plain

Query parameters

   ids = 8.8.49.0,8.8.101.0,8.8.75.0
format = plain

Response

1
0
0

Required parameters

parameter	description
ipsARRAY	array of IPs to be checked

Return values

parameter	description
ids	JSON object that contains each valid IP in `ips` with its check result `{"[IP1]":{"blacklisted":"[1\|0]"},...,"[IPN]":{"blacklisted":"[1\|0]"}}`

/users/blocked_ips/list

access: [READ]

This method returns a list of blocked IPs.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count

Query parameters

fields = ip,count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 4,
    "data": [
      "8.8.47.0",
      "8.8.247.0",
      "8.8.229.0",
      "8.8.195.0",
      "8.8.124.*"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count&format=xml

Query parameters

fields = ip,count
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>4</count>  
    <data>
      <i0>8.8.47.0</i0>  
      <i1>8.8.247.0</i1>  
      <i2>8.8.229.0</i2>  
      <i3>8.8.195.0</i3>  
      <i4>8.8.124.*</i4>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count&format=txt

Query parameters

fields = ip,count
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4
result_data_0=8.8.47.0
result_data_1=8.8.247.0
result_data_2=8.8.229.0
result_data_3=8.8.195.0
result_data_4=8.8.124.*

Example 4 (plain)

Request

https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count&format=plain

Query parameters

fields = ip,count
format = plain

Response

4
8.8.47.0
8.8.247.0
8.8.229.0
8.8.195.0
8.8.124.*

Example 5 (json)

Request

https://joturl.com/a/i1/users/blocked_ips/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      "8.8.198.100",
      "8.8.48.2"
    ]
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/users/blocked_ips/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>8.8.198.100</i0>  
      <i1>8.8.48.2</i1>  
    </data>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/users/blocked_ips/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0=8.8.198.100
result_data_1=8.8.48.2

Example 8 (plain)

Request

https://joturl.com/a/i1/users/blocked_ips/list?format=plain

Query parameters

format = plain

Response

8.8.198.100
8.8.48.2

Required parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: ip, count

Return values

parameter	description
count	[OPTIONAL] total number of blocked IPs, returned only if `count` is passed in fields
data	array containing a list of blocked IPs

/users/captcha

access: [WRITE]

This method emits a captcha.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/captcha?captcha=46f00555

Query parameters

captcha = 46f00555

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "captcha": "46f00555",
    "url": "\/a\/i1\/users\/captcha?captcha=46f00555"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/captcha?captcha=46f00555&format=xml

Query parameters

captcha = 46f00555
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <captcha>46f00555</captcha>  
    <url>/a/i1/users/captcha?captcha=46f00555</url>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/captcha?captcha=46f00555&format=txt

Query parameters

captcha = 46f00555
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_captcha=46f00555
result_url=/a/i1/users/captcha?captcha=46f00555

Example 4 (plain)

Request

https://joturl.com/a/i1/users/captcha?captcha=46f00555&format=plain

Query parameters

captcha = 46f00555
 format = plain

Response

46f00555
/a/i1/users/captcha?captcha=46f00555

Optional parameters

parameter	description
captchaSTRING	ID of the captcha, if it is passed this method returns the corresponding captcha image if valid, otherwise returns an invalid parameter error

Return values

parameter	description
captcha	ID of the captcha
url	URL of the captcha image

/users/confirm

access: [WRITE]

This method executes confirm operations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/confirm?info=f013a74e7e7cc0cbed29bc3485d72bcb

Query parameters

info = f013a74e7e7cc0cbed29bc3485d72bcb

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ok": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/confirm?info=f013a74e7e7cc0cbed29bc3485d72bcb&format=xml

Query parameters

  info = f013a74e7e7cc0cbed29bc3485d72bcb
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ok>1</ok>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/confirm?info=f013a74e7e7cc0cbed29bc3485d72bcb&format=txt

Query parameters

  info = f013a74e7e7cc0cbed29bc3485d72bcb
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/confirm?info=f013a74e7e7cc0cbed29bc3485d72bcb&format=plain

Query parameters

  info = f013a74e7e7cc0cbed29bc3485d72bcb
format = plain

Response

Required parameters

parameter	description
infoSTRING	confirm token sent to the user email

Return values

parameter	description
ok	1 on success, otherwise a generic error is issued

/users/forgot

access: [WRITE]

This method manages the "forgot password" procedure.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=995a80ba

Query parameters

  email = my.email@addess.is.here
   code = 12345
captcha = 995a80ba

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "message": "An e-mail with your login credentials has been sent to 'my.email@addess.is.here'."
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=995a80ba&format=xml

Query parameters

  email = my.email@addess.is.here
   code = 12345
captcha = 995a80ba
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <message>An e-mail with your login credentials has been sent to 'my.email@addess.is.here'.</message>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=995a80ba&format=txt

Query parameters

  email = my.email@addess.is.here
   code = 12345
captcha = 995a80ba
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_message=An e-mail with your login credentials has been sent to 'my.email@addess.is.here'.

Example 4 (plain)

Request

https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=995a80ba&format=plain

Query parameters

  email = my.email@addess.is.here
   code = 12345
captcha = 995a80ba
 format = plain

Response

An e-mail with your login credentials has been sent to 'my.email@addess.is.here'.

Required parameters

parameter	description	max length
captchaSTRING	ID of the captcha, see i1/users/captcha for details
codeSTRING	the code present in the captcha image and that the user has transcribed
emailSTRING	email address of the user that wants to start the "forgot password" procedure	255

/users/info

access: [READ]

This method returns info about the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "actually_subuser": 0,
    "company": "JotUrl",
    "default_domain_id": "e82c817327dc9819d0f3e75c56ed499f",
    "email": "my.email@address.to",
    "full_name": "Jon Smith",
    "gender": "m",
    "inactivity_timeout": 0,
    "is_readonly": 0,
    "location": "IT",
    "login": "my.email@address.to",
    "need_to_change_password": 0,
    "news_offers_consent": 0,
    "phone_number": "+1234567891011",
    "registration_time": "2018-06-25 23:18:21",
    "short_name": "JS",
    "spider_email": "",
    "spider_email_frequency": 1,
    "stats_permanency_days": 365,
    "subuser": 0
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <actually_subuser>0</actually_subuser>  
    <company>JotUrl</company>  
    <default_domain_id>e82c817327dc9819d0f3e75c56ed499f</default_domain_id>  
    <email>my.email@address.to</email>  
    <full_name>Jon Smith</full_name>  
    <gender>m</gender>  
    <inactivity_timeout>0</inactivity_timeout>  
    <is_readonly>0</is_readonly>  
    <location>IT</location>  
    <login>my.email@address.to</login>  
    <need_to_change_password>0</need_to_change_password>  
    <news_offers_consent>0</news_offers_consent>  
    <phone_number>+1234567891011</phone_number>  
    <registration_time>2018-06-25 23:18:21</registration_time>  
    <short_name>JS</short_name>  
    <spider_email></spider_email>  
    <spider_email_frequency>1</spider_email_frequency>  
    <stats_permanency_days>365</stats_permanency_days>  
    <subuser>0</subuser>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_actually_subuser=0
result_company=JotUrl
result_default_domain_id=e82c817327dc9819d0f3e75c56ed499f
result_email=my.email@address.to
result_full_name=Jon Smith
result_gender=m
result_inactivity_timeout=0
result_is_readonly=0
result_location=IT
result_login=my.email@address.to
result_need_to_change_password=0
result_news_offers_consent=0
result_phone_number=+1234567891011
result_registration_time=2018-06-25 23:18:21
result_short_name=JS
result_spider_email=
result_spider_email_frequency=1
result_stats_permanency_days=365
result_subuser=0

Example 4 (plain)

Request

https://joturl.com/a/i1/users/info?format=plain

Query parameters

format = plain

Response

0
JotUrl
e82c817327dc9819d0f3e75c56ed499f
my.email@address.to
Jon Smith
m
0
0
IT
my.email@address.to
0
0
+1234567891011
2018-06-25 23:18:21
JS

1
365
0

Optional parameters

parameter	description
fieldsARRAY	comma separated list of fields to return, available fields: actually_subuser, company, default_domain_id, email, full_name, gender, inactivity_timeout, is_readonly, location, login, need_to_change_password, news_offers_consent, phone_number, registration_time, short_name, spider_email, spider_email_frequency, stats_permanency_days, subuser

Return values

parameter	description
data	information on the user/subuser

Available fields in data:

actually_subuser: 1 if the logged user is actually a subuser, 0 otherwise (i.e., a root user). The return value for a user who is an alias of a root user is 1, since the user is actually a subuser.
company: company of the user, this field is not available for subusers
default_domain_id: the default domain for the logged user, this setting will be used as the default setting for endpoints that do not require the domain ID
email: email address of the user
full_name: full name of the user
gender: gender of the user
inactivity_timeout: the number of seconds of inactivity expected for the user, 0 otherwise (i.e., no inactivity timeout)
is_readonly: 1 if the user is readonly, 0 otherwise
location: 2-digit code of the country (ISO Alpha-2) the user is based on
login: user name used to login
need_to_change_password: 1 if the user is required to change password, 0 otherwise
news_offers_consent: 1 if the user has authorized to receive offers by e-mail, 0 otherwise
phone_number: phone number of the user
registration_time: date and time when the user registered
short_name: short name for the user
spider_email: comma separated list of emails to which the content monitoring will send security alerts, if empty or null the login email will be used
spider_email_frequency: how often the content monitoring will send alerts, see i1/watchdogs/property for a list of available frequencies
stats_permanency_days: analytics are stored for this number of days
subuser: 1 if the logged user is a subuser, 0 otherwise (i.e., a root user). The return value for a user who is an alias of a root user is 0.

/users/jotbars

/users/jotbars/edit

access: [WRITE]

Set a jotbar option for a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/jotbars/edit?user_id=6c8fff7af49436fd36c221bb7efa5c4a&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D

Query parameters

         user_id = 6c8fff7af49436fd36c221bb7efa5c4a
            logo = https://joturl.com/logo.svg
        logo_url = https://joturl.com/
        template = right
   template_size = big
       languages = en,it
default_language = en
            info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/jotbars/edit?user_id=6c8fff7af49436fd36c221bb7efa5c4a&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=xml

Query parameters

         user_id = 6c8fff7af49436fd36c221bb7efa5c4a
            logo = https://joturl.com/logo.svg
        logo_url = https://joturl.com/
        template = right
   template_size = big
       languages = en,it
default_language = en
            info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
          format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/jotbars/edit?user_id=6c8fff7af49436fd36c221bb7efa5c4a&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=txt

Query parameters

         user_id = 6c8fff7af49436fd36c221bb7efa5c4a
            logo = https://joturl.com/logo.svg
        logo_url = https://joturl.com/
        template = right
   template_size = big
       languages = en,it
default_language = en
            info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
          format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/jotbars/edit?user_id=6c8fff7af49436fd36c221bb7efa5c4a&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=plain

Query parameters

         user_id = 6c8fff7af49436fd36c221bb7efa5c4a
            logo = https://joturl.com/logo.svg
        logo_url = https://joturl.com/
        template = right
   template_size = big
       languages = en,it
default_language = en
            info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
          format = plain

Response

Optional parameters

parameter	description
default_languageSTRING	set the account-level default language, see i1/users/languages/set for details
infoJSON	JSON containing page_title, description_title, description, questions_title, questions for each enabled language, see i1/users/languages/set for details
logoSTRING	it can be: the URL of the logo to be shown; empty or `null` to disable it
logo_urlSTRING	when logo has an URL, this is the URL to which the user will be redirect when he/she clicks on the logo
show_feedbackSTRING	1 to show feedback, 0 to do not show it
templateSTRING	position of the jotbar, empty or `null` to disable the jotbar feature, for available positions see i1/jotbars/property
template_sizeSTRING	dimension of the jotbar, empty or `null` to disable the jotbar feature, for available dimensions see i1/jotbars/property

Return values

parameter	description
updated	1 on success, 0 otherwise

/users/jotbars/info

access: [READ]

Get account-level settings for the jotbar.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/jotbars/info?user_id=39954af45245095d6be2b25675f2a590

Query parameters

user_id = 39954af45245095d6be2b25675f2a590

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "logo": "https:\/\/joturl.com\/logo.svg",
    "logo_url": "https:\/\/joturl.com\/",
    "template": "right",
    "template_size": "big",
    "show_feedback": null,
    "default_language": "en",
    "info": {
      "en": {
        "page_title": "English page title",
        "description_title": null,
        "description": "<p>[EN] HTML description<\/p>",
        "questions_title": null,
        "questions": "<p>[EN] HTML questions<\/p>"
      },
      "it": {
        "page_title": "Titolo pagina in italiano",
        "description_title": null,
        "description": "<p>[IT] HTML description<\/p>",
        "questions_title": null,
        "questions": "<p>[IT] HTML questions<\/p>"
      }
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/jotbars/info?user_id=39954af45245095d6be2b25675f2a590&format=xml

Query parameters

user_id = 39954af45245095d6be2b25675f2a590
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <logo>https://joturl.com/logo.svg</logo>  
    <logo_url>https://joturl.com/</logo_url>  
    <template>right</template>  
    <template_size>big</template_size>  
    <show_feedback></show_feedback>  
    <default_language>en</default_language>  
    <info>
      <en>
        <page_title>English page title</page_title>  
        <description_title></description_title>  
        <description><[CDATA[&lt;p&gt;[EN] HTML description&lt;/p&gt;]]></description>  
        <questions_title></questions_title>  
        <questions><[CDATA[&lt;p&gt;[EN] HTML questions&lt;/p&gt;]]></questions>  
      </en>  
      <it>
        <page_title>Titolo pagina in italiano</page_title>  
        <description_title></description_title>  
        <description><[CDATA[&lt;p&gt;[IT] HTML description&lt;/p&gt;]]></description>  
        <questions_title></questions_title>  
        <questions><[CDATA[&lt;p&gt;[IT] HTML questions&lt;/p&gt;]]></questions>  
      </it>  
    </info>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/jotbars/info?user_id=39954af45245095d6be2b25675f2a590&format=txt

Query parameters

user_id = 39954af45245095d6be2b25675f2a590
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_logo=https://joturl.com/logo.svg
result_logo_url=https://joturl.com/
result_template=right
result_template_size=big
result_show_feedback=
result_default_language=en
result_info_en_page_title=English page title
result_info_en_description_title=
result_info_en_description=&lt;p&gt;[EN] HTML description&lt;/p&gt;
result_info_en_questions_title=
result_info_en_questions=&lt;p&gt;[EN] HTML questions&lt;/p&gt;
result_info_it_page_title=Titolo pagina in italiano
result_info_it_description_title=
result_info_it_description=&lt;p&gt;[IT] HTML description&lt;/p&gt;
result_info_it_questions_title=
result_info_it_questions=&lt;p&gt;[IT] HTML questions&lt;/p&gt;

Example 4 (plain)

Request

https://joturl.com/a/i1/users/jotbars/info?user_id=39954af45245095d6be2b25675f2a590&format=plain

Query parameters

user_id = 39954af45245095d6be2b25675f2a590
 format = plain

Response

https://joturl.com/logo.svg
https://joturl.com/
right
big

en
English page title

&lt;p&gt;[EN] HTML description&lt;/p&gt;

&lt;p&gt;[EN] HTML questions&lt;/p&gt;
Titolo pagina in italiano

&lt;p&gt;[IT] HTML description&lt;/p&gt;

&lt;p&gt;[IT] HTML questions&lt;/p&gt;

Return values

parameter	description
info	for each enabled language, it contains page_title, description_title, description, questions_title, questions, see the following notes for details
user_default_language	account-level default language, see i1/users/languages/list for details
user_logo	the URL of the logo to be shown or empty or `null` to disable it
user_logo_url	when user_logo has an URL, this is the URL to which the user will be redirect when clicks on the logo
user_show_feedback	1 to show feedback, 0 to do not show it
user_template	position of the jotbar, empty or `null` to disable the jotbar feature, for available positions see i1/jotbars/property
user_template_size	dimension of the jotbar, empty or `null` to disable the jotbar feature, for available dimensions see i1/jotbars/property

/users/languages

/users/languages/list

access: [READ]

This method returns a list of available languages for specific options (e.g., Masking, jotBar) of a tracking link.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/languages/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "languages": [
      {
        "name": "en",
        "label": "English"
      },
      {
        "name": "it",
        "label": "Italiano"
      },
      {
        "name": "de",
        "label": "Deutsch"
      },
      {
        "name": "fr",
        "label": "Française"
      },
      {
        "name": "es",
        "label": "Español"
      },
      {
        "name": "jp",
        "label": "\u65e5\u672c"
      }
    ],
    "selected": [
      "en",
      "it"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/languages/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <languages>
      <i0>
        <name>en</name>  
        <label>English</label>  
      </i0>  
      <i1>
        <name>it</name>  
        <label>Italiano</label>  
      </i1>  
      <i2>
        <name>de</name>  
        <label>Deutsch</label>  
      </i2>  
      <i3>
        <name>fr</name>  
        <label><[CDATA[Fran&ccedil;aise]]></label>  
      </i3>  
      <i4>
        <name>es</name>  
        <label><[CDATA[Espa&ntilde;ol]]></label>  
      </i4>  
      <i5>
        <name>jp</name>  
        <label>日本</label>  
      </i5>  
    </languages>  
    <selected>
      <i0>en</i0>  
      <i1>it</i1>  
    </selected>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/languages/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_languages_0_name=en
result_languages_0_label=English
result_languages_1_name=it
result_languages_1_label=Italiano
result_languages_2_name=de
result_languages_2_label=Deutsch
result_languages_3_name=fr
result_languages_3_label=Fran&ccedil;aise
result_languages_4_name=es
result_languages_4_label=Espa&ntilde;ol
result_languages_5_name=jp
result_languages_5_label=日本
result_selected_0=en
result_selected_1=it

Example 4 (plain)

Request

https://joturl.com/a/i1/users/languages/list?format=plain

Query parameters

format = plain

Response

en
English
it
Italiano
de
Deutsch
fr
Fran&ccedil;aise
es
Espa&ntilde;ol
jp
日本
en
it

Return values

parameter	description
languages	array of available languages (name,label)
selected	array of enabled languages (name)

/users/languages/set

access: [WRITE]

This method enables a list of languages for the current user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/languages/set?langs=en,it

Query parameters

langs = en,it

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/languages/set?langs=en,it&format=xml

Query parameters

 langs = en,it
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/languages/set?langs=en,it&format=txt

Query parameters

 langs = en,it
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/languages/set?langs=en,it&format=plain

Query parameters

 langs = en,it
format = plain

Response

Required parameters

parameter	description
langsARRAY	comma-separated list of languages to enable, each language is identified by its name, see i1/users/languages/list for details

Return values

parameter	description
updated	1 in case of success, 0 in case of failure or if there was no change in the list of languages

access: [WRITE]

This method allows a user to login into the private area via credentials or through an external provider.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=dab3f86c

Query parameters

username = username@domain.ext
password = dab3f86c

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "session_id": "fca826c05d7aa077e8b7456b107dcb47"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=dab3f86c&format=xml

Query parameters

username = username@domain.ext
password = dab3f86c
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <session_id>fca826c05d7aa077e8b7456b107dcb47</session_id>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=dab3f86c&format=txt

Query parameters

username = username@domain.ext
password = dab3f86c
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_session_id=fca826c05d7aa077e8b7456b107dcb47

Example 4 (plain)

Request

https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=dab3f86c&format=plain

Query parameters

username = username@domain.ext
password = dab3f86c
  format = plain

Response

fca826c05d7aa077e8b7456b107dcb47

Optional parameters

parameter	description	max length
captchaSTRING	used when `signup = 1`, see i1/users/signup for details
codeSTRING	used when `signup = 1`, see i1/users/signup for details
news_offers_consentBOOLEAN	used when `signup = 1`, see i1/users/signup for details
passwordSTRING	password to use to log in	100
providerSTRING	alternative login provider, available providers: microsoftgraph, amazon, google, facebook, twitter, windowslive, linkedin	100
redirectURL	redirect URL to be used after logged in, only used if parameter `provider` is passed	4000
signupBOOLEAN	used when `provider` is passed, `signup = 1` forces the signup from an alternative login when the user is not already registered, `signup = 0` has no effect
tfa_codeSTRING	2-factor authentication code if enabled, see i1/users/2fa/info for details
tokenSTRING	used when `signup = 1`, see i1/users/signup for details
tos_pp_consentBOOLEAN	used when `signup = 1`, see i1/users/signup for details
usernameSTRING	user name to use to log in	255

Return values

parameter	description
datetime	server date and time, to be used to synchronize calls
device_id	a unique ID that identifies the device from which the login is being made
session_id	ID of the login session

/users/logout

access: [WRITE]

This method executes a logout.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/logout

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/logout?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/logout?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK

Example 4 (plain)

Request

https://joturl.com/a/i1/users/logout?format=plain

Query parameters

format = plain

Response

200
OK

Optional parameters

parameter	description
logout_allBOOLEAN	set to 1 if you want to disconnect from all accounts on all devices

Return values

parameter	description
old_session_id	ID of the login session that was just destroyed
redir_url	URL to redirect the user to

/users/notifications

/users/notifications/count

access: [READ]

This method returns the number of new notifications for the user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/notifications/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 10
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/notifications/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>10</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/notifications/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=10

Example 4 (plain)

Request

https://joturl.com/a/i1/users/notifications/count?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
count	number of available notifications

/users/notifications/list

access: [READ]

This method returns a list of notifications for the user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/notifications/list

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "2020-10-24": [
      {
        "notification_id": "e908c29574ab77a3b5925dd447c9e1e2",
        "datetime": "2020-10-24T18:20:39+02:00",
        "read": 0,
        "type": 0,
        "type_description": "deleted",
        "short_url": "jo.my\/joturl",
        "who": "User Name (user@email)",
        "long_url": {
          "old": "",
          "new": ""
        }
      },
      {
        "notification_id": "2d8f171b985871736d1e55fda26eb7d5",
        "datetime": "2020-10-24T18:16:47+02:00",
        "read": 1,
        "type": 0,
        "type_description": "deleted",
        "short_url": "jo.my\/joturl",
        "who": "you",
        "long_url": {
          "old": "",
          "new": ""
        }
      }
    ],
    "2020-10-20": [
      {
        "notification_id": "fe0b506445a904717489637550f1129b",
        "datetime": "2020-10-20T16:37:32+02:00",
        "read": 1,
        "type": 1,
        "type_description": "long url changed",
        "short_url": "jo.my\/joturl",
        "who": "you",
        "long_url": {
          "old": "http:\/\/www.joturl.com\/",
          "new": "https:\/\/joturl.com\/"
        }
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/notifications/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <2020-10-24>
      <i0>
        <notification_id>e908c29574ab77a3b5925dd447c9e1e2</notification_id>  
        <datetime>2020-10-24T18:20:39+02:00</datetime>  
        <read>0</read>  
        <type>0</type>  
        <type_description>deleted</type_description>  
        <short_url>jo.my/joturl</short_url>  
        <who>User Name (user@email)</who>  
        <long_url>
          <old></old>  
          <new></new>  
        </long_url>  
      </i0>  
      <i1>
        <notification_id>2d8f171b985871736d1e55fda26eb7d5</notification_id>  
        <datetime>2020-10-24T18:16:47+02:00</datetime>  
        <read>1</read>  
        <type>0</type>  
        <type_description>deleted</type_description>  
        <short_url>jo.my/joturl</short_url>  
        <who>you</who>  
        <long_url>
          <old></old>  
          <new></new>  
        </long_url>  
      </i1>  
    </2020-10-24>  
    <2020-10-20>
      <i0>
        <notification_id>fe0b506445a904717489637550f1129b</notification_id>  
        <datetime>2020-10-20T16:37:32+02:00</datetime>  
        <read>1</read>  
        <type>1</type>  
        <type_description>long url changed</type_description>  
        <short_url>jo.my/joturl</short_url>  
        <who>you</who>  
        <long_url>
          <old>http://www.joturl.com/</old>  
          <new>https://joturl.com/</new>  
        </long_url>  
      </i0>  
    </2020-10-20>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/notifications/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_2020-10-24_0_notification_id=e908c29574ab77a3b5925dd447c9e1e2
result_2020-10-24_0_datetime=2020-10-24T18:20:39+02:00
result_2020-10-24_0_read=0
result_2020-10-24_0_type=0
result_2020-10-24_0_type_description=deleted
result_2020-10-24_0_short_url=jo.my/joturl
result_2020-10-24_0_who=User Name (user@email)
result_2020-10-24_0_long_url_old=
result_2020-10-24_0_long_url_new=
result_2020-10-24_1_notification_id=2d8f171b985871736d1e55fda26eb7d5
result_2020-10-24_1_datetime=2020-10-24T18:16:47+02:00
result_2020-10-24_1_read=1
result_2020-10-24_1_type=0
result_2020-10-24_1_type_description=deleted
result_2020-10-24_1_short_url=jo.my/joturl
result_2020-10-24_1_who=you
result_2020-10-24_1_long_url_old=
result_2020-10-24_1_long_url_new=
result_2020-10-20_0_notification_id=fe0b506445a904717489637550f1129b
result_2020-10-20_0_datetime=2020-10-20T16:37:32+02:00
result_2020-10-20_0_read=1
result_2020-10-20_0_type=1
result_2020-10-20_0_type_description=long url changed
result_2020-10-20_0_short_url=jo.my/joturl
result_2020-10-20_0_who=you
result_2020-10-20_0_long_url_old=http://www.joturl.com/
result_2020-10-20_0_long_url_new=https://joturl.com/

Example 4 (plain)

Request

https://joturl.com/a/i1/users/notifications/list?format=plain

Query parameters

format = plain

Response

jo.my/joturl
jo.my/joturl
jo.my/joturl

Optional parameters

parameter	description
lengthINTEGER	extracts this number of notifications (maxmimum allowed: 100)
startINTEGER	starts to extract notifications from this position

Return values

parameter	description
data	array containing information on notifications

The output data field is in the format {"date":[{INFO}]}, where date is the date on which the notification was issued, and {INFO} contains:

notification_id: ID of the notification
datetime: date/time (ISO 8601 date/time) of the notification
read: 1 if the notification has already been read, 0 otherwise
type: (integer) notification type (see below for available types)
type_description: notification type description
short_url: involved tracking link
who: identifier of the user who caused the generation of the notification, special users are you (i.e., that is, the user himself), admin (i.e., JotUrl administrator), system (i.e., the JotUrl engine)
long_url: available only if the notification is related to a change of destination URL or the tracking link has been deleted, it is a JSON object containing the fields old (i.e., the old destination URL) and new (i.e., the new destination URL)
deactivation_in_days: [OPTIONAL] only present when type = 4, the URL will be disabled upon expiry of the indicated number of days

Available types:

0: the tracking link has been deleted (type_description = deleted)
1: the destination URL has been changed (type_description = long url changed)
2: the tracking link has been disabled (type_description = url disabled)
3: the tracking link has been enabled (type_description = url enabled)
4: the URL will be disabled for security reasons (type_description = url will be deactivated)
5: the deactivation process was aborted (type_description = deactivation disabled)
6: generic/unknow operation (type_description = unknown)

/users/renew

access: [WRITE]

This method executes renew operations.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/renew?info=412f06a13501f5b399172577af86d0f6

Query parameters

info = 412f06a13501f5b399172577af86d0f6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ok": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/renew?info=412f06a13501f5b399172577af86d0f6&format=xml

Query parameters

  info = 412f06a13501f5b399172577af86d0f6
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ok>1</ok>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/renew?info=412f06a13501f5b399172577af86d0f6&format=txt

Query parameters

  info = 412f06a13501f5b399172577af86d0f6
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/renew?info=412f06a13501f5b399172577af86d0f6&format=plain

Query parameters

  info = 412f06a13501f5b399172577af86d0f6
format = plain

Response

Required parameters

parameter	description
infoSTRING	token sent to the user email

/users/reports

/users/reports/get

access: [READ]

This method get the configuration for reports.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/reports/get

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "enabled": 1,
    "position": "top_left",
    "id": "1f7273af1260015036f6a8ddaefaf98e",
    "metadata": {
      "name": "my logo",
      "creation": "2026-05-26 14:00:32",
      "width": 400,
      "height": 300,
      "size": 32442,
      "url": "https:\/\/cdn.endpoint\/path\/to\/resource"
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/reports/get?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <enabled>1</enabled>  
    <position>top_left</position>  
    <id>1f7273af1260015036f6a8ddaefaf98e</id>  
    <metadata>
      <name>my logo</name>  
      <creation>2026-05-26 14:00:32</creation>  
      <width>400</width>  
      <height>300</height>  
      <size>32442</size>  
      <url>https://cdn.endpoint/path/to/resource</url>  
    </metadata>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/reports/get?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
result_position=top_left
result_id=1f7273af1260015036f6a8ddaefaf98e
result_metadata_name=my logo
result_metadata_creation=2026-05-26 14:00:32
result_metadata_width=400
result_metadata_height=300
result_metadata_size=32442
result_metadata_url=https://cdn.endpoint/path/to/resource

Example 4 (plain)

Request

https://joturl.com/a/i1/users/reports/get?format=plain

Query parameters

format = plain

Response

1
top_left
1f7273af1260015036f6a8ddaefaf98e
my logo
2026-05-26 14:00:32
400
300
32442
https://cdn.endpoint/path/to/resource

Return values

parameter	description
enabled	1 when custom logo in reports is enabled, 0 otherwise
id	ID of the CDN resource used as custom logo in reports if `enabled = 1`, empty or `null` if `enabled = 0`
metadata	array containing information on the CDN resource
position	position of the custom logo if `enabled = 1`, empty or `null` if `enabled = 0`

/users/reports/property

access: [READ]

Returns allowed position for the custom logo in reports.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/reports/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "positions": [
      "top_left",
      "top_center",
      "top_right"
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/reports/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <positions>
      <i0>top_left</i0>  
      <i1>top_center</i1>  
      <i2>top_right</i2>  
    </positions>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/reports/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_positions_0=top_left
result_positions_1=top_center
result_positions_2=top_right

Example 4 (plain)

Request

https://joturl.com/a/i1/users/reports/property?format=plain

Query parameters

format = plain

Response

top_left
top_center
top_right

Return values

parameter	description
positions	available position for the custom logo in reports

/users/reports/set

access: [WRITE]

This method sets the configuration for reports.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)Example 5 (json)Example 6 (xml)Example 7 (txt)Example 8 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/reports/set?enabled=0

Query parameters

enabled = 0

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/reports/set?enabled=0&format=xml

Query parameters

enabled = 0
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/reports/set?enabled=0&format=txt

Query parameters

enabled = 0
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/reports/set?enabled=0&format=plain

Query parameters

enabled = 0
 format = plain

Response

Example 5 (json)

Request

https://joturl.com/a/i1/users/reports/set?enabled=1&id=18e4eaefa0996d85ff45b550bb2677ba&position=top_left

Query parameters

 enabled = 1
      id = 18e4eaefa0996d85ff45b550bb2677ba
position = top_left

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 6 (xml)

Request

https://joturl.com/a/i1/users/reports/set?enabled=1&id=18e4eaefa0996d85ff45b550bb2677ba&position=top_left&format=xml

Query parameters

 enabled = 1
      id = 18e4eaefa0996d85ff45b550bb2677ba
position = top_left
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 7 (txt)

Request

https://joturl.com/a/i1/users/reports/set?enabled=1&id=18e4eaefa0996d85ff45b550bb2677ba&position=top_left&format=txt

Query parameters

 enabled = 1
      id = 18e4eaefa0996d85ff45b550bb2677ba
position = top_left
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 8 (plain)

Request

https://joturl.com/a/i1/users/reports/set?enabled=1&id=18e4eaefa0996d85ff45b550bb2677ba&position=top_left&format=plain

Query parameters

 enabled = 1
      id = 18e4eaefa0996d85ff45b550bb2677ba
position = top_left
  format = plain

Response

Required parameters

parameter	description
enabledBOOLEAN	1 to enable the custom logo in reports, 0 to disable it

Optional parameters

parameter	description
idID	ID of the CDN resource to use as logo
positionSTRING	position of the logo, see i1/users/reports/property for available position

Return values

parameter	description
deleted	[OPTIONAL] 1 on success, 0 otherwise, only returned when `enabled = 0`
updated	[OPTIONAL] 1 on success, 0 otherwise, only returned when `enabled = 1`

/users/security

/users/security/info

access: [READ]

This method returns advanced security settings for the logged user. Ony available to admin users.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/security/info

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "inactivity_timeout": 15,
    "force_change_password_interval": 0,
    "do_not_allow_old_passwords": 0,
    "warning_on_anomalous_logins": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/security/info?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <inactivity_timeout>15</inactivity_timeout>  
    <force_change_password_interval>0</force_change_password_interval>  
    <do_not_allow_old_passwords>0</do_not_allow_old_passwords>  
    <warning_on_anomalous_logins>1</warning_on_anomalous_logins>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/security/info?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_inactivity_timeout=15
result_force_change_password_interval=0
result_do_not_allow_old_passwords=0
result_warning_on_anomalous_logins=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/security/info?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
do_not_allow_old_passwords	number of previous passwords that the user cannot use when changing password; allowed values from 2 to 10 inclusive, 0 means disabled
force_change_password_interval	the time in months after which the user must change password; allowed values from 2 to 60 inclusive, 0 means disabled
inactivity_timeout	the time in minutes after which the user is disconnected in the absence of activity; allowed values from 15 to 43200 inclusive, 0 means disabled
warning_on_anomalous_logins	1 to send an email in case of access from previously unused devices/IPs, 0 otherwise

/users/security/set

access: [WRITE]

This method sets advanced security settings for the logged user. Ony available to admin users.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1

Query parameters

         inactivity_timeout = 15
      force_change_password = 0
 do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "inactivity_timeout": 15,
    "force_change_password": 0,
    "do_not_allow_old_passwords": 0,
    "warning_on_anomalous_logins": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1&format=xml

Query parameters

         inactivity_timeout = 15
      force_change_password = 0
 do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
                     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <inactivity_timeout>15</inactivity_timeout>  
    <force_change_password>0</force_change_password>  
    <do_not_allow_old_passwords>0</do_not_allow_old_passwords>  
    <warning_on_anomalous_logins>1</warning_on_anomalous_logins>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1&format=txt

Query parameters

         inactivity_timeout = 15
      force_change_password = 0
 do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
                     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_inactivity_timeout=15
result_force_change_password=0
result_do_not_allow_old_passwords=0
result_warning_on_anomalous_logins=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1&format=plain

Query parameters

         inactivity_timeout = 15
      force_change_password = 0
 do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
                     format = plain

Response

Optional parameters

parameter	description
do_not_allow_old_passwordsINTEGER	number of previous passwords that the user cannot use when changing password; allowed values from 2 to 10 inclusive, 0 means disabled
force_change_passwordINTEGER	the time in months after which the user must change password; allowed values from 2 to 60 inclusive, 0 means disabled
inactivity_timeoutINTEGER	the time in minutes after which the user is disconnected in the absence of activity; allowed values from 15 to 43200 inclusive, 0 means disabled
warning_on_anomalous_loginsSTRING	1 to send an email in case of access from previously unused devices/IPs, 0 otherwise

Return values

parameter	description
updated	1 on success, 0 otherwise

/users/set

access: [WRITE]

This method set info about the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/set?old_password=bee76cfe13aec888013f26668b9b3ec4&new_password=7be6bb55fe8fb2ad618075a9261a9b96&confirm_password=7be6bb55fe8fb2ad618075a9261a9b96

Query parameters

    old_password = bee76cfe13aec888013f26668b9b3ec4
    new_password = 7be6bb55fe8fb2ad618075a9261a9b96
confirm_password = 7be6bb55fe8fb2ad618075a9261a9b96

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "updated": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/set?old_password=bee76cfe13aec888013f26668b9b3ec4&new_password=7be6bb55fe8fb2ad618075a9261a9b96&confirm_password=7be6bb55fe8fb2ad618075a9261a9b96&format=xml

Query parameters

    old_password = bee76cfe13aec888013f26668b9b3ec4
    new_password = 7be6bb55fe8fb2ad618075a9261a9b96
confirm_password = 7be6bb55fe8fb2ad618075a9261a9b96
          format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/set?old_password=bee76cfe13aec888013f26668b9b3ec4&new_password=7be6bb55fe8fb2ad618075a9261a9b96&confirm_password=7be6bb55fe8fb2ad618075a9261a9b96&format=txt

Query parameters

    old_password = bee76cfe13aec888013f26668b9b3ec4
    new_password = 7be6bb55fe8fb2ad618075a9261a9b96
confirm_password = 7be6bb55fe8fb2ad618075a9261a9b96
          format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/set?old_password=bee76cfe13aec888013f26668b9b3ec4&new_password=7be6bb55fe8fb2ad618075a9261a9b96&confirm_password=7be6bb55fe8fb2ad618075a9261a9b96&format=plain

Query parameters

    old_password = bee76cfe13aec888013f26668b9b3ec4
    new_password = 7be6bb55fe8fb2ad618075a9261a9b96
confirm_password = 7be6bb55fe8fb2ad618075a9261a9b96
          format = plain

Response

Optional parameters

parameter	description
codeSTRING	security code sent by email
companySTRING	company of the logged user
default_domain_idSTRING	the default domain for the logged user, this setting will be used as the default setting for endpoints that do not require the domain ID
full_nameSTRING	full name of the logged user
genderSTRING	gender of the logged user [m\|f]
locationSTRING	ISO 3166-1 alpha-2 code of the country of the logged user
news_offers_consentBOOLEAN	1 if the logged user has authorized the offers by e-mail, 0 otherwise
phone_numberSTRING	phone number of the logged user
spider_emailSTRING	comma separated list of emails to which content monitor will send security alerts, if not specified, login email will be used, maximum 10 email addresses are allowed
spider_email_frequencySTRING	how often the content monitoring will send alerts, see i1/watchdogs/property for a list of available frequencies

Overview

This method allows to set the information of the logged in user and to configure his/her account. You can also change the password used for the login and the email associated with the account.

How to change the password used to log in

A password change operation requires parameters old_password, new_password and confirm_password. Parameters new_password and confirm_password are mandatory and must be equal. new_password must be at least 8 characters long.

NOTE: when a password change operation is requested the POST method is required (because the password is sent) and no other parameter can be changed.

How to change the account email

WARNINGS:

changing the account email involves changing the username used to log in and the log out of all user sessions,
permissions granted to all your external applications will NOT be revoked, see i1/oauth/granted/revoke,
API keys will NOT be reset, see i1/apis/keys.

To change the account email follow this flow:

Step 1: call this method by passing parameters email, old_password, new_password, confirm_password, see above for constraints on old_password, new_password, confirm_password. On success, a security code is sent to email and security_code_required = 1 is returned,
Step 2: call this method by passing parameters code, email, old_password, new_password, confirm_password, where code is the security code that has been sent in the previous step to email, on success it will return updated = 1.

NOTE: when an email change operation is requested the POST method is required (because the password is sent) and no other parameter can be changed.

Other constraints

Parameter spider_email_frequency is mandatory when spider_email is passed (and viceversa).
All other parameters do not depend on each other and can be modified separately.

Return values

parameter	description
security_code_required	[OPTIONAL] 1 if the security code is required, it is returned only when an email change is required
updated	1 on success, 0 otherwise

access: [WRITE]

This method executes a signup.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=11d4fb4a9cd3d6d6&confirm=11d4fb4a9cd3d6d6

Query parameters

    name = Jon Smith
   email = my.smart@email.address
password = 11d4fb4a9cd3d6d6
 confirm = 11d4fb4a9cd3d6d6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "ok": 1,
    "need_confirm": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=11d4fb4a9cd3d6d6&confirm=11d4fb4a9cd3d6d6&format=xml

Query parameters

    name = Jon Smith
   email = my.smart@email.address
password = 11d4fb4a9cd3d6d6
 confirm = 11d4fb4a9cd3d6d6
  format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <ok>1</ok>  
    <need_confirm>1</need_confirm>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=11d4fb4a9cd3d6d6&confirm=11d4fb4a9cd3d6d6&format=txt

Query parameters

    name = Jon Smith
   email = my.smart@email.address
password = 11d4fb4a9cd3d6d6
 confirm = 11d4fb4a9cd3d6d6
  format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1
result_need_confirm=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=11d4fb4a9cd3d6d6&confirm=11d4fb4a9cd3d6d6&format=plain

Query parameters

    name = Jon Smith
   email = my.smart@email.address
password = 11d4fb4a9cd3d6d6
 confirm = 11d4fb4a9cd3d6d6
  format = plain

Response

1
1

Required parameters

parameter	description
tos_pp_consentBOOLEAN	1 if the user has given consent for the terms of service and the privacy policy, 0 otherwise, it must be 1 to be able to sign up

Optional parameters

parameter	description	max length
captchaSTRING	ID of the captcha, see i1/users/captcha for details, optional to `token`
codeSTRING	the code present in the captcha image and that the user has transcribed, optional to `token`
companySTRING	company of the user	255
confirmSTRING	confirmation for the password, must be the same as the password and retrieved from a different input field	100
emailSTRING	email of the user	255
genderSTRING	gender of the user, possible values: [m, f], default: m	1
locationSTRING	2-digit code of the country (ISO Alpha-2) the user is based on (e.g., US), if not passed our engine tries to retrieve location from the browser	50
nameSTRING	full name of the user	255
news_offers_consentBOOLEAN	1 if the user has given consent for the news, 0 otherwise
passwordSTRING	password for the login	100
tokenSTRING	Google reCAPTCHA token, optional to `code` and `captcha`

Return values

parameter	description
need_confirm	1 if the user must confirm his/hers email address by clicking on the email that our engine sent
ok	1 on success, otherwise a generic error is issued

/users/stats

/users/stats/details

access: [READ]

This method returns detailed events on the last 30/60/90 days for the logged user.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/stats/details

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "aggregate": [
      {
        "type": "[type 1]",
        "label": "[label 1]",
        "event": "[generates event?]",
        "count": 4569
      },
      {
        "type": "[...]",
        "label": "[...]",
        "event": "[generates event?]",
        "count": "[...]"
      },
      {
        "type": "[type N]",
        "label": "[label N]",
        "event": "[generates event?]",
        "count": 9753
      }
    ],
    "by_date": {
      "2026-04-26": [
        {
          "type": "[type 1]",
          "label": "[label 1]",
          "event": "[generates event?]",
          "count": 2458
        },
        {
          "type": "[...]",
          "label": "[...]",
          "event": "[generates event?]",
          "count": "[...]"
        },
        {
          "type": "[type N]",
          "label": "[label N]",
          "event": "[generates event?]",
          "count": 9516
        }
      ],
      "[...]": [
        {
          "type": "[type 1]",
          "label": "[label 1]",
          "event": "[generates event?]",
          "count": 8599
        },
        {
          "type": "[...]",
          "label": "[...]",
          "event": "[generates event?]",
          "count": "[...]"
        },
        {
          "type": "[type N]",
          "label": "[label N]",
          "event": "[generates event?]",
          "count": 9725
        }
      ],
      "2026-05-26": [
        {
          "type": "[type 1]",
          "label": "[label 1]",
          "event": "[generates event?]",
          "count": 8742
        },
        {
          "type": "[...]",
          "label": "[...]",
          "event": "[generates event?]",
          "count": "[...]"
        },
        {
          "type": "[type N]",
          "label": "[label N]",
          "event": "[generates event?]",
          "count": 2612
        }
      ]
    }
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/stats/details?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <aggregate>
      <i0>
        <type>[type 1]</type>  
        <label>[label 1]</label>  
        <event>[generates event?]</event>  
        <count>4569</count>  
      </i0>  
      <i1>
        <type>[...]</type>  
        <label>[...]</label>  
        <event>[generates event?]</event>  
        <count>[...]</count>  
      </i1>  
      <i2>
        <type>[type N]</type>  
        <label>[label N]</label>  
        <event>[generates event?]</event>  
        <count>9753</count>  
      </i2>  
    </aggregate>  
    <by_date>
      <2026-04-26>
        <i0>
          <type>[type 1]</type>  
          <label>[label 1]</label>  
          <event>[generates event?]</event>  
          <count>2458</count>  
        </i0>  
        <i1>
          <type>[...]</type>  
          <label>[...]</label>  
          <event>[generates event?]</event>  
          <count>[...]</count>  
        </i1>  
        <i2>
          <type>[type N]</type>  
          <label>[label N]</label>  
          <event>[generates event?]</event>  
          <count>9516</count>  
        </i2>  
      </2026-04-26>  
      <[...]>
        <i0>
          <type>[type 1]</type>  
          <label>[label 1]</label>  
          <event>[generates event?]</event>  
          <count>8599</count>  
        </i0>  
        <i1>
          <type>[...]</type>  
          <label>[...]</label>  
          <event>[generates event?]</event>  
          <count>[...]</count>  
        </i1>  
        <i2>
          <type>[type N]</type>  
          <label>[label N]</label>  
          <event>[generates event?]</event>  
          <count>9725</count>  
        </i2>  
      </[...]>  
      <2026-05-26>
        <i0>
          <type>[type 1]</type>  
          <label>[label 1]</label>  
          <event>[generates event?]</event>  
          <count>8742</count>  
        </i0>  
        <i1>
          <type>[...]</type>  
          <label>[...]</label>  
          <event>[generates event?]</event>  
          <count>[...]</count>  
        </i1>  
        <i2>
          <type>[type N]</type>  
          <label>[label N]</label>  
          <event>[generates event?]</event>  
          <count>2612</count>  
        </i2>  
      </2026-05-26>  
    </by_date>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/stats/details?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_aggregate_0_type=[type 1]
result_aggregate_0_label=[label 1]
result_aggregate_0_event=[generates event?]
result_aggregate_0_count=4569
result_aggregate_1_type=[...]
result_aggregate_1_label=[...]
result_aggregate_1_event=[generates event?]
result_aggregate_1_count=[...]
result_aggregate_2_type=[type N]
result_aggregate_2_label=[label N]
result_aggregate_2_event=[generates event?]
result_aggregate_2_count=9753
result_by_date_2026-04-26_0_type=[type 1]
result_by_date_2026-04-26_0_label=[label 1]
result_by_date_2026-04-26_0_event=[generates event?]
result_by_date_2026-04-26_0_count=2458
result_by_date_2026-04-26_1_type=[...]
result_by_date_2026-04-26_1_label=[...]
result_by_date_2026-04-26_1_event=[generates event?]
result_by_date_2026-04-26_1_count=[...]
result_by_date_2026-04-26_2_type=[type N]
result_by_date_2026-04-26_2_label=[label N]
result_by_date_2026-04-26_2_event=[generates event?]
result_by_date_2026-04-26_2_count=9516
result_by_date_[...]_0_type=[type 1]
result_by_date_[...]_0_label=[label 1]
result_by_date_[...]_0_event=[generates event?]
result_by_date_[...]_0_count=8599
result_by_date_[...]_1_type=[...]
result_by_date_[...]_1_label=[...]
result_by_date_[...]_1_event=[generates event?]
result_by_date_[...]_1_count=[...]
result_by_date_[...]_2_type=[type N]
result_by_date_[...]_2_label=[label N]
result_by_date_[...]_2_event=[generates event?]
result_by_date_[...]_2_count=9725
result_by_date_2026-05-26_0_type=[type 1]
result_by_date_2026-05-26_0_label=[label 1]
result_by_date_2026-05-26_0_event=[generates event?]
result_by_date_2026-05-26_0_count=8742
result_by_date_2026-05-26_1_type=[...]
result_by_date_2026-05-26_1_label=[...]
result_by_date_2026-05-26_1_event=[generates event?]
result_by_date_2026-05-26_1_count=[...]
result_by_date_2026-05-26_2_type=[type N]
result_by_date_2026-05-26_2_label=[label N]
result_by_date_2026-05-26_2_event=[generates event?]
result_by_date_2026-05-26_2_count=2612

Example 4 (plain)

Request

https://joturl.com/a/i1/users/stats/details?format=plain

Query parameters

format = plain

Response

[type 1]
[label 1]
[generates event?]
4569
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
9753
[type 1]
[label 1]
[generates event?]
2458
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
9516
[type 1]
[label 1]
[generates event?]
8599
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
9725
[type 1]
[label 1]
[generates event?]
8742
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
2612

Optional parameters

parameter	description
time_intervalENUM	time interval for information extraction, available values: 30, 60, 90 (default: 30)

Return values

parameter	description
aggregate	aggregate view by type
by_date	view by date

/users/stats/summary

access: [READ]

Account-level summary statistics.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc

Query parameters

fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "conversions_clicks": "9",
        "conversions_clicks_diff_perc": "",
        "conversions_clicks_diff_perc14_7": "0",
        "conversions_clicks_diff_perc14_7_min_date": "",
        "conversions_clicks_diff_perc7": "0",
        "conversions_clicks_diff_perc7_min_date": "",
        "ctas_conversions": "28",
        "ctas_conversions_diff_perc": "",
        "ctas_conversions_diff_perc14_7": "0",
        "ctas_conversions_diff_perc14_7_min_date": "",
        "ctas_conversions_diff_perc7": "2",
        "ctas_conversions_diff_perc7_min_date": "2020-10-11",
        "qrcodes_clicks": "334",
        "qrcodes_clicks_diff_perc": 14,
        "qrcodes_clicks_diff_perc14_7": "1",
        "qrcodes_clicks_diff_perc14_7_min_date": "2020-10-01",
        "qrcodes_clicks_diff_perc7": "15",
        "qrcodes_clicks_diff_perc7_min_date": "2020-10-12",
        "unique_visits": "940783",
        "unique_visits_diff_perc": 1.9565,
        "unique_visits_diff_perc14_7": "23",
        "unique_visits_diff_perc14_7_min_date": "2020-09-30",
        "unique_visits_diff_perc7": "68",
        "unique_visits_diff_perc7_min_date": "2020-10-06",
        "visits": "943328",
        "visits_diff_perc": 4.16,
        "visits_diff_perc14_7": "25",
        "visits_diff_perc14_7_min_date": "2020-09-30",
        "visits_diff_perc7": "129",
        "visits_diff_perc7_min_date": "2020-10-06"
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc&format=xml

Query parameters

fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <conversions_clicks>9</conversions_clicks>  
        <conversions_clicks_diff_perc></conversions_clicks_diff_perc>  
        <conversions_clicks_diff_perc14_7>0</conversions_clicks_diff_perc14_7>  
        <conversions_clicks_diff_perc14_7_min_date></conversions_clicks_diff_perc14_7_min_date>  
        <conversions_clicks_diff_perc7>0</conversions_clicks_diff_perc7>  
        <conversions_clicks_diff_perc7_min_date></conversions_clicks_diff_perc7_min_date>  
        <ctas_conversions>28</ctas_conversions>  
        <ctas_conversions_diff_perc></ctas_conversions_diff_perc>  
        <ctas_conversions_diff_perc14_7>0</ctas_conversions_diff_perc14_7>  
        <ctas_conversions_diff_perc14_7_min_date></ctas_conversions_diff_perc14_7_min_date>  
        <ctas_conversions_diff_perc7>2</ctas_conversions_diff_perc7>  
        <ctas_conversions_diff_perc7_min_date>2020-10-11</ctas_conversions_diff_perc7_min_date>  
        <qrcodes_clicks>334</qrcodes_clicks>  
        <qrcodes_clicks_diff_perc>14</qrcodes_clicks_diff_perc>  
        <qrcodes_clicks_diff_perc14_7>1</qrcodes_clicks_diff_perc14_7>  
        <qrcodes_clicks_diff_perc14_7_min_date>2020-10-01</qrcodes_clicks_diff_perc14_7_min_date>  
        <qrcodes_clicks_diff_perc7>15</qrcodes_clicks_diff_perc7>  
        <qrcodes_clicks_diff_perc7_min_date>2020-10-12</qrcodes_clicks_diff_perc7_min_date>  
        <unique_visits>940783</unique_visits>  
        <unique_visits_diff_perc>1.9565</unique_visits_diff_perc>  
        <unique_visits_diff_perc14_7>23</unique_visits_diff_perc14_7>  
        <unique_visits_diff_perc14_7_min_date>2020-09-30</unique_visits_diff_perc14_7_min_date>  
        <unique_visits_diff_perc7>68</unique_visits_diff_perc7>  
        <unique_visits_diff_perc7_min_date>2020-10-06</unique_visits_diff_perc7_min_date>  
        <visits>943328</visits>  
        <visits_diff_perc>4.16</visits_diff_perc>  
        <visits_diff_perc14_7>25</visits_diff_perc14_7>  
        <visits_diff_perc14_7_min_date>2020-09-30</visits_diff_perc14_7_min_date>  
        <visits_diff_perc7>129</visits_diff_perc7>  
        <visits_diff_perc7_min_date>2020-10-06</visits_diff_perc7_min_date>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc&format=txt

Query parameters

fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_conversions_clicks=9
result_data_0_conversions_clicks_diff_perc=
result_data_0_conversions_clicks_diff_perc14_7=0
result_data_0_conversions_clicks_diff_perc14_7_min_date=
result_data_0_conversions_clicks_diff_perc7=0
result_data_0_conversions_clicks_diff_perc7_min_date=
result_data_0_ctas_conversions=28
result_data_0_ctas_conversions_diff_perc=
result_data_0_ctas_conversions_diff_perc14_7=0
result_data_0_ctas_conversions_diff_perc14_7_min_date=
result_data_0_ctas_conversions_diff_perc7=2
result_data_0_ctas_conversions_diff_perc7_min_date=2020-10-11
result_data_0_qrcodes_clicks=334
result_data_0_qrcodes_clicks_diff_perc=14
result_data_0_qrcodes_clicks_diff_perc14_7=1
result_data_0_qrcodes_clicks_diff_perc14_7_min_date=2020-10-01
result_data_0_qrcodes_clicks_diff_perc7=15
result_data_0_qrcodes_clicks_diff_perc7_min_date=2020-10-12
result_data_0_unique_visits=940783
result_data_0_unique_visits_diff_perc=1.9565
result_data_0_unique_visits_diff_perc14_7=23
result_data_0_unique_visits_diff_perc14_7_min_date=2020-09-30
result_data_0_unique_visits_diff_perc7=68
result_data_0_unique_visits_diff_perc7_min_date=2020-10-06
result_data_0_visits=943328
result_data_0_visits_diff_perc=4.16
result_data_0_visits_diff_perc14_7=25
result_data_0_visits_diff_perc14_7_min_date=2020-09-30
result_data_0_visits_diff_perc7=129
result_data_0_visits_diff_perc7_min_date=2020-10-06

Example 4 (plain)

Request

https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc&format=plain

Query parameters

fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
format = plain

Response

Required parameters

parameter

description

fieldsARRAY

comma separated list of fields to return, available fields: conversions_clicks, conversions_clicks_diff_perc, ctas_conversions, ctas_conversions_diff_perc, ctas_events, ctas_events_diff_perc, ctas_form_clicks, ctas_form_clicks_diff_perc, ctas_redirect_to_destination_clicks, ctas_redirect_to_destination_clicks_diff_perc, ctas_social_connect_clicks, ctas_social_connect_clicks_diff_perc, events, events_diff_perc, events_last_30days, events_last_30days_diff_perc, external_api_clicks, external_api_clicks_diff_perc, internal_api_clicks, internal_api_clicks_diff_perc, qrcodes_clicks, qrcodes_clicks_diff_perc, unique_visits, unique_visits_diff_perc, visits, visits_diff_perc

Optional parameters

parameter	description
project_idID	if passed, statistics are filtered by this project ID

Return values

parameter	description
data	array containing required statistics

Available fields and descriptions:

field	desciption
conversions_clicks	conversions generated by tracking links
conversions_clicks_diff_perc	percentage increase in conversions in the last 7 days compared to the last 14 days
ctas_conversions	CTA conversions (of any type)
ctas_conversions_diff_perc	percentage increase in CTA conversions in the last 7 days compared to the last 14 days
ctas_events	CTA views (of any type)
ctas_events_diff_perc	percentage increase in CTA views in the last 7 days compared to the last 14 days
ctas_form_clicks	CTA form conversions
ctas_form_clicks_diff_perc	percentage increase in CTA form conversions in the last 7 days compared to the last 14 days
ctas_redirect_to_destination_clicks	CTA button conversions
ctas_redirect_to_destination_clicks_diff_perc	percentage increase in CTA button conversions in the last 7 days compared to the last 14 days
ctas_social_connect_clicks	CTA Social Optin/Optin XL conversions
ctas_social_connect_clicks_diff_perc	percentage increase in CTA Social Optin/Optin XL conversions in the last 7 days compared to the last 14 days
events	generated events
events_diff_perc	percentage increase in events in the last 7 days compared to the last 14 days
events_last_30days	generated events in the last 30 days
external_api_clicks	external API calls
external_api_clicks_diff_perc	percentage increase in external API calls in the last 7 days compared to the last 14 days
internal_api_clicks	internal API calls
internal_api_clicks_diff_perc	percentage increase in internal API calls in the last 7 days compared to the last 14 days
qrcodes_clicks	visits to tracking links coming from QR code scans
qrcodes_clicks_diff_perc	percentage increase in QR code scans in the last 7 days compared to the last 14 days
unique_visits	unique visits to tracking links
unique_visits_diff_perc	percentage increase in unique visits in the last 7 days compared to the last 14 days
visits	visits to tracking links
visits_diff_perc	percentage increase in visits in the last 7 days compared to the last 14 days

All ?_diff_perc fields must be multiplied by 100 to obtain the percentage increase in the last 7 days compared to the last 14 days. An empty string as the value of these fields (which is different from a value of 0) indicates that the increment could not be extracted due to lack of data. In correspondence of each ?_diff_perc field, the following fields are generated in the output:

?_diff_perc14_7: occurrencies of the metric (e.g., visits) in the last 14 days
?_diff_perc14_7_min_date: minimum available date for the metric (e.g., visits) in the last 14 days
?_diff_perc7: occurrencies of the metric (e.g., visits) in the last 7 days
?_diff_perc7_min_date: minimum available date for the metric (e.g., visits) in the last 7 days

/users/watchdogs

/users/watchdogs/alerts

/users/watchdogs/alerts/count

access: [READ]

This method returns the number of watchdog's alerts, if any.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": "9+"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>9+</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=9+

Example 4 (plain)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/count?format=plain

Query parameters

format = plain

Response

9+

Return values

parameter	description
count	number of alerts if it is less than 10, 9+ otherwise

/users/watchdogs/alerts/reset_alerts_flag

access: [READ]

This method reset the flag that our engine uses to send emails from the watchdog, by resetting this flag no emails will be sent.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1

Example 4 (plain)

Request

https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag?format=plain

Query parameters

format = plain

Response

Return values

parameter	description
count	1 on success, 0 if the flag was already reset

/utms

/utms/add

access: [WRITE]

This method adds a new UTM template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook

Query parameters

      name = JotUrl campaign
utm_source = facebook

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "name": "JotUrl campaign",
    "utm_source": "facebook",
    "added": 1,
    "id": "73244d8770210900212ae7126696cf0d",
    "utm_medium": "",
    "utm_campaign": "",
    "utm_term": "",
    "utm_content": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook&format=xml

Query parameters

      name = JotUrl campaign
utm_source = facebook
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <name>JotUrl campaign</name>  
    <utm_source>facebook</utm_source>  
    <added>1</added>  
    <id>73244d8770210900212ae7126696cf0d</id>  
    <utm_medium></utm_medium>  
    <utm_campaign></utm_campaign>  
    <utm_term></utm_term>  
    <utm_content></utm_content>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook&format=txt

Query parameters

      name = JotUrl campaign
utm_source = facebook
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_name=JotUrl campaign
result_utm_source=facebook
result_added=1
result_id=73244d8770210900212ae7126696cf0d
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=

Example 4 (plain)

Request

https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook&format=plain

Query parameters

      name = JotUrl campaign
utm_source = facebook
    format = plain

Response

JotUrl campaign
facebook
1
73244d8770210900212ae7126696cf0d

Required parameters

parameter	description	max length
nameSTRING	UTM template name	255
utm_sourceSTRING	utm_source parameter	150

Optional parameters

parameter	description	max length
utm_campaignSTRING	utm_campaign parameter	150
utm_contentSTRING	utm_content parameter	150
utm_mediumSTRING	utm_medium parameter	150
utm_termSTRING	utm_term parameter	150

Return values

parameter	description
added	1 on success, 0 otherwise
id	ID of the UTM template
name	echo back of the name input parameter
utm_campaign	echo back of the utm_campaign input parameter
utm_content	echo back of the utm_content input parameter
utm_medium	echo back of the utm_medium input parameter
utm_source	echo back of the utm_source input parameter
utm_term	echo back of the utm_term input parameter

/utms/count

access: [READ]

This method returns the number of UTM templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/utms/count

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 8
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/utms/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>8</count>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/utms/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8

Example 4 (plain)

Request

https://joturl.com/a/i1/utms/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
searchSTRING	filters UTM templates to be extracted by searching them

Return values

parameter	description
count	the number of UTM templates

/utms/delete

access: [WRITE]

This method deletes a UTM template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/utms/delete?id=644aeb206f02120d004cb2568fb5880a

Query parameters

id = 644aeb206f02120d004cb2568fb5880a

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "deleted": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/utms/delete?id=644aeb206f02120d004cb2568fb5880a&format=xml

Query parameters

    id = 644aeb206f02120d004cb2568fb5880a
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/utms/delete?id=644aeb206f02120d004cb2568fb5880a&format=txt

Query parameters

    id = 644aeb206f02120d004cb2568fb5880a
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1

Example 4 (plain)

Request

https://joturl.com/a/i1/utms/delete?id=644aeb206f02120d004cb2568fb5880a&format=plain

Query parameters

    id = 644aeb206f02120d004cb2568fb5880a
format = plain

Response

Required parameters

parameter	description
idID	ID of the UTM templates to delete

Optional parameters

parameter	description
confirmBOOLEAN	If 1 this method deletes the UTM template even if it is linked to a tracking link

Return values

parameter	description
deleted	1 on success, 0 otherwise

/utms/edit

access: [WRITE]

This method edits a UTM template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/utms/edit?id=c056eb04caf4213771b4fff29dada0c4&name=JotUrl+campaign&utm_source=facebook

Query parameters

        id = c056eb04caf4213771b4fff29dada0c4
      name = JotUrl campaign
utm_source = facebook

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "id": "c056eb04caf4213771b4fff29dada0c4",
    "name": "JotUrl campaign",
    "utm_source": "facebook",
    "updated": 1,
    "utm_medium": "",
    "utm_campaign": "",
    "utm_term": "",
    "utm_content": ""
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/utms/edit?id=c056eb04caf4213771b4fff29dada0c4&name=JotUrl+campaign&utm_source=facebook&format=xml

Query parameters

        id = c056eb04caf4213771b4fff29dada0c4
      name = JotUrl campaign
utm_source = facebook
    format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <id>c056eb04caf4213771b4fff29dada0c4</id>  
    <name>JotUrl campaign</name>  
    <utm_source>facebook</utm_source>  
    <updated>1</updated>  
    <utm_medium></utm_medium>  
    <utm_campaign></utm_campaign>  
    <utm_term></utm_term>  
    <utm_content></utm_content>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/utms/edit?id=c056eb04caf4213771b4fff29dada0c4&name=JotUrl+campaign&utm_source=facebook&format=txt

Query parameters

        id = c056eb04caf4213771b4fff29dada0c4
      name = JotUrl campaign
utm_source = facebook
    format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_id=c056eb04caf4213771b4fff29dada0c4
result_name=JotUrl campaign
result_utm_source=facebook
result_updated=1
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=

Example 4 (plain)

Request

https://joturl.com/a/i1/utms/edit?id=c056eb04caf4213771b4fff29dada0c4&name=JotUrl+campaign&utm_source=facebook&format=plain

Query parameters

        id = c056eb04caf4213771b4fff29dada0c4
      name = JotUrl campaign
utm_source = facebook
    format = plain

Response

c056eb04caf4213771b4fff29dada0c4
JotUrl campaign
facebook
1

Required parameters

parameter	description
idID	ID of the UTM template to edit

Optional parameters

parameter	description	max length
nameSTRING	UTM template name	255
utm_campaignSTRING	utm_campaign parameter	150
utm_contentSTRING	utm_content parameter	150
utm_mediumSTRING	utm_medium parameter	150
utm_sourceSTRING	utm_source parameter	150
utm_termSTRING	utm_term parameter	150

Return values

parameter	description
id	echo back of the id input parameter
name	echo back of the name input parameter
updated	1 on success, 0 otherwise
utm_campaign	echo back of the utm_campaign input parameter
utm_content	echo back of the utm_content input parameter
utm_medium	echo back of the utm_medium input parameter
utm_source	echo back of the utm_source input parameter
utm_term	echo back of the utm_term input parameter

/utms/info

access: [READ]

This method returns info about a UTM template.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=44a41df2e0a273564cc83b8a9fd1a0a6

Query parameters

 fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = 44a41df2e0a273564cc83b8a9fd1a0a6

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "data": [
      {
        "id": "44a41df2e0a273564cc83b8a9fd1a0a6",
        "name": "JotUrl campaign",
        "utm_source": "facebook",
        "utm_medium": "",
        "utm_campaign": "",
        "utm_term": "",
        "utm_content": ""
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=44a41df2e0a273564cc83b8a9fd1a0a6&format=xml

Query parameters

 fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = 44a41df2e0a273564cc83b8a9fd1a0a6
 format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <data>
      <i0>
        <id>44a41df2e0a273564cc83b8a9fd1a0a6</id>  
        <name>JotUrl campaign</name>  
        <utm_source>facebook</utm_source>  
        <utm_medium></utm_medium>  
        <utm_campaign></utm_campaign>  
        <utm_term></utm_term>  
        <utm_content></utm_content>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=44a41df2e0a273564cc83b8a9fd1a0a6&format=txt

Query parameters

 fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = 44a41df2e0a273564cc83b8a9fd1a0a6
 format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=44a41df2e0a273564cc83b8a9fd1a0a6
result_data_0_name=JotUrl campaign
result_data_0_utm_source=facebook
result_data_0_utm_medium=
result_data_0_utm_campaign=
result_data_0_utm_term=
result_data_0_utm_content=

Example 4 (plain)

Request

https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=44a41df2e0a273564cc83b8a9fd1a0a6&format=plain

Query parameters

 fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = 44a41df2e0a273564cc83b8a9fd1a0a6
 format = plain

Response

44a41df2e0a273564cc83b8a9fd1a0a6
JotUrl campaign
facebook

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, name, utm_campaign, utm_content, utm_medium, utm_source, utm_term
idID	ID of the UTM template

Return values

parameter	description
data	array containing information on the UTM templates, returned information depends on the fields input parameter.

/utms/list

access: [READ]

This method returns a list of UTM templates.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term

Query parameters

fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "count": 1,
    "data": [
      {
        "id": "52f6bc2d36b9c71a09c9935f479bfc8a",
        "name": "JotUrl campaign",
        "utm_source": "facebook",
        "utm_medium": "",
        "utm_campaign": "",
        "utm_term": "",
        "utm_content": ""
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&format=xml

Query parameters

fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <count>1</count>  
    <data>
      <i0>
        <id>52f6bc2d36b9c71a09c9935f479bfc8a</id>  
        <name>JotUrl campaign</name>  
        <utm_source>facebook</utm_source>  
        <utm_medium></utm_medium>  
        <utm_campaign></utm_campaign>  
        <utm_term></utm_term>  
        <utm_content></utm_content>  
      </i0>  
    </data>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&format=txt

Query parameters

fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=52f6bc2d36b9c71a09c9935f479bfc8a
result_data_0_name=JotUrl campaign
result_data_0_utm_source=facebook
result_data_0_utm_medium=
result_data_0_utm_campaign=
result_data_0_utm_term=
result_data_0_utm_content=

Example 4 (plain)

Request

https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&format=plain

Query parameters

fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
format = plain

Response

1
52f6bc2d36b9c71a09c9935f479bfc8a
JotUrl campaign
facebook

Required parameters

parameter	description
fieldsARRAY	comma-separated list of fields to return, available fields: count, id, name, utm_campaign, utm_content, utm_medium, utm_source, utm_term

Optional parameters

parameter	description
lengthINTEGER	extracts this number of UTM templates (maxmimum allowed: 100)
orderbyARRAY	orders UTM templates by field, available fields: id, name, utm_campaign, utm_content, utm_medium, utm_source, utm_term
searchSTRING	filters UTM templates to be extracted by searching them
sortSTRING	sorts UTM templates in ascending (ASC) or descending (DESC) order
startINTEGER	starts to extract UTM templates from this position

Return values

parameter	description
count	[OPTIONAL] total number of UTM templates, returned only if count is passed in fields
data	array containing information on the UTM templates, returned information depends on the fields input parameter.

/watchdogs

/watchdogs/clone

access: [WRITE]

Clone the qrcodes configuration from a tracking link to another.

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/watchdogs/clone?from_url_id=360842977c450a39383408da7049a555&to_url_id=c1a316027b1e86d385556dc615c057fd

Query parameters

from_url_id = 360842977c450a39383408da7049a555
  to_url_id = c1a316027b1e86d385556dc615c057fd

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "cloned": 1
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/watchdogs/clone?from_url_id=360842977c450a39383408da7049a555&to_url_id=c1a316027b1e86d385556dc615c057fd&format=xml

Query parameters

from_url_id = 360842977c450a39383408da7049a555
  to_url_id = c1a316027b1e86d385556dc615c057fd
     format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <cloned>1</cloned>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/watchdogs/clone?from_url_id=360842977c450a39383408da7049a555&to_url_id=c1a316027b1e86d385556dc615c057fd&format=txt

Query parameters

from_url_id = 360842977c450a39383408da7049a555
  to_url_id = c1a316027b1e86d385556dc615c057fd
     format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1

Example 4 (plain)

Request

https://joturl.com/a/i1/watchdogs/clone?from_url_id=360842977c450a39383408da7049a555&to_url_id=c1a316027b1e86d385556dc615c057fd&format=plain

Query parameters

from_url_id = 360842977c450a39383408da7049a555
  to_url_id = c1a316027b1e86d385556dc615c057fd
     format = plain

Response

Required parameters

parameter	description
from_url_idID	ID of the tracking link you want to copy watchdog configuration from
to_url_idID	ID of the tracking link you want to copy watchdog configuration to

Return values

parameter	description
cloned	1 on success, 0 otherwise

/watchdogs/property

access: [READ]

This method returns a list of properties of the watchdog (content monitoring).

Example 1 (json)Example 2 (xml)Example 3 (txt)Example 4 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/watchdogs/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": "",
    "rate": 0
  },
  "result": {
    "watchdogs": [
      {
        "type": "1D",
        "title": "1 check per day",
        "limit": 1800
      }
    ],
    "spiders": [
      {
        "id": "DISABLE_ALL",
        "title": "Disable all spiders. No check will be performed.",
        "short": "Disable ALL",
        "params": {
          "video": 0,
          "time": 0,
          "texts": 0,
          "threshold": 0
        }
      },
      {
        "id": "AUTOMATIC",
        "title": "The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.",
        "short": "Automatic",
        "params": {
          "video": 0,
          "time": 0,
          "texts": 0,
          "threshold": 0
        }
      },
      {
        "id": "HTML_PING",
        "title": "Interrupted and redirected URL check (PING.)",
        "short": "PING",
        "params": {
          "video": 1,
          "time": 1,
          "texts": 0,
          "threshold": 0
        }
      },
      {
        "id": "HTML_TITLE_H1",
        "title": "Checks for interrupted or redirected URLs and changes in title and\/or h1 tag of the page.",
        "short": "TITLE and H1",
        "params": {
          "video": 1,
          "time": 1,
          "texts": 0,
          "threshold": 0
        }
      },
      {
        "id": "HTML_TEXTS",
        "title": "Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)",
        "short": "TEXT of the PAGE",
        "params": {
          "video": 1,
          "time": 1,
          "texts": 1,
          "threshold": 0
        }
      },
      {
        "id": "HTML_ALL",
        "title": "Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)",
        "short": "WHOLE PAGE",
        "params": {
          "video": 1,
          "time": 1,
          "texts": 1,
          "threshold": 0
        }
      },
      {
        "id": "HTML_BLOCKS",
        "title": "Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.",
        "short": "DATA MINING",
        "params": {
          "video": 1,
          "time": 1,
          "texts": 0,
          "threshold": 1
        }
      },
      {
        "id": "HTML_DISABLED",
        "title": "Only the video spider will be activated (spider HTML will be disabled.)",
        "short": "HTML disabled",
        "params": {
          "video": 0,
          "time": 0,
          "texts": 0,
          "threshold": 0
        }
      }
    ],
    "frequencies": [
      {
        "label": "do_not_send",
        "value": ""
      },
      {
        "label": "immediately",
        "value": 0
      },
      {
        "label": "day",
        "value": 1
      },
      {
        "label": "day",
        "value": 3
      },
      {
        "label": "day",
        "value": 7
      },
      {
        "label": "day",
        "value": 15
      },
      {
        "label": "day",
        "value": 30
      }
    ]
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/watchdogs/property?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
    <error></error>  
    <rate>0</rate>  
  </status>  
  <result>
    <watchdogs>
      <i0>
        <type>1D</type>  
        <title>1 check per day</title>  
        <limit>1800</limit>  
      </i0>  
    </watchdogs>  
    <spiders>
      <i0>
        <id>DISABLE_ALL</id>  
        <title>Disable all spiders. No check will be performed.</title>  
        <short>Disable ALL</short>  
        <params>
          <video>0</video>  
          <time>0</time>  
          <texts>0</texts>  
          <threshold>0</threshold>  
        </params>  
      </i0>  
      <i1>
        <id>AUTOMATIC</id>  
        <title>The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.</title>  
        <short>Automatic</short>  
        <params>
          <video>0</video>  
          <time>0</time>  
          <texts>0</texts>  
          <threshold>0</threshold>  
        </params>  
      </i1>  
      <i2>
        <id>HTML_PING</id>  
        <title>Interrupted and redirected URL check (PING.)</title>  
        <short>PING</short>  
        <params>
          <video>1</video>  
          <time>1</time>  
          <texts>0</texts>  
          <threshold>0</threshold>  
        </params>  
      </i2>  
      <i3>
        <id>HTML_TITLE_H1</id>  
        <title>Checks for interrupted or redirected URLs and changes in title and/or h1 tag of the page.</title>  
        <short>TITLE and H1</short>  
        <params>
          <video>1</video>  
          <time>1</time>  
          <texts>0</texts>  
          <threshold>0</threshold>  
        </params>  
      </i3>  
      <i4>
        <id>HTML_TEXTS</id>  
        <title>Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)</title>  
        <short>TEXT of the PAGE</short>  
        <params>
          <video>1</video>  
          <time>1</time>  
          <texts>1</texts>  
          <threshold>0</threshold>  
        </params>  
      </i4>  
      <i5>
        <id>HTML_ALL</id>  
        <title>Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)</title>  
        <short>WHOLE PAGE</short>  
        <params>
          <video>1</video>  
          <time>1</time>  
          <texts>1</texts>  
          <threshold>0</threshold>  
        </params>  
      </i5>  
      <i6>
        <id>HTML_BLOCKS</id>  
        <title>Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.</title>  
        <short>DATA MINING</short>  
        <params>
          <video>1</video>  
          <time>1</time>  
          <texts>0</texts>  
          <threshold>1</threshold>  
        </params>  
      </i6>  
      <i7>
        <id>HTML_DISABLED</id>  
        <title>Only the video spider will be activated (spider HTML will be disabled.)</title>  
        <short>HTML disabled</short>  
        <params>
          <video>0</video>  
          <time>0</time>  
          <texts>0</texts>  
          <threshold>0</threshold>  
        </params>  
      </i7>  
    </spiders>  
    <frequencies>
      <i0>
        <label>do_not_send</label>  
        <value></value>  
      </i0>  
      <i1>
        <label>immediately</label>  
        <value>0</value>  
      </i1>  
      <i2>
        <label>day</label>  
        <value>1</value>  
      </i2>  
      <i3>
        <label>day</label>  
        <value>3</value>  
      </i3>  
      <i4>
        <label>day</label>  
        <value>7</value>  
      </i4>  
      <i5>
        <label>day</label>  
        <value>15</value>  
      </i5>  
      <i6>
        <label>day</label>  
        <value>30</value>  
      </i6>  
    </frequencies>  
  </result>  
</response>

Example 3 (txt)

Request

https://joturl.com/a/i1/watchdogs/property?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
status_error=
status_rate=0
result_watchdogs_0_type=1D
result_watchdogs_0_title=1 check per day
result_watchdogs_0_limit=1800
result_spiders_0_id=DISABLE_ALL
result_spiders_0_title=Disable all spiders. No check will be performed.
result_spiders_0_short=Disable ALL
result_spiders_0_params_video=0
result_spiders_0_params_time=0
result_spiders_0_params_texts=0
result_spiders_0_params_threshold=0
result_spiders_1_id=AUTOMATIC
result_spiders_1_title=The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.
result_spiders_1_short=Automatic
result_spiders_1_params_video=0
result_spiders_1_params_time=0
result_spiders_1_params_texts=0
result_spiders_1_params_threshold=0
result_spiders_2_id=HTML_PING
result_spiders_2_title=Interrupted and redirected URL check (PING.)
result_spiders_2_short=PING
result_spiders_2_params_video=1
result_spiders_2_params_time=1
result_spiders_2_params_texts=0
result_spiders_2_params_threshold=0
result_spiders_3_id=HTML_TITLE_H1
result_spiders_3_title=Checks for interrupted or redirected URLs and changes in title and/or h1 tag of the page.
result_spiders_3_short=TITLE and H1
result_spiders_3_params_video=1
result_spiders_3_params_time=1
result_spiders_3_params_texts=0
result_spiders_3_params_threshold=0
result_spiders_4_id=HTML_TEXTS
result_spiders_4_title=Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)
result_spiders_4_short=TEXT of the PAGE
result_spiders_4_params_video=1
result_spiders_4_params_time=1
result_spiders_4_params_texts=1
result_spiders_4_params_threshold=0
result_spiders_5_id=HTML_ALL
result_spiders_5_title=Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)
result_spiders_5_short=WHOLE PAGE
result_spiders_5_params_video=1
result_spiders_5_params_time=1
result_spiders_5_params_texts=1
result_spiders_5_params_threshold=0
result_spiders_6_id=HTML_BLOCKS
result_spiders_6_title=Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.
result_spiders_6_short=DATA MINING
result_spiders_6_params_video=1
result_spiders_6_params_time=1
result_spiders_6_params_texts=0
result_spiders_6_params_threshold=1
result_spiders_7_id=HTML_DISABLED
result_spiders_7_title=Only the video spider will be activated (spider HTML will be disabled.)
result_spiders_7_short=HTML disabled
result_spiders_7_params_video=0
result_spiders_7_params_time=0
result_spiders_7_params_texts=0
result_spiders_7_params_threshold=0
result_frequencies_0_label=do_not_send
result_frequencies_0_value=
result_frequencies_1_label=immediately
result_frequencies_1_value=0
result_frequencies_2_label=day
result_frequencies_2_value=1
result_frequencies_3_label=day
result_frequencies_3_value=3
result_frequencies_4_label=day
result_frequencies_4_value=7
result_frequencies_5_label=day
result_frequencies_5_value=15
result_frequencies_6_label=day
result_frequencies_6_value=30

Example 4 (plain)

Request

https://joturl.com/a/i1/watchdogs/property?format=plain

Query parameters

format = plain

Response

1D
1 check per day
1800
DISABLE_ALL
Disable all spiders. No check will be performed.
Disable ALL
0
0
0
0
AUTOMATIC
The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.
Automatic
0
0
0
0
HTML_PING
Interrupted and redirected URL check (PING.)
PING
1
1
0
0
HTML_TITLE_H1
Checks for interrupted or redirected URLs and changes in title and/or h1 tag of the page.
TITLE and H1
1
1
0
0
HTML_TEXTS
Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)
TEXT of the PAGE
1
1
1
0
HTML_ALL
Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)
WHOLE PAGE
1
1
1
0
HTML_BLOCKS
Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.
DATA MINING
1
1
0
1
HTML_DISABLED
Only the video spider will be activated (spider HTML will be disabled.)
HTML disabled
0
0
0
0
do_not_send

immediately
0
day
1
day
3
day
7
day
15
day
30

Return values

parameter	description
frequencies	list of frequencies available to the logged user
spiders	list of spiders available to the logged user
watchdogs	list of watchdogs available to the logged user

API reference (beta)

/ctas

/ctas/add

access: [WRITE]

Add a call to action template for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/add?name=calltoactionname&type=button&brand_id=1234abcde

Query parameters

    name = calltoactionname
    type = button
brand_id = 1234abcde

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
    "name": "name"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/add?format=xml&name=calltoactionname&type=button&brand_id=1234abcde

Query parameters

  format = xml
    name = calltoactionname
    type = button
brand_id = 1234abcde

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>  
    <name>name</name>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/ctas/add?format=plain&name=calltoactionname&type=button&brand_id=1234abcde

Query parameters

  format = plain
    name = calltoactionname
    type = button
brand_id = 1234abcde

Response

65794b5563376a7a354f6c756b42625946636d2f47773d3d
name

Required parameters

parameter	description
name	name of the call to action
type	type of the call to action, for a complete list of types see the method i1/ctas/property

Optional parameters

parameter	description
brand_id	ID of the desired brand
params	parameters of the call to action, for a complete list of parameters see the method i1/ctas/property

Return values

parameter	description
date	NA
id	ID of the call to action
name	name of the call to action
type	type of the call to action, for a complete list of types see the method i1/ctas/property

/ctas/edit

access: [WRITE]

Edit a call to action template for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/edit?id=1234abc&name=calltoactionname&type=button&brand_id=1234abcde

Query parameters

      id = 1234abc
    name = calltoactionname
    type = button
brand_id = 1234abcde

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
    "name": "name"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/ctas/edit?id=1234abc&name=calltoactionname&type=button&brand_id=1234abcde

Query parameters

      id = 1234abc
    name = calltoactionname
    type = button
brand_id = 1234abcde

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>  
    <name>name</name>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/ctas/edit?id=1234abc&name=calltoactionname&type=button&brand_id=1234abcde

Query parameters

      id = 1234abc
    name = calltoactionname
    type = button
brand_id = 1234abcde

Response

65794b5563376a7a354f6c756b42625946636d2f47773d3d
name

Required parameters

parameter	description
id	ID of the call to action

Optional parameters

parameter	description
brand_id	ID of the desired brand
name	name of the call to action
params	parameters of the call to action, for a complete list of parameters see the method i1/ctas/property
type	type of the call to action, for a complete list of types see the method i1/ctas/property

Return values

parameter	description
id	ID of the call to action
name	name of the call to action

/ctas/info

access: [READ]

This method returns information specified in a comma separated input called fields about a cta

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/ctas/info?format=xml&id=123456&fields=name,type

Query parameters

format = xml
    id = 123456
fields = name,type

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result></result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/ctas/info?format=txt&id=123456&fields=name,type

Query parameters

format = txt
    id = 123456
fields = name,type

Response

status_code=200
status_text=OK
result=

Example 3 (plain)

Request

https://joturl.com/a/i1/ctas/info?format=plain&id=123456&fields=name,type

Query parameters

format = plain
    id = 123456
fields = name,type

Response

Required parameters

parameter	description
fields	comma separated list of CTA fields [id,type,name,brand_id,params,clicks,conversions]
id	ID of the call to action

Return values

parameter	description
data	NA

/ctas/list

access: [READ]

This method returns a list of user's call to action data, specified in a comma separated input called fields.

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/ctas/list?format=xml&fields=name,id

Query parameters

format = xml
fields = name,id

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <item0>
      <id>1a2b3c4d123456</id>  
      <name>conversion name</name>  
    </item0>  
    <item1>
      <id>1a2b3c4d123456</id>  
      <name>call to action name</name>  
    </item1>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/ctas/list?format=txt&fields=name,id

Query parameters

format = txt
fields = name,id

Response

status_code=200
status_text=OK
result_item0_id=1a2b3c4d123456
result_item0_name=conversion name
result_item1_id=1a2b3c4d123456
result_item1_name=call to action name

Example 3 (plain)

Request

https://joturl.com/a/i1/ctas/list?format=plain&fields=name,id

Query parameters

format = plain
fields = name,id

Response

1a2b3c4d123456
conversion name
1a2b3c4d123456
call to action name

Required parameters

parameter	description
fields	comma separated list of CTA fields [id,type,name,brand_id,params,clicks,conversions,count,performance]. You can use the special field count to retrieve the number of call to actions

Optional parameters

parameter	description
length	number of items to be extracted
orderby	order items by one field [id,type,name,brand_id,params,clicks,conversions,count,performance]. You can use the special field performance to order call to actions by performance. Use sort for ascending or descending order. Default is `orderby = id`
search	filter items by searching them
sort	to be used in conjunction with orderby to select the ascending or descending order [ASC\|DESC]. Default is `sort = ASC`
start	index from which the list will be extracted
types	comma separated list of types to be extracted

Return values

parameter	description
data	NA

/ctas/preview

access: [READ]

This method returns an html preview of a cta, using custom parameters or using an existing call to action

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/ctas/preview?format=xml&id=123456

Query parameters

format = xml
    id = 123456

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result><[CDATA[<html><head>[...]</head><body>[...]</body></html>]]></result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/ctas/preview?format=txt&id=123456

Query parameters

format = txt
    id = 123456

Response

status_code=200
status_text=OK
result=[...][...]

Example 3 (plain)

Request

https://joturl.com/a/i1/ctas/preview?format=plain&id=123456

Query parameters

format = plain
    id = 123456

Response

Optional parameters

parameter	description
id	ID of the call to action
params	parameters of the call to action, for a complete list of parameters see the method i1/ctas/property

Return values

parameter	description
html	NA

/ctas/privatekey

access: [READ]

This method returns the user's private key.

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/privatekey

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": ""
  },
  "result": {
    "privatekey": "01234567890123456789"
  }
}

Return values

parameter	description
privatekey	NA

/ctas/property

access: [READ]

This method returns a list of property of a call to action with detailed information on them.

Example 1 (json)Example 2 (json)

Example 1 (json)

Request

https://joturl.com/a/i1/ctas/property

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": ""
  },
  "result": {
    "label": "Tipo Call to Action",
    "types": {
      "appsnip": {
        "label": "App Snip"
      },
      "banner": {
        "label": "Banner"
      },
      "button": {
        "label": "Bottone"
      },
      "form": {
        "label": "Form"
      },
      "socialconnect": {
        "label": "Connessione ai Social Network"
      },
      "textlink": {
        "label": "Text Link"
      }
    }
  }
}

Example 2 (json)

Request

https://joturl.com/a/i1/ctas/property?types=form

Query parameters

types = form

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": ""
  },
  "result": {
    "label": "Call to Action type",
    "types": {
      "form": {
        "label": "Form",
        "base": {
          "name": {
            "type": "text",
            "label": "Template name"
          },
          "type": {
            "type": "text",
            "label": "Call to action\u2019s type"
          },
          "brand_id": {
            "type": "text",
            "label": "User brand identifier for a call to action"
          },
          "one_time_code_validity": {
            "type": "select",
            "label": "Period of validity of the one-time code",
            "options": [
              {
                "value": "10",
                "label": "10 minutes"
              },
              {
                "value": "20",
                "label": "20 minutes"
              },
              {
                "value": "30",
                "label": "30 minutes"
              }
            ]
          },
          "one_time_code_private_key": {
            "type": "label",
            "label": "Private key"
          }
        },
        "design": {
          "bgcolor": {
            "type": "selectcolor",
            "label": "Background color",
            "mandatory": 1
          },
          "txtcolor": {
            "type": "selectcolor",
            "label": "Text color",
            "mandatory": 1
          },
          "btncolor": {
            "type": "selectcolor",
            "label": "Button color",
            "mandatory": 1
          },
          "lnktxtcolor": {
            "type": "selectcolor",
            "label": "Link text color",
            "mandatory": 1
          },
          "position": {
            "type": "select",
            "label": "Position",
            "mandatory": 1,
            "options": [
              {
                "value": "bottom-left",
                "label": "Bottom left"
              },
              {
                "value": "bottom-right",
                "label": "Bottom right"
              }
            ]
          },
          "shape": {
            "type": "select",
            "label": "Modules appearance",
            "mandatory": 1,
            "options": [
              {
                "value": "social",
                "label": "Social"
              },
              {
                "value": "fullwidth",
                "label": "Full width"
              }
            ]
          }
        },
        "content": {
          "customized_message": {
            "type": "text",
            "label": "Customized message",
            "mandatory": 1
          },
          "placeholder_text": {
            "type": "text",
            "label": "Insert a message",
            "mandatory": 1
          },
          "destination_url": {
            "type": "text",
            "label": "Destination URL",
            "mandatory": 1
          }
        }
      }
    }
  }
}

Optional parameters

parameter	description
types	comma separated list of possible types. If not specified the method returns accepted types, otherwise it returns detailed information on the requested types. Types can be ALL to get detailed information on all types

Return values

parameter	description
data	NA

/ctas/snip

access: [READ]

This method returns the actual snip for CTAs

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/ctas/snip?format=xml&id=123456

Query parameters

format = xml
    id = 123456

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result><[CDATA[<html><head>[...]</head><body>[...]</body></html>]]></result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/ctas/snip?format=txt&id=123456

Query parameters

format = txt
    id = 123456

Response

status_code=200
status_text=OK
result=[...][...]

Example 3 (plain)

Request

https://joturl.com/a/i1/ctas/snip?format=plain&id=123456

Query parameters

format = plain
    id = 123456

Response

Optional parameters

parameter	description
id	ID of the call to action
params	parameters of the call to action, for a complete list of parameters see the method i1/ctas/property

Return values

parameter	description
html	NA

/resources

/resources/add

access: [WRITE]

This method allows to upload a resource

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/resources/add?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/resources/add?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK

Example 3 (plain)

Request

https://joturl.com/a/i1/resources/add?format=plain

Query parameters

format = plain

Response

200
OK

Required parameters

parameter	description
context	context of the upload
input	the name of the form field used to transfer resource's data
upload_type	Type of the upload. Available types: images,ssl

Return values

parameter	description
id	NA
name	name of the resource
type	type of the resource
url	complete URL of the resource

/resources/count

access: [READ]

This method returns number of resources of a specific upload_type in a context

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/resources/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <count>362</count>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/resources/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
result_count=362

Example 3 (plain)

Request

https://joturl.com/a/i1/resources/count?format=plain

Query parameters

format = plain

Response

Required parameters

parameter	description
context	context of the upload
upload_type	Type of the upload. Available types: images,ssl

Return values

parameter	description
count	number of resources

/resources/delete

access: [WRITE]

This method deletes a resource

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/resources/delete?format=xml&id=1234567890

Query parameters

format = xml
    id = 1234567890

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <count>1</count>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/resources/delete?format=txtresource_id=1234567890

Query parameters

format = txtresource_id=1234567890

Response

status_code=200
status_text=OK
result_count=1

Example 3 (plain)

Request

https://joturl.com/a/i1/resources/delete?format=plainresource_id=1234567890

Query parameters

format = plainresource_id=1234567890

Response

Required parameters

parameter	description
context	context of the upload
ids	IDs of the resources to be deleted
upload_type	Type of the upload. Available types: images,ssl

Return values

parameter	description
count	number of deleted resources

/resources/edit

access: [WRITE]

This method allows to edit a resource

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/resources/edit?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/resources/edit?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK

Example 3 (plain)

Request

https://joturl.com/a/i1/resources/edit?format=plain

Query parameters

format = plain

Response

200
OK

Required parameters

parameter	description
context	context of the upload
id	ID of the resource
input	the name of the form field used to transfer resource's data
upload_type	Type of the upload. Available types: images,ssl

Return values

parameter	description
id	NA
name	name of the resource
type	type of the resource
url	complete URL of the resource

/resources/info

access: [READ]

This method returns information specified in a comma separated input called fields about a resource

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/resources/info?format=xml&id=123456&fields=name,url

Query parameters

format = xml
    id = 123456
fields = name,url

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>

  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/resources/info?format=txt&iresource_id=123456&fields=name,url

Query parameters

      format = txt
iresource_id = 123456
      fields = name,url

Response

status_code=200
status_text=OK
result=

Example 3 (plain)

Request

https://joturl.com/a/i1/resources/info?format=plain&id=123456&fields=name,url

Query parameters

format = plain
    id = 123456
fields = name,url

Response

Required parameters

parameter	description
context	context of the upload
fields	comma separated list of resources fields [id,name,url,type,context,date]
id	ID of the resource
upload_type	Type of the upload. Available types: images,ssl

Return values

parameter	description
data	parameters specified in fields of the resource

/resources/list

access: [READ]

This method returns a list of resource of a specific upload_type in a context

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/resources/list?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/resources/list?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK

Example 3 (plain)

Request

https://joturl.com/a/i1/resources/list?format=plain

Query parameters

format = plain

Response

200
OK

Required parameters

parameter	description
context	context of the upload
fields	comma separated list of resources fields [id,name,url,type,context,date,count]. You can use the special field count to retrieve the number of resources
upload_type	Type of the upload. Available types: images,ssl

Optional parameters

parameter	description
length	number of items to be extracted
start	index from which the list will be extracted

Return values

parameter	description
count	number of resources
data	array (id,name,url,type) of resources

/urls

/urls/instaurls

/urls/instaurls/edit

access: [WRITE]

Set InstaUrl settings for a tracking link.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/edit?mp_url_id=12345

Query parameters

mp_url_id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Required parameters

parameter	description
id	NA
settings	NA

Return values

parameter	description
enabled	NA

/urls/instaurls/info

access: [READ]

Get settings for the InstaUrl option.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/info?mp_url_id=12345

Query parameters

mp_url_id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Required parameters

parameter	description
id	NA

Return values

parameter	description
settings	NA

/urls/instaurls/preview

access: [READ]

Given parameters, this method returns the HTML of an InstaUrl page.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/preview?mp_url_id=12345

Query parameters

mp_url_id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Optional parameters

parameter	description
settings	NA

Return values

parameter	description
html	NA

/urls/instaurls/property

access: [READ]

Returns the list of available properties for the InstaUrl option.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/instaurls/property?mp_url_id=12345

Query parameters

mp_url_id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Return values

parameter	description
avatar	NA
background	NA
css	NA
fonts	NA
icons	NA
links	NA
max_items	NA
messengers	NA
social_networks	NA
themes	NA

/urls/minipages

/urls/minipages/edit

access: [WRITE]

Set a minipage for a tracking link.

Required parameters

parameter	description
id	NA

Optional parameters

parameter	description
params	NA
template	NA
template_name	NA

Return values

parameter	description
added	NA

/urls/minipages/info

access: [READ]

Get the minipage linked to a tracking link.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/minipages/info?id=12345

Query parameters

id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Required parameters

parameter	description
id	NA

Return values

parameter	description
data	NA

/urls/minipages/preview

access: [READ]

Given a template and parameters, this method returns the HTML.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/minipages/preview?id=12345

Query parameters

id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Optional parameters

parameter	description
id	NA
params	NA
template	NA
template_name	NA

Return values

parameter	description
html	NA

/urls/minipages/property

access: [READ]

Returns the list of available minipage templates and their properties.

Example 1 (json)

Request

https://joturl.com/a/i1/urls/minipages/property?id=12345

Query parameters

id = 12345

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": []
}

Return values

parameter	description
data	NA

/users

/users/brands

/users/brands/add

access: [WRITE]

Add a user brand for the user logged in.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/brands/adduser_brand_name=brandname&url_home=http://www.joturl.com

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
    "name": "name"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/brands/add?format=xml&name=brandname&url_home=http://www.joturl.com

Query parameters

  format = xml
    name = brandname
url_home = http://www.joturl.com

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>  
    <name>name</name>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/users/brands/add?format=plain&name=brandname&url_home=http://www.joturl.com

Query parameters

  format = plain
    name = brandname
url_home = http://www.joturl.com

Response

65794b5563376a7a354f6c756b42625946636d2f47773d3d
name

Required parameters

parameter	description
input	the name of the form field used to transfer brand's logo

Optional parameters

parameter	description
name	name of the brand
url_home	URL of the brand's home

Return values

parameter	description
id	ID of the brand
name	name of the brand
url	complete URL of the logo image
url_home	URL of the brand's home

/users/brands/count

access: [READ]

This method returns the number of user brand's related to the call to actions

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/users/brands/count?format=xml

Query parameters

format = xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <count>849</count>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/users/brands/count?format=txt

Query parameters

format = txt

Response

status_code=200
status_text=OK
result_count=849

Example 3 (plain)

Request

https://joturl.com/a/i1/users/brands/count?format=plain

Query parameters

format = plain

Response

Optional parameters

parameter	description
search	filter items by searching them

Return values

parameter	description
count	number of brands

/users/brands/delete

access: [WRITE]

This method deletes a user brand using the ids . Return 1 if the operation succeeds or 0 otherwise

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/users/brands/delete?format=xml&ids=12345abcdef6789,2345abcdef

Query parameters

format = xml
   ids = 12345abcdef6789,2345abcdef

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <deleted>1</deleted>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/users/brands/delete?format=txt&ids=12345abcdef6789,2345abcdef

Query parameters

format = txt
   ids = 12345abcdef6789,2345abcdef

Response

status_code=200
status_text=OK
result_deleted=1

Example 3 (plain)

Request

https://joturl.com/a/i1/users/brands/delete?format=plain&ids=12345abcdef6789,2345abcdef

Query parameters

format = plain
   ids = 12345abcdef6789,2345abcdef

Response

Required parameters

parameter	description
ids	IDs of the brands to be deleted

Return values

parameter	description
deleted	number of deleted brands

/users/brands/edit

access: [WRITE]

Edit fields of a user brand.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/users/brands/edit?id=123456a&name=newname

Query parameters

  id = 123456a
name = newname

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
    "name": "name"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/users/brands/edit?format=xml&id=123456a&name=newname

Query parameters

format = xml
    id = 123456a
  name = newname

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>  
    <name>name</name>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/users/brands/edit?format=plain&id=123456a&name=newname

Query parameters

format = plain
    id = 123456a
  name = newname

Response

65794b5563376a7a354f6c756b42625946636d2f47773d3d
name

Required parameters

parameter	description
id	ID of the brand

Optional parameters

parameter	description
input	the name of the form field used to transfer brand's logo
name	name of the brand
url_home	URL of the brand's home

Return values

parameter	description
id	ID of the brand
name	name of the brand
url_home	URL of the brand's home

/users/brands/info

access: [READ]

This method returns information specified in a comma separated input called fields about a user brand

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/users/brands/info?format=xml&id=123456&fields=name,url_home

Query parameters

format = xml
    id = 123456
fields = name,url_home

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>  
    <name>name</name>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/users/brands/info?format=txt&id=123456&fields=name,url_home

Query parameters

format = txt
    id = 123456
fields = name,url_home

Response

status_code=200
status_text=OK
result_id=65794b5563376a7a354f6c756b42625946636d2f47773d3d
result_name=name

Example 3 (plain)

Request

https://joturl.com/a/i1/users/brands/info?format=plain&id=123456&fields=name,url_home

Query parameters

format = plain
    id = 123456
fields = name,url_home

Response

65794b5563376a7a354f6c756b42625946636d2f47773d3d
name

Required parameters

parameter	description
fields	comma separated list of fields [id,name,url_home,url,res_id,res_name,context,type,date,count]

Optional parameters

parameter	description
id	ID of the brand
res_id	NA

Return values

parameter	description
data	required fields (id,name,url_home,url,res_id,res_name,context,type,date) of the brand

/users/brands/list

access: [READ]

This method returns a list of user's brands data, specified in a comma separated input called fields.

Example 1 (xml)Example 2 (txt)Example 3 (plain)

Example 1 (xml)

Request

https://joturl.com/a/i1/users/brands/list?format=xml&fields=name,url_home

Query parameters

format = xml
fields = name,url_home

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <item0>
      <id>1a2b3c4d123456</id>  
      <name>brand name</name>  
    </item0>  
    <item1>
      <id>1a2b3c4d123456</id>  
      <name>brand name</name>  
    </item1>  
  </result>  
</response>

Example 2 (txt)

Request

https://joturl.com/a/i1/users/brands/list?format=txt&fields=name,url_home

Query parameters

format = txt
fields = name,url_home

Response

status_code=200
status_text=OK
result_item0_id=1a2b3c4d123456
result_item0_name=brand name
result_item1_id=1a2b3c4d123456
result_item1_name=brand name

Example 3 (plain)

Request

https://joturl.com/a/i1/users/brands/list?format=plain&fields=name,url_home

Query parameters

format = plain
fields = name,url_home

Response

1a2b3c4d123456
brand name
1a2b3c4d123456
brand name

Required parameters

parameter	description
fields	comma separated list of fields [id,name,url_home,url,res_id,res_name,context,type,date,count]. You can use the special field count to retrieve the number of resources

Optional parameters

parameter	description
length	number of items to be extracted
orderby	order items by one field [id,name,url_home,url,res_id,res_name,context,type,date,count]. Use sort for ascending or descending order. Default is `orderby = id`
search	filter items by searching them
sort	to be used in conjunction with orderby to select the ascending or descending order [ASC\|DESC]. Default is `sort = ASC`
start	index from which the list will be extracted

Return values

parameter	description
count	number of brands
data	array (id,name,url_home,url,res_id,res_name,context,type,date) of brands

/watchdogs

/watchdogs/add

access: [WRITE]

Given a url identifier, set a watchdog for it.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/watchdogs/add ?&ids=123abcdef&watchdog=1

Query parameters

     ids = 123abcdef
watchdog = 1

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "updated": "1"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/watchdogs/add?&ids=123abcdef&watchdog=1

Query parameters

     ids = 123abcdef
watchdog = 1

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <updated>1</updated>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/watchdogs/add?&ids=123abcdef&watchdog=1

Query parameters

     ids = 123abcdef
watchdog = 1

Response

Required parameters

parameter	description
spider_type	NA
watchdog	NA

Optional parameters

parameter	description
ids	NA
project_id	NA
text	NA
text_check	NA
video	NA
watchdog	NA
watchdog_set_as_default	NA

Return values

parameter	description
updated	NA

/watchdogs/delete

access: [WRITE]

Delete a watchdog related to a given short URL or a given project.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/watchdogs/delete?id=123abcdef

Query parameters

id = 123abcdef

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "watchdog": "0",
    "spider": "128",
    "spider_check": "0",
    "spider_check_option": "70",
    "spider_only_html": "1",
    "spider_time": "",
    "watchdog_is_default": "0"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/watchdogs/delete?format=xml&id=123abcdef

Query parameters

format = xml
    id = 123abcdef

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <watchdog>0</watchdog>  
    <spider>128</spider>  
    <spider_check>0</spider_check>  
    <spider_check_option>70</spider_check_option>  
    <spider_only_html>1</spider_only_html>  
    <spider_time></spider_time>  
    <watchdog_is_default>0</watchdog_is_default>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/watchdogs/delete?format=plain&id=123abcdef

Query parameters

format = plain
    id = 123abcdef

Response

Optional parameters

parameter	description
id	NA
project_id	NA

Return values

parameter	description
data	NA

/watchdogs/info

access: [READ]

Returns information on the watchdog related to a given tracking link or a given project.

Example 1 (json)Example 2 (xml)Example 3 (plain)

Example 1 (json)

Request

https://joturl.com/a/i1/watchdogs/info?id=123abcdef

Query parameters

id = 123abcdef

Response

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "result": {
    "watchdog": "0",
    "spider": "128",
    "spider_check": "0",
    "spider_check_option": "70",
    "spider_only_html": "1",
    "spider_time": "",
    "watchdog_is_default": "0"
  }
}

Example 2 (xml)

Request

https://joturl.com/a/i1/watchdogs/info?format=xml&id=123abcdef

Query parameters

format = xml
    id = 123abcdef

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>  
    <text>OK</text>  
  </status>  
  <result>
    <watchdog>0</watchdog>  
    <spider>128</spider>  
    <spider_check>0</spider_check>  
    <spider_check_option>70</spider_check_option>  
    <spider_only_html>1</spider_only_html>  
    <spider_time></spider_time>  
    <watchdog_is_default>0</watchdog_is_default>  
  </result>  
</response>

Example 3 (plain)

Request

https://joturl.com/a/i1/watchdogs/info?format=plain&id=123abcdef

Query parameters

format = plain
    id = 123abcdef

Response

Optional parameters

parameter	description
id	NA
project_id	NA

Return values

parameter	description
data	NA

/watchdogs/stats

access: [READ]

This method returns stats about a watchdog.

Example 1 (json)

Request

https://joturl.com/a/i1/watchdogs/stats

Response

{
  "status": {
    "code": 200,
    "text": "OK",
    "error": ""
  },
  "result": {
    "stats": "",
    "spiders": ""
  }
}

Return values

parameter	description
data	NA