Recommender API v3.0 Manorator
Open Navigation

General notes

API detail

Auth 8
Content-Type application/x-www-form-urlencoded
version v3.0 The API version (optional)
first_name John (Required) First Name of the user
last_name Doe (Required) Last Name of the user
email johndoe123@gmail.com (Required) Email address of te user
password 098f6bcd4621d373cade4e832627b4f6 (Required) MD5 encrypted string of your password
retype_password 098f6bcd4621d373cade4e832627b4f6 (Required) MD5 encrypted string of your password
organization Example Organization (Required) Organization 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "first_name=John&last_name=Doe&email=johndoe123@gmail.com&password=098f6bcd4621d373cade4e832627b4f6&retype_password=098f6bcd4621d373cade4e832627b4f6&organization=Example Organization" "{{recommender-api-url}}/register?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/register?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

first_name=John&last_name=Doe&email=johndoe123@gmail.com&password=098f6bcd4621d373cade4e832627b4f6&retype_password=098f6bcd4621d373cade4e832627b4f6&organization=Example Organization
Status401 Unauthorized
Content-Typeapplication/json
{
    "status_code": 401,
    "error": {
        "message": "Login failed",
        "code": 33
    }
}
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "session_id": 4624,
        "user_id": 254,
        "user_status": "Active",
        "user_type": "Manager",
        "email": "johndoe@example.com",
        "username": "johndoe",
        "gender": null,
        "dob": null,
        "profile_pic": null,
        "application": "Movie Lens Sample Data",
        "application_id": 24,
        "refresh_token": "{{jwt-token}}",
        "theme": null
    }
}
Status0
Content-Type application/x-www-form-urlencoded
version v3.0 (Optional) The API version
username johndoe123@gmail.com (Required) User email address
password 098f6bcd4621d373cade4e832627b4f6 (Required) MD5 generated string of the user's password 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "username=johndoe123@gmail.com&password=098f6bcd4621d373cade4e832627b4f6" "{{recommender-api-url}}/login?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/login?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

username=johndoe123@gmail.com&password=098f6bcd4621d373cade4e832627b4f6
Status401 Unauthorized
Content-Typeapplication/json
{
    "status_code": 401,
    "error": {
        "message": "Login failed",
        "code": 33
    }
}
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "session_id": 4624,
        "user_id": 254,
        "user_status": "Active",
        "user_type": "Manager",
        "email": "johndoe@example.com",
        "username": "johndoe",
        "gender": null,
        "dob": null,
        "profile_pic": null,
        "application": "Movie Lens Sample Data",
        "application_id": 24,
        "refresh_token": "{{jwt-token}}",
        "theme": null
    }
}
Content-Type application/x-www-form-urlencoded
version v3.0 The API version (optional)
activation_code 23ed9640a51d538ac8c034f59dba81de2139431fca47134e3f1d88003219 Activation code from email (required) 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "activation_code=23ed9640a51d538ac8c034f59dba81de2139431fca47134e3f1d88003219" "{{recommender-api-url}}/verify?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/verify?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

activation_code=23ed9640a51d538ac8c034f59dba81de2139431fca47134e3f1d88003219
Content-Type application/x-www-form-urlencoded
version v3.0 (Optional) The API version
email johndoe123@gmail.com (Required) Email to verify 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "email=johndoe123@gmail.com" "{{recommender-api-url}}/verify/resend?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/verify/resend?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

email=johndoe123@gmail.com
Content-Type application/x-www-form-urlencoded
version v3.0 (Optional) The API version
email johndoe@example.com (Required) Email of the user 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "email=johndoe@example.com" "{{recommender-api-url}}/reset/password?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/reset/password?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

email=johndoe@example.com
Content-Type application/json
version v3.0 (Optional) The API version
password 5a105e8b9d40e1329780d62ea2265d8a
token {{reset-password-jwt-token}} 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/json" -d "password=5a105e8b9d40e1329780d62ea2265d8a&token={{reset-password-jwt-token}}" "{{recommender-api-url}}/reset/change?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/reset/change?version=v3.0 HTTP/1.1
Host:
Content-Type: application/json
Content-Type: application/x-www-form-urlencoded

password=5a105e8b9d40e1329780d62ea2265d8a&token={{reset-password-jwt-token}}
Content-Type application/x-www-form-urlencoded
version v3.0 (Optional) The API version
user_id 1 (Required) Id of the user you wish to get a JWT generated token for 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "user_id=1" "{{recommender-api-url}}/generate?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/generate?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

user_id=1

Validates the Bearer token send in the request header.

Authorization Bearer {{recommender_api_jwt}}
Content-Type application/x-www-form-urlencoded
version v3.0 (Optional) The API version 
curl -X POST -H "Authorization: Bearer  {{recommender_api_jwt}}" -H "Content-Type: application/x-www-form-urlencoded" "{{recommender-api-url}}/validate?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/validate?version=v3.0 HTTP/1.1
Host:
Authorization: Bearer  {{recommender_api_jwt}}
Content-Type: application/x-www-form-urlencoded
Billing 7
version v3.0 (Optional) The API version
company Example Company (Required) Company name
contact_first_name John (Required) Billing First Name
contact_last_name Doe (Required) Billing Last Name 
curl -X POST "{{recommender-api-url}}/billing/info?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/billing/info?version=v3.0 HTTP/1.1
Host:

Returns info about query transactions for a day.

Type Results Index Example
Query Id query 29408
Username username johndoe@example.com
Transaction Status status success
Time of Transaction time 2020-07-03 10:27:15
version v3.0 (Optional) The API version
date 2018-05-21 (Required) Date. Format is "year-month-day". E.g. "2020-04-20"
page 1 (Optional) Results page number/index
size 2 (Optional) Number of results returned 
curl -X GET "{{recommender-api-url}}/billing/query?version=v3.0&date=2018-05-21&page=1&size=2"
GET %7B%7Brecommender-api-url%7D%7D/billing/query?version=v3.0&date=2018-05-21&page=1&size=2 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "currentPage": 1,
        "totalPages": 6,
        "totalResults": 12,
        "results": [
            {
                "query": 29408,
                "username": "johndoe@example.com",
                "status": "success",
                "time": "2020-07-03 10:27:15"
            },
            {
                "query": 29409,
                "username": "johndoen@example.com",
                "status": "success",
                "time": "2020-07-03 10:28:19"
            }
        ]
    }
}

Returns statement based on filters

version v3.0 (Optional) The API version
start_date 2018-05-21 (Required) Start date of statement query. Format is "year-month-day". E.g. "2020-04-20"
end_date 2018-05-28 (Required) End date of statement query. Format is "year-month-day". E.g. "2020-04-20" 
curl -X GET "{{recommender-api-url}}/billing/statement?version=v3.0&start_date=2018-05-21&end_date=2018-05-28"
GET %7B%7Brecommender-api-url%7D%7D/billing/statement?version=v3.0&start_date=2018-05-21&end_date=2018-05-28 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "day": "2020-07-01",
            "deposit": [],
            "queries": {
                "api_calls": 0,
                "cost": "0.00"
            }
        },
        {
            "day": "2020-07-02",
            "deposit": [],
            "queries": {
                "api_calls": 0,
                "cost": "0.00"
            }
        }
    ]
}

Returns usage stats of current month

version v3.0 (Optional) The API version
start_date 2018-05-01 (Required) Start date of stats query. Format is "year-month-day". E.g. "2020-04-20"
end_date 2018-05-03 (Required) End date of stats query. Format is "year-month-day". E.g. "2020-04-20" 
curl -X GET "{{recommender-api-url}}/billing/stats?version=v3.0&start_date=2018-05-01&end_date=2018-05-03"
GET %7B%7Brecommender-api-url%7D%7D/billing/stats?version=v3.0&start_date=2018-05-01&end_date=2018-05-03 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "api_calls": 12,
        "deposits": "0.00"
    }
}
version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/billing?version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/billing?version=v3.0 HTTP/1.1
Host:
version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/billing/plans?version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/billing/plans?version=v3.0 HTTP/1.1
Host:

Verifies payment from paypal / credit card / wire and adds funds to account
Pending

version v3.0 (Optional) The API version 
curl -X POST "{{recommender-api-url}}/billing/payment?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/billing/payment?version=v3.0 HTTP/1.1
Host:
Balance 1

Return current account balance

version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/billing/balance?version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/billing/balance?version=v3.0 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "api_calls": {
            "value": 0,
            "percentage": 0
        },
        "balance": {
            "value": "R0.00",
            "percentage": 0
        }
    }
}
Data 3

Post interaction data, can be single interactions or in bulk
Can send api user_id or your user id (internal_user_id) - user_id is preferred
Can send api item_id or your item id (internal_item_id) - item_id is preferred
6MB is the maximum amount of data that can be sent at once
Admin users only

Content-Type application/json
version v3.0 (Optional) The API version 
curl -X POST -H "Content-Type: application/json" -d '{
  "interactions": [{
      "user_id": 41499,
      "item_id": 98,
      "event_value": "10",
      "event_type": "quantity",
      "event_meta_data_1": 25
    },
    {
      "user_id": 1,
      "item_id": 1,
      "event_value": "8",
      "event_type": "quantity",
      "event_meta_data_1": 25,
      "event_meta_data_2": 10,
      "event_date": "2018-04-24 17:00:00"
    }
  ]
}' "{{recommender-api-url}}/data/interactions?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/data/interactions?version=v3.0 HTTP/1.1
Host:
Content-Type: application/json

{
  "interactions": [{
      "user_id": 41499,
      "item_id": 98,
      "event_value": "10",
      "event_type": "quantity",
      "event_meta_data_1": 25
    },
    {
      "user_id": 1,
      "item_id": 1,
      "event_value": "8",
      "event_type": "quantity",
      "event_meta_data_1": 25,
      "event_meta_data_2": 10,
      "event_date": "2018-04-24 17:00:00"
    }
  ]
}

Create new meta data entry for user or item and specify if it will be used for the recommender and date it got added
Admin users only

Authorization Bearer {{recommender_api_jwt}}
Content-Type application/json
version v3.0 (Optional) The API version 
curl -X POST -H "Authorization: Bearer {{recommender_api_jwt}}" -H "Content-Type: application/json" -d '{
    "action" : "create",
    "type" : "item",
    "meta_data": {
        "id": {
            "value" : 10001,
            "date_created" : "2018-04-24 14:15:00"
        },
        "title": {
            "value" : "The Action Movie",
            "date_created" : "2018-01-01 12:01:59"
        },
        "genres": {
            "value" : "action,comedy,romance",
            "date_created" : "2018-01-01 12:01:59"
        }
    }
}' "{{recommender-api-url}}/data/meta_data?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/data/meta_data?version=v3.0 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Content-Type: application/json

{
    "action" : "create",
    "type" : "item",
    "meta_data": {
        "id": {
            "value" : 10001,
            "date_created" : "2018-04-24 14:15:00"
        },
        "title": {
            "value" : "The Action Movie",
            "date_created" : "2018-01-01 12:01:59"
        },
        "genres": {
            "value" : "action,comedy,romance",
            "date_created" : "2018-01-01 12:01:59"
        }
    }
}

Create new meta data entry for user or item and specify if it will be used for the recommender and date it got added
Admin users only

Authorization Bearer {{recommender_api_jwt}}
Content-Type application/json
version v3.0 (Optional) The API version 
curl -X POST -H "Authorization: Bearer {{recommender_api_jwt}}" -H "Content-Type: application/json" -d '{
    "action" : "create",
    "type" : "user",
    "meta_data": {
        "id": {
          "value" : 1,
          "date_created" : "2018-04-24 14:15:00"
        }
  }
}
' "{{recommender-api-url}}/data/meta_data?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/data/meta_data?version=v3.0 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Content-Type: application/json

{
    "action" : "create",
    "type" : "user",
    "meta_data": {
        "id": {
          "value" : 1,
          "date_created" : "2018-04-24 14:15:00"
        }
  }
}
Info 11
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type items (Required) Cluster type. 'branches'|'users'|'items'
take 20 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/info/clusters?version=v3.0&type=items&take=20&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/clusters?version=v3.0&type=items&take=20&skip=0 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "total": "20",
        "data": [
            {
                "cluster": "1"
            },
            {
                "cluster": "2"
            },
            {
                "cluster": "3"
            },
            {
                "cluster": "4"
            },
            {
                "cluster": "5"
            },
            {
                "cluster": "6"
            },
            {
                "cluster": "7"
            },
            {
                "cluster": "8"
            },
            {
                "cluster": "9"
            },
            {
                "cluster": "10"
            },
            {
                "cluster": "11"
            },
            {
                "cluster": "12"
            },
            {
                "cluster": "13"
            },
            {
                "cluster": "14"
            },
            {
                "cluster": "15"
            },
            {
                "cluster": "16"
            },
            {
                "cluster": "17"
            },
            {
                "cluster": "18"
            },
            {
                "cluster": "19"
            },
            {
                "cluster": "20"
            }
        ]
    }
}
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "total": "20",
        "data": [
            {
                "cluster": "1"
            },
            {
                "cluster": "2"
            },
            {
                "cluster": "3"
            },
            {
                "cluster": "4"
            },
            {
                "cluster": "5"
            },
            {
                "cluster": "6"
            },
            {
                "cluster": "7"
            },
            {
                "cluster": "8"
            },
            {
                "cluster": "9"
            },
            {
                "cluster": "10"
            },
            {
                "cluster": "11"
            },
            {
                "cluster": "12"
            },
            {
                "cluster": "13"
            },
            {
                "cluster": "14"
            },
            {
                "cluster": "15"
            },
            {
                "cluster": "16"
            },
            {
                "cluster": "17"
            },
            {
                "cluster": "18"
            },
            {
                "cluster": "19"
            },
            {
                "cluster": "20"
            }
        ]
    }
}

Returns paginated list of users

version v3.0 (Optional) The API version
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/users?version=v3.0&take=10&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/users?version=v3.0&take=10&skip=0 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "total": "17304",
        "data": [
            {
                "user_id": "338038",
                "cluster": "18"
            },
            {
                "user_id": "338039",
                "cluster": "6"
            },
            {
                "user_id": "338040",
                "cluster": "16"
            },
            {
                "user_id": "338041",
                "cluster": "3"
            },
            {
                "user_id": "338043",
                "cluster": "9"
            },
            {
                "user_id": "338044",
                "cluster": "1"
            },
            {
                "user_id": "338045",
                "cluster": "10"
            },
            {
                "user_id": "338046",
                "cluster": "5"
            },
            {
                "user_id": "338047",
                "cluster": "6"
            },
            {
                "user_id": "338051",
                "cluster": "10"
            }
        ]
    }
}
version v3.0 (Optional) The API version
type users (Required) Cluster type
take 20 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/clusters?version=v3.0&type=users&take=20&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/clusters?version=v3.0&type=users&take=20&skip=0 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "total": "20",
        "data": [
            {
                "cluster": "1"
            },
            {
                "cluster": "2"
            },
            {
                "cluster": "3"
            },
            {
                "cluster": "4"
            },
            {
                "cluster": "5"
            },
            {
                "cluster": "6"
            },
            {
                "cluster": "7"
            },
            {
                "cluster": "8"
            },
            {
                "cluster": "9"
            },
            {
                "cluster": "10"
            },
            {
                "cluster": "11"
            },
            {
                "cluster": "12"
            },
            {
                "cluster": "13"
            },
            {
                "cluster": "14"
            },
            {
                "cluster": "15"
            },
            {
                "cluster": "16"
            },
            {
                "cluster": "17"
            },
            {
                "cluster": "18"
            },
            {
                "cluster": "19"
            },
            {
                "cluster": "20"
            }
        ]
    }
}

Returns paginated list of users

Operators:

Operator Comparative Logic
startswith LIKE {value} %%
contains LIKE %%{value}%%
doesnotcontain NOT LIKE %%{value}%%
endswith LIKE %%{value}
eq \=
gt >
lt <
gte >=
lte <=
neg <>
version v3.0 (Optional) The API version
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0'
filter[filters][0][field] id (Required) Field to use for filter
filter[filters][0][operator] eq (Required) Operator to use for filter. 'startswith'|'contains'|doesnotcontain'|'endswith'|'eq'|'gt'|'lt'|'gte'|'lte'|'neg'
filter[filters][0][value] 338041 (Required) Value to use for filter.
filter[logic] and (Required) Multiple Filters combination logic. 'and'|'or'
filter[filters][1][field] id
filter[filters][1][operator] eq
filter[filters][1][value] 338040 
curl -X GET "{{recommender-api-url}}/info/users?version=v3.0&take=10&skip=0&filter[filters][0][field]=id&filter[filters][0][operator]=eq&filter[filters][0][value]=338041&filter[logic]=and&filter[filters][1][field]=id&filter[filters][1][operator]=eq&filter[filters][1][value]=338040"
GET %7B%7Brecommender-api-url%7D%7D/info/users?version=v3.0&take=10&skip=0&filter[filters][0][field]=id&filter[filters][0][operator]=eq&filter[filters][0][value]=338041&filter[logic]=and&filter[filters][1][field]=id&filter[filters][1][operator]=eq&filter[filters][1][value]=338040 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "total": "2",
        "data": [
            {
                "user_id": "338040",
                "cluster": "16"
            },
            {
                "user_id": "338041",
                "cluster": "3"
            }
        ]
    }
}

Returns user interactions based on filters

version v3.0 (Optional) The API version
type user (Required) Interaction type.
field quantity (Required) Interactions field.
difference absolute (Required) 'absolute'|'relative'
user_id 341405 (Required) User Id
order desc (Optional) Result ordering 'desc'|'asc'
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/interactions/?version=v3.0&type=user&field=quantity&difference=absolute&user_id=341405&order=desc&take=10&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/interactions/?version=v3.0&type=user&field=quantity&difference=absolute&user_id=341405&order=desc&take=10&skip=0 HTTP/1.1
Host:

Returns cluster interactions based on filters

version v3.0 (Optional) The API version
type cluster (Required) Interaction type.
cluster_type user (Required) Cluster/Segment type. 'user'|'item'|'branch'
cluster 1 (Required) Cluster Id.
difference absolute (Required) 'absolute'|'relative'
field rating (Required) Interactions field.
order desc (Optional) Result ordering 'desc'|'asc'
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/interactions/?version=v3.0&type=cluster&cluster_type=user&cluster=1&difference=absolute&field=rating&order=desc&take=10&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/interactions/?version=v3.0&type=cluster&cluster_type=user&cluster=1&difference=absolute&field=rating&order=desc&take=10&skip=0 HTTP/1.1
Host:
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/info/items?version=v3.0&take=10&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/items?version=v3.0&take=10&skip=0 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}

Operators:

Operator Comparative Logic
startswith LIKE {value} %%
contains LIKE %%{value}%%
doesnotcontain NOT LIKE %%{value}%%
endswith LIKE %%{value}
eq \=
gt >
lt <
gte >=
lte <=
neg <>
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0'
filter[filters][0][field] id (Required) Field to use for filter
filter[filters][0][operator] eq (Required) Operator to use for filter. 'startswith'|'contains'|doesnotcontain'|'endswith'|'eq'|'gt'|'lt'|'gte'|'lte'|'neg'
filter[filters][0][value] 260335 (Required) Value to use for filter.
filter[logic] and (Required) Multiple Filters combination logic. 'and'|'or' 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/info/items?version=v3.0&take=10&skip=0&filter[filters][0][field]=id&filter[filters][0][operator]=eq&filter[filters][0][value]=260335&filter[logic]=and"
GET %7B%7Brecommender-api-url%7D%7D/info/items?version=v3.0&take=10&skip=0&filter[filters][0][field]=id&filter[filters][0][operator]=eq&filter[filters][0][value]=260335&filter[logic]=and HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type items (Required) Cluster Type
take 20 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/clusters?version=v3.0&type=items&take=20&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/clusters?version=v3.0&type=items&take=20&skip=0 HTTP/1.1
Host:

Returns user interactions based on filters

version v3.0 (Optional) The API version
type item (Required) Interaction type
item_id 260337 (Required) Item Id
field sales (Required) Interactions field.
order desc (Optional) Result ordering 'desc'|'asc'
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/interactions/?version=v3.0&type=item&item_id=260337&field=sales&order=desc&take=10&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/interactions/?version=v3.0&type=item&item_id=260337&field=sales&order=desc&take=10&skip=0 HTTP/1.1
Host:

Returns cluster interactions based on filters

version v3.0 (Optional) The API version
type cluster (Required) Interaction type
cluster_type user (Required) Cluster/Segment type. 'user'|'item'|'branch'
difference relative (Required) 'absolute'|'relative'
cluster 6 (Required) Cluster/Segment Id.
field quantity (Required) Interactions field.
order desc (Optional) Result ordering 'desc'|'asc'
take 10 (Optional) Number of results returned - Default = '10'
skip 0 (Optional) Number of results to skip - Default = '0' 
curl -X GET "{{recommender-api-url}}/info/interactions/?type=cluster&cluster_type=user&difference=relative&cluster=6&field=quantity&order=desc&take=10&skip=0"
GET %7B%7Brecommender-api-url%7D%7D/info/interactions/?type=cluster&cluster_type=user&difference=relative&cluster=6&field=quantity&order=desc&take=10&skip=0 HTTP/1.1
Host:
Organization 7
version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/organization/applications?version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/organization/applications?version=v3.0 HTTP/1.1
Host:
version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/organization/users?version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/organization/users?version=v3.0 HTTP/1.1
Host:
version v3.0 (Optional) The API version
application_id 26 (Required) Application ID 
curl -X GET "{{recommender-api-url}}/organization/application-users?version=v3.0&application_id=26"
GET %7B%7Brecommender-api-url%7D%7D/organization/application-users?version=v3.0&application_id=26 HTTP/1.1
Host:
version v3.0 (Optional) The API version
name New App Name (Required) New Application name
description App Description (Required) The description of the application
domain https://domain.com (Required) The domain where the application will run
application_type other (Required) One of three options: media,retail or other 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "name=New App Name&description=App Description&domain=https://domain.com&application_type=other" "{{recommender-api-url}}/organization/create-application?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/organization/create-application?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

name=New App Name&description=App Description&domain=https://domain.com&application_type=other
version v3.0 (Optional) The API version
first_name John (Required) First Name of the new user
last_name Doe (Required) Last Name of the new user
email johndoe@example.com (Required) Email of the new user
user_type Org-Admin (Required) One of 4 values: Org-Owner, Org-Admin, Org-Billing or App-User 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "first_name=John&last_name=Doe&email=johndoe@example.com&user_type=Org-Admin" "{{recommender-api-url}}/organization/create-user?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/organization/create-user?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

first_name=John&last_name=Doe&email=johndoe@example.com&user_type=Org-Admin
version v3.0 (Optional) The API version
application_id 12 (Required) Application ID belonging to the Organization
user_id 90 (Required) User ID belonging to the Organization 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "application_id=12&user_id=90" "{{recommender-api-url}}/organization/add-user-application?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/organization/add-user-application?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

application_id=12&user_id=90
version v3.0 (Optional) The API version
application_id 12 (Required) The application you want to use 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "application_id=12" "{{recommender-api-url}}/organization/change-application?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/organization/change-application?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

application_id=12
Recommender Builder 16

Instructs the Xineoh API to fetch and import your data from your S3 bucket.

version v3.0 (Optional) The API version
aws_secret_key SdMVa47GlNKrbH//ZpKGnxgMTcb68+bHMRAZ4BWr (Required) AWS S3 Secret Key
aws_bucket xineoh-movielens-bucket (Required) AWS S3 Bucket 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "aws_secret_key=SdMVa47GlNKrbH//ZpKGnxgMTcb68+bHMRAZ4BWr&aws_bucket=xineoh-movielens-bucket" "{{recommender-api-url}}/builder/batch?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/batch?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

aws_secret_key=SdMVa47GlNKrbH//ZpKGnxgMTcb68+bHMRAZ4BWr&aws_bucket=xineoh-movielens-bucket

Tell the API to split and process the uploaded data into 80\20 training and testing datasets.

version v3.0 (Optional) The API version
contextual true (Required) Type = Boolean - If ‘contextual’ is true, then the same or similar event values and types will be grouped together to allow for better training on the minor differences in the user-item interactions. If ‘contextual’ is false then there will only be a differentiation for the event types when processing the data. 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "contextual=true" "{{recommender-api-url}}/builder/build?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/build?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

contextual=true

Trigger the API to begin training the model with the previously split and processed training data.

version v3.0 (Optional) The API version 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" "{{recommender-api-url}}/builder/train?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/train?version=v3.0 HTTP/1.1
Host:

Test the trained model against the previously split and processed testing data to determine accuracy.

version v3.0 (Optional) The API version
contextual false (Required) Type = Boolean - If you set ‘contextual’ as false for ‘Build Data and Structures for Training and Testing’ API then please set ‘contextual’ as false here too. However, if you set ‘contextual’ as true for ‘Build Data and Structures for Training and Testing’ API then you can set either true or false. 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "contextual=false" "{{recommender-api-url}}/builder/test?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/test?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

contextual=false

Trigger API to run hyper-parameter optimization for the model.

version v3.0 (Optional) The API version
max_iter 30 (Required) Maximum number of iterations to run the meta param optimization. (Min: 5, Max: 100) 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "max_iter=30" "{{recommender-api-url}}/builder/optimize?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/optimize?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

max_iter=30

Set the minimum and maximum number of user clusters for the trade-off chart.

version v3.0 (Optional) The API version
clusters_min 2 (Required) Minimum amount of clusters to do for a given cluster type (Min:2)
clusters_max 10 (Required) Maximum amount of clusters to do for a given cluster type (Max:100)
cluster_type user (Required) Which category to cluster - user or item 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "clusters_min=2&clusters_max=10&cluster_type=user" "{{recommender-api-url}}/builder/cluster?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/cluster?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

clusters_min=2&clusters_max=10&cluster_type=user

Set the minimum and maximum number of item clusters for the trade-off chart.

version v3.0 (Optional) The API version
clusters_min 2 (Required) Minimum amount of clusters to do for a given cluster type (Min:2)
clusters_max 10 (Required) Maximum amount of clusters to do for a given cluster type (Max:100)
cluster_type item (Required) Which category to cluster - user or item 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "clusters_min=2&clusters_max=10&cluster_type=item" "{{recommender-api-url}}/builder/cluster?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/cluster?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

clusters_min=2&clusters_max=10&cluster_type=item

Get the mean squared errors for each cluster count between the specified min and max that was set.

version v3.0 (Optional) The API version
graph trade_off (Required) Graph Type
type users (Required) Trade off data type. 'users'|'items' 
curl -X GET "{{recommender-api-url}}/charts/graph?version=v3.0&graph=trade_off&type=users"
GET %7B%7Brecommender-api-url%7D%7D/charts/graph?version=v3.0&graph=trade_off&type=users HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "number_of_clusters": "2",
            "mse": "31824.90"
        },
        {
            "number_of_clusters": "3",
            "mse": "30556.59"
        },
        {
            "number_of_clusters": "4",
            "mse": "29532.38"
        },
        {
            "number_of_clusters": "5",
            "mse": "28702.58"
        },
        {
            "number_of_clusters": "6",
            "mse": "27914.87"
        },
        {
            "number_of_clusters": "7",
            "mse": "27288.29"
        },
        {
            "number_of_clusters": "8",
            "mse": "26805.86"
        },
        {
            "number_of_clusters": "9",
            "mse": "26389.04"
        },
        {
            "number_of_clusters": "10",
            "mse": "25940.89"
        },
        {
            "number_of_clusters": "11",
            "mse": "25497.67"
        },
        {
            "number_of_clusters": "12",
            "mse": "25157.47"
        },
        {
            "number_of_clusters": "13",
            "mse": "24815.04"
        },
        {
            "number_of_clusters": "14",
            "mse": "24496.50"
        },
        {
            "number_of_clusters": "15",
            "mse": "24245.73"
        },
        {
            "number_of_clusters": "16",
            "mse": "24058.61"
        },
        {
            "number_of_clusters": "17",
            "mse": "23879.36"
        },
        {
            "number_of_clusters": "18",
            "mse": "23684.18"
        },
        {
            "number_of_clusters": "19",
            "mse": "23539.99"
        },
        {
            "number_of_clusters": "20",
            "mse": "23431.13"
        }
    ]
}
version v3.0 (Optional) The API version
cluster_type user (Required)Which category of cluster to save the cluster info for
cluster_amount 10 (Required) Chosen number of clusters to use for a given cluster type 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "cluster_type=user&cluster_amount=10" "{{recommender-api-url}}/builder/cluster_choose?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/cluster_choose?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

cluster_type=user&cluster_amount=10

Get the mean squared errors for each cluster count between the specified min and max that was set.

version v3.0 (Optional) The API version
graph trade_off (Required) Graph Type
type items (Required) Trade off type. 'users'|'items' 
curl -X GET "{{recommender-api-url}}/charts/graph?version=v3.0&graph=trade_off&type=items"
GET %7B%7Brecommender-api-url%7D%7D/charts/graph?version=v3.0&graph=trade_off&type=items HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "number_of_clusters": "2",
            "mse": "162584.55"
        },
        {
            "number_of_clusters": "3",
            "mse": "158518.19"
        },
        {
            "number_of_clusters": "4",
            "mse": "155479.15"
        },
        {
            "number_of_clusters": "5",
            "mse": "152717.84"
        },
        {
            "number_of_clusters": "6",
            "mse": "150644.99"
        },
        {
            "number_of_clusters": "7",
            "mse": "148901.17"
        },
        {
            "number_of_clusters": "8",
            "mse": "147307.51"
        },
        {
            "number_of_clusters": "9",
            "mse": "146243.97"
        },
        {
            "number_of_clusters": "10",
            "mse": "145347.56"
        },
        {
            "number_of_clusters": "11",
            "mse": "144468.26"
        },
        {
            "number_of_clusters": "12",
            "mse": "143672.38"
        },
        {
            "number_of_clusters": "13",
            "mse": "142966.35"
        },
        {
            "number_of_clusters": "14",
            "mse": "142319.23"
        },
        {
            "number_of_clusters": "15",
            "mse": "141754.99"
        },
        {
            "number_of_clusters": "16",
            "mse": "141220.43"
        },
        {
            "number_of_clusters": "17",
            "mse": "140714.97"
        },
        {
            "number_of_clusters": "18",
            "mse": "140277.15"
        },
        {
            "number_of_clusters": "19",
            "mse": "139878.46"
        },
        {
            "number_of_clusters": "20",
            "mse": "139461.73"
        }
    ]
}
version v3.0 (Optional) The API version
cluster_type item (Required)Which category of cluster to save the cluster info for
cluster_amount 10 (Required) Chosen number of clusters to use for a given cluster type 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "cluster_type=item&cluster_amount=10" "{{recommender-api-url}}/builder/cluster_choose?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/cluster_choose?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

cluster_type=item&cluster_amount=10

Tell the API to take all the processed data in the Hadoop server and write it to the MySQL server. This is required for certain API calls.

version v3.0 (Optional) The API version 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" "{{recommender-api-url}}/builder/transfer?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/transfer?version=v3.0 HTTP/1.1
Host:

Trigger initialization of cold start for users.

version v3.0 (Optional) The API version
target_type user (Required) Type of target to run cold starts on. 'item'|'user' 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "target_type=user" "{{recommender-api-url}}/builder/meta_model?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/meta_model?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

target_type=user

Set user cold start preferences.

version v3.0 (Optional) The API version
infer_type deep_inference (Required) Type of inference to do for targets that have interactions (deep_inference|vector_averaging)
target_type user (Required) Type of target to run cold starts on (item|user) 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "infer_type=deep_inference&target_type=user" "{{recommender-api-url}}/builder/cold_start?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/cold_start?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

infer_type=deep_inference&target_type=user

Trigger initialization of cold start for items.

version v3.0 (Optional) The API version
target_type item (Required) Type of target to run cold starts on (item|user) 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "target_type=item" "{{recommender-api-url}}/builder/meta_model?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/meta_model?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

target_type=item

Set item cold start preferences.

version v3.0 (Optional) The API version
infer_type vector_averaging (Required) Type of inference to do for targets that have interactions (deep_inference|vector_averaging)
target_type item (Required) Type of target to run cold starts on (item|user) 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "infer_type=vector_averaging&target_type=item" "{{recommender-api-url}}/builder/cold_start?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/builder/cold_start?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

infer_type=vector_averaging&target_type=item
Historical Recommendations 7
version v3.0 (Optional) The API version
type cluster_recommendations (Required) Type of recommendations to return
cluster_type user (Required) Cluster/Segment type. 'user' | 'item'
id 1 (Required) Cluster/Segment Id. 
curl -X GET "{{recommender-api-url}}/recommender/recommendations?version=v3.0&type=cluster_recommendations&cluster_type=user&id=1"
GET %7B%7Brecommender-api-url%7D%7D/recommender/recommendations?version=v3.0&type=cluster_recommendations&cluster_type=user&id=1 HTTP/1.1
Host:
Authorization Bearer {{recommender_api_jwt}}
Content-Type application/json
version v3.0 (Optional) The API version
type cluster_recommendations (Required) Type of recommendations to return
cluster_type item (Required) Cluster/Segment type. 'user' | 'item'
id 1 (Required) Cluster/Segment Id. 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" -H "Content-Type: application/json" "{{recommender-api-url}}/recommender/recommendations?version=v3.0&type=cluster_recommendations&cluster_type=item&id=1"
GET %7B%7Brecommender-api-url%7D%7D/recommender/recommendations?version=v3.0&type=cluster_recommendations&cluster_type=item&id=1 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Content-Type: application/json
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type user_recommendations (Required) Type of recommendations to return
id 11679308 (Required) User id to get recommendations for 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/recommender/recommendations?version=v3.0&type=user_recommendations&id=11679308"
GET %7B%7Brecommender-api-url%7D%7D/recommender/recommendations?version=v3.0&type=user_recommendations&id=11679308 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type user_closest_clusters (Required) Type of recommendations to return
id 1 (Required) Cluster/Segment Id. 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/recommender/similar?version=v3.0&type=user_closest_clusters&id=1"
GET %7B%7Brecommender-api-url%7D%7D/recommender/similar?version=v3.0&type=user_closest_clusters&id=1 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type item_closest_clusters (Required) Type of recommendations to return
id 1 (Required) Cluster/Segment Id. 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/recommender/similar?version=v3.0&type=item_closest_clusters&id=1"
GET %7B%7Brecommender-api-url%7D%7D/recommender/similar?version=v3.0&type=item_closest_clusters&id=1 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type item (Required) Type of recommendations to return
id 372785 (Required) Id of the item you want to get recommendations for
filter {"includes": {"category": "Apparel"}, "excludes": {"category": "Gifting"}} (Optional) Filter to include and exclude items based on meta data field values 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/recommender/similar?version=v3.0&type=item&id=372785&filter={"includes": {"category": "Apparel"}, "excludes": {"category": "Gifting"}}"
GET %7B%7Brecommender-api-url%7D%7D/recommender/similar?version=v3.0&type=item&id=372785&filter={"includes": {"category": "Apparel"}, "excludes": {"category": "Gifting"}} HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Authorization Bearer {{recommender_api_jwt}}
version v3.0 (Optional) The API version
type user (Required) Type of recommendations to return
id 382015 (Required) Id of the user you want to get recommendations for 
curl -X GET -H "Authorization: Bearer {{recommender_api_jwt}}" "{{recommender-api-url}}/recommender/similar?version=v3.0&type=user&id=382015"
GET %7B%7Brecommender-api-url%7D%7D/recommender/similar?version=v3.0&type=user&id=382015 HTTP/1.1
Host:
Authorization: Bearer {{recommender_api_jwt}}
Session Based Recommendations 10

Return current account balance

version v3.0 (Optional) The API version
action YES (Required) Action type. 'YES' | 'NO' | 'MAYBE' | 'SEEN_LIKED' | 'SEEN_DISLIKED' 
curl -X GET "{{recommender-api-url}}/yenoma/actions?version=v3.0&action=YES"
GET %7B%7Brecommender-api-url%7D%7D/yenoma/actions?version=v3.0&action=YES HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "27",
            "item_id": "10005",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-02 15:07:54"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "22",
            "item_id": "10008",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:11:05"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "21",
            "item_id": "10007",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:06:20"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "19",
            "item_id": "10006",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-02-01 17:04:32"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "18",
            "item_id": "10004",
            "user_id": "89",
            "session_id": null,
            "is_negative": "1",
            "is_removed": "0",
            "created_dt": "2022-01-31 14:38:56"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "15",
            "item_id": "10001",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:58"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        },
        {
            "action_id": "14",
            "item_id": "10000",
            "user_id": "89",
            "session_id": null,
            "is_negative": "0",
            "is_removed": "0",
            "created_dt": "2022-01-31 13:23:14"
        }
    ]
}

Return current account balance

action ALL (Required) Action type.
version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/yenoma/actions?action=ALL&version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/yenoma/actions?action=ALL&version=v3.0 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "10000": {
            "item_id": "10000",
            "action": "YES",
            "seen_state": null
        },
        "10001": {
            "item_id": "10001",
            "action": "YES",
            "seen_state": null
        },
        "10002": {
            "item_id": "10002",
            "action": null,
            "seen_state": "SEEN_DISLIKED"
        },
        "10003": {
            "item_id": "10003",
            "action": null,
            "seen_state": "SEEN_DISLIKED"
        },
        "10004": {
            "item_id": "10004",
            "action": "YES",
            "seen_state": null
        },
        "10005": {
            "item_id": "10005",
            "action": "YES",
            "seen_state": null
        },
        "10006": {
            "item_id": "10006",
            "action": "NO",
            "seen_state": null
        },
        "10007": {
            "item_id": "10007",
            "action": "YES",
            "seen_state": null
        },
        "10008": {
            "item_id": "10008",
            "action": "YES",
            "seen_state": null
        },
        "10009": {
            "item_id": "10009",
            "action": null,
            "seen_state": "SEEN_LIKED"
        },
        "10010": {
            "item_id": "10010",
            "action": null,
            "seen_state": "SEEN_DISLIKED"
        }
    }
}

Return current account balance

actions[0][user_id] 44 (Required) Id of user that performed the action
actions[0][item_id] 1 (Required) Id of the item the action was performed on
actions[0][action] YES (Required) Action type. 'YES' | 'NO' | 'MAYBE' | 'SEEN_LIKED' | 'SEEN_DISLIKED'
actions[0][converted] 1 (Required) If action taken resulted in a conversion. '0' = no, '1' = yes
actions[0][tags] {"session_id":"snopppy","directors":"Steven Murrey","rating":"8.6","genres":"1 2 55 6 7","search_raw":"properties","service_filter":"1,2,3"} (Required) JSON of item meta data including session_id. 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "actions[0][user_id]=44&actions[0][item_id]=1&actions[0][action]=YES&actions[0][converted]=1&actions[0][tags]={"session_id":"snopppy","directors":"Steven Murrey","rating":"8.6","genres":"1 2 55 6 7","search_raw":"properties","service_filter":"1,2,3"}" "{{recommender-api-url}}/yenoma/batch"
POST %7B%7Brecommender-api-url%7D%7D/yenoma/batch HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

actions[0][user_id]=44&actions[0][item_id]=1&actions[0][action]=YES&actions[0][converted]=1&actions[0][tags]={"session_id":"snopppy","directors":"Steven Murrey","rating":"8.6","genres":"1 2 55 6 7","search_raw":"properties","service_filter":"1,2,3"}

Url = ‘/yenoma/item/state/{item_id}’

curl -X GET "{{recommender-api-url}}/yenoma/item/state/10001"
GET %7B%7Brecommender-api-url%7D%7D/yenoma/item/state/10001 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "item_id": "10001",
        "action": "YES",
        "seen_state": null
    }
}

Return current account balance

entertainment_id 4619
size 13 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "entertainment_id=4619&size=13" "{{recommender-api-url}}/yenoma/recommend/recommendations"
POST %7B%7Brecommender-api-url%7D%7D/yenoma/recommend/recommendations HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

entertainment_id=4619&size=13

Return current account balance

curl -X GET "{{recommender-api-url}}/yenoma/TagProfile/gettagprofiles"
GET %7B%7Brecommender-api-url%7D%7D/yenoma/TagProfile/gettagprofiles HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": {
        "session_id": {
            "tag_profile_id": "18",
            "key_value": "session_id",
            "token_symbols": "id_",
            "default_value": "id_unknown",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "price": {
            "tag_profile_id": "19",
            "key_value": "price",
            "token_symbols": "price_",
            "default_value": "0",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "max_price": {
            "tag_profile_id": "20",
            "key_value": "max_price",
            "token_symbols": "max_price_",
            "default_value": "0",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "categories": {
            "tag_profile_id": "21",
            "key_value": "categories",
            "token_symbols": "category_",
            "default_value": "categories_all",
            "is_wrapper": "0",
            "is_array": "1"
        },
        "day": {
            "tag_profile_id": "22",
            "key_value": "day",
            "token_symbols": "d_",
            "default_value": "d_unknown",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "time": {
            "tag_profile_id": "23",
            "key_value": "time",
            "token_symbols": "t_",
            "default_value": "t_unknown",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "buying_for": {
            "tag_profile_id": "24",
            "key_value": "buying_for",
            "token_symbols": "bf_",
            "default_value": "bf_all",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "search_nlp": {
            "tag_profile_id": "25",
            "key_value": "search_nlp",
            "token_symbols": "@",
            "default_value": "@no_search@",
            "is_wrapper": "1",
            "is_array": "0"
        },
        "user_id": {
            "tag_profile_id": "26",
            "key_value": "user_id",
            "token_symbols": "user_",
            "default_value": "user_unknown",
            "is_wrapper": "0",
            "is_array": "0"
        },
        "conversion": {
            "tag_profile_id": "27",
            "key_value": "conversion",
            "token_symbols": "converted_",
            "default_value": "converted_0",
            "is_wrapper": "0",
            "is_array": "0"
        }
    }
}

Return current account balance

action[user_id] 1001 (Required) Id of user that performed the action
action[item_id] 1 (Required) Id of the item the action was performed on
action[action] YES (Required) Action type. 'YES' | 'NO' | 'MAYBE' | 'SEEN_LIKED' | 'SEEN_DISLIKED'
action[converted] 1 (Required) If action taken resulted in a conversion. '0' = no, '1' = yes
action[tags] {"session_id":"snopppy","directors":"Steven Murrey","rating":"8.6","genres":"1 2 55 6 7","search_raw":"properties","service_filter":"1,2,3"} (Required) JSON of item meta data including session_id. 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "action[user_id]=1001&action[item_id]=1&action[action]=YES&action[converted]=1&action[tags]={"session_id":"snopppy","directors":"Steven Murrey","rating":"8.6","genres":"1 2 55 6 7","search_raw":"properties","service_filter":"1,2,3"}" "{{recommender-api-url}}/yenoma/record"
POST %7B%7Brecommender-api-url%7D%7D/yenoma/record HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded

action[user_id]=1001&action[item_id]=1&action[action]=YES&action[converted]=1&action[tags]={"session_id":"snopppy","directors":"Steven Murrey","rating":"8.6","genres":"1 2 55 6 7","search_raw":"properties","service_filter":"1,2,3"}

Return current account balance

action MAYBE (Required) Action type. 'YES' | 'NO' | 'MAYBE' | 'SEEN_LIKED' | 'SEEN_DISLIKED' 
curl -X POST "{{recommender-api-url}}/yenoma/remove/all?action=MAYBE"
POST %7B%7Brecommender-api-url%7D%7D/yenoma/remove/all?action=MAYBE HTTP/1.1
Host:

Return current account balance

action_id 27 (Required) Action Id to be removed 
curl -X POST "{{recommender-api-url}}/yenoma/remove/single?action_id=27"
POST %7B%7Brecommender-api-url%7D%7D/yenoma/remove/single?action_id=27 HTTP/1.1
Host:

Return current account balance

session_id id_reuben_testing_1 (Required) Session id
item_id 10005 (Required) Item Id of action
action YES (Required) Action type. 'YES' | 'NO' | 'MAYBE' | 'SEEN_LIKED' | 'SEEN_DISLIKED' 
curl -X POST "{{recommender-api-url}}/yenoma/remove/singlesession?session_id=id_reuben_testing_1&item_id=10005&action=YES"
POST %7B%7Brecommender-api-url%7D%7D/yenoma/remove/singlesession?session_id=id_reuben_testing_1&item_id=10005&action=YES HTTP/1.1
Host:
Process 2
version v3.0 (Optional) The API version
process_id 235 (Required) Process ID recieved from one of the Builder endpoints 
curl -X GET "{{recommender-api-url}}/process?version=v3.0&process_id=235"
GET %7B%7Brecommender-api-url%7D%7D/process?version=v3.0&process_id=235 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "number_of_clusters": "2",
            "mse": "31824.90"
        },
        {
            "number_of_clusters": "3",
            "mse": "30556.59"
        },
        {
            "number_of_clusters": "4",
            "mse": "29532.38"
        },
        {
            "number_of_clusters": "5",
            "mse": "28702.58"
        },
        {
            "number_of_clusters": "6",
            "mse": "27914.87"
        },
        {
            "number_of_clusters": "7",
            "mse": "27288.29"
        },
        {
            "number_of_clusters": "8",
            "mse": "26805.86"
        },
        {
            "number_of_clusters": "9",
            "mse": "26389.04"
        },
        {
            "number_of_clusters": "10",
            "mse": "25940.89"
        },
        {
            "number_of_clusters": "11",
            "mse": "25497.67"
        },
        {
            "number_of_clusters": "12",
            "mse": "25157.47"
        },
        {
            "number_of_clusters": "13",
            "mse": "24815.04"
        },
        {
            "number_of_clusters": "14",
            "mse": "24496.50"
        },
        {
            "number_of_clusters": "15",
            "mse": "24245.73"
        },
        {
            "number_of_clusters": "16",
            "mse": "24058.61"
        },
        {
            "number_of_clusters": "17",
            "mse": "23879.36"
        },
        {
            "number_of_clusters": "18",
            "mse": "23684.18"
        },
        {
            "number_of_clusters": "19",
            "mse": "23539.99"
        },
        {
            "number_of_clusters": "20",
            "mse": "23431.13"
        }
    ]
}
version v3.0 (Optional) The API version
process optimize (Required) Process ID recieved from one of the Builder endpoints 
curl -X GET "{{recommender-api-url}}/process?version=v3.0&process=optimize"
GET %7B%7Brecommender-api-url%7D%7D/process?version=v3.0&process=optimize HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "number_of_clusters": "2",
            "mse": "31824.90"
        },
        {
            "number_of_clusters": "3",
            "mse": "30556.59"
        },
        {
            "number_of_clusters": "4",
            "mse": "29532.38"
        },
        {
            "number_of_clusters": "5",
            "mse": "28702.58"
        },
        {
            "number_of_clusters": "6",
            "mse": "27914.87"
        },
        {
            "number_of_clusters": "7",
            "mse": "27288.29"
        },
        {
            "number_of_clusters": "8",
            "mse": "26805.86"
        },
        {
            "number_of_clusters": "9",
            "mse": "26389.04"
        },
        {
            "number_of_clusters": "10",
            "mse": "25940.89"
        },
        {
            "number_of_clusters": "11",
            "mse": "25497.67"
        },
        {
            "number_of_clusters": "12",
            "mse": "25157.47"
        },
        {
            "number_of_clusters": "13",
            "mse": "24815.04"
        },
        {
            "number_of_clusters": "14",
            "mse": "24496.50"
        },
        {
            "number_of_clusters": "15",
            "mse": "24245.73"
        },
        {
            "number_of_clusters": "16",
            "mse": "24058.61"
        },
        {
            "number_of_clusters": "17",
            "mse": "23879.36"
        },
        {
            "number_of_clusters": "18",
            "mse": "23684.18"
        },
        {
            "number_of_clusters": "19",
            "mse": "23539.99"
        },
        {
            "number_of_clusters": "20",
            "mse": "23431.13"
        }
    ]
}
User 2

List of all users in application
Admin users only

version v3.0 (Optional) The API version 
curl -X GET "{{recommender-api-url}}/user?version=v3.0"
GET %7B%7Brecommender-api-url%7D%7D/user?version=v3.0 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json
{
    "status_code": 200,
    "response": [
        {
            "user_id": "89",
            "account": "email",
            "user_status_id": "1",
            "user_status": "Active",
            "user_type": "User",
            "first_name": "Reuben",
            "last_name": "Tester",
            "email": "rubytest@xineoh.com",
            "username": null,
            "oauth_id": null,
            "shopify_id": null,
            "telephone": null,
            "dob": "2022-01-21",
            "gender": "male",
            "profile_pic_url": null,
            "created_dt": null,
            "updated_dt": null,
            "application_id": "19",
            "application_app_id": "WhiteRabbitApi2",
            "application": "White Rabbit Api 2",
            "application_type": "retail",
            "token": "ac2aa4c67f6caa3061b4ca826ecdcd29"
        }
    ]
}

Admin user can add extra users, system generates password for user that can be changed
Admin users only

Content-Type application/x-www-form-urlencoded
version v3.0 (Optional) The API version
email user@example.com (Required) New user email
first_name John (Required) New user's first name
last_name Doe (Required) New user's last name 
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "Content-Type: application/x-www-form-urlencoded" -d "email=user@example.com&first_name=John&last_name=Doe" "{{recommender-api-url}}/user/addUser?version=v3.0"
POST %7B%7Brecommender-api-url%7D%7D/user/addUser?version=v3.0 HTTP/1.1
Host:
Content-Type: application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded

email=user@example.com&first_name=John&last_name=Doe