Skip to content

User

API calls on work with users in the admin panel.

API path: panel/user.

User object structure

{ 
    "dealer_id": 5001,
    "activated": true,
    "verified": true,
    "login": "[email protected]",
    "first_name": "John",
    "middle_name": "William",
    "last_name": "Smith",
    "legal_name": "E. Biasi GmbH",
    "legal_type": "legal_entity",
    "phone": "491761234567",
    "post_country": "Germany",
    "post_index": "61169",
    "post_region": "Hessen",
    "post_city": "Wiesbaden", 
    "post_street_address": "Marienplatz 2",
    "registered_country": "Germany",
    "registered_index": "61169",
    "registered_region": "Hessen",
    "registered_city": "Wiesbaden",
    "registered_street_address": "Marienplatz 2",
    "state_reg_num": "12-3456789",
    "tin": "1131145180",
    "okpo_code": "93281776",
    "iec": "773101001",
    "id": 38935,
    "balance" : 10.01,
    "bonus": 0,
    "creation_date" : "2021-03-01 13:00:00",
    "trackers_count": 10
}
  • dealer_id - int. Dealer ID.
  • activated - boolean. true if user activated (allowed to login).
  • verified - boolean. true if user's email verified.
  • login - string. User email as login. Must be valid unique email address.
  • first_name - string. Contact person first name.
  • middle_name - string. Contact person middle name.
  • last_name - string. Contact person last name.
  • legal_name - string. User legal name (for "legal_entity" only).
  • legal_type - enum. Can be "legal_entity", "individual" or "sole_trader".
  • phone - string. Contact phone 10-15 digits without "+" sign.
  • post_country - string. Country part of user's post address.
  • post_index - string. Index part of user's post address.
  • post_region - string. Region part of user's post address.
  • post_city - string. City from postal address.
  • post_street_address - string. Street address.
  • registered_country - string. Country part of user's registered address.
  • registered_index - string. Index part of user's registered address.
  • registered_region - string. Region part of user's registered address.
  • registered_city - string. City from registered address.
  • registered_street_address - string. User's registered address.
  • state_reg_num - string. State registration number. E.g. EIN in USA, OGRN in Russia. 15 characters max.
  • tin - string. Taxpayer identification number aka "VATIN".
  • okpo_code - string, optional. All-Russian Classifier of Enterprises and Organizations, used in Russia for "legal_entity" or "sole_trader".
  • iec - string, optional. Industrial Enterprises Classifier aka "KPP" (used in Russia. for "legal_entity" only).
  • id - int. User id. Next fields are read-only, they should not be used in user/update and user/create.
  • balance - double. User balance.
  • bonus - double. User bonus balance.
  • creation_date - date/time. Date and time when user created, in UTC.
  • trackers_count - user trackers count.

Discount object structure

{
    "value": 5.5,
    "min_trackers": 10,
    "end_date": "2021-03-01",
    "strategy": "sum_with_progressive"
}
  • value - double. Personal discount percent, min 0 max 100.
  • min_trackers - int. Minimum active trackers to apply discount, min 0.
  • end_date - date/time. Discount end date, null means open date, nullable.
  • strategy - enum. One of "no_summing", "sum_with_progressive".\

change_password

Changes password of a user.

required permissions: users: "update".

parameters

name description type
user_id Id of a user. int
password User's new password, 6 to 20 printable characters. string

example

curl -X POST 'https://api.navixy.com/v2panel/user/change_password' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "user_id": 231432 "password": "[email protected]$"}'

response

{
    "success": true
}

errors

  • 201 – Not found in the database - if specified user does not exist or belongs to different dealer.

corrupt

Marks user and its sub users and trackers as deleted and corrupt all user trackers.

required permissions: users: "corrupt".

parameters

name description type
user_id User id. int
login Login of a user. Login parameter must match user login. string

example

curl -X POST 'https://api.navixy.com/v2panel/user/corrupt' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "user_id": 231432 "login": "[email protected]"}'

response

{
    "success": true
}

errors

  • 201 – Not found in the database - if a user not found.
  • 252 – Device already corrupted - if some of user's tracker already corrupted.
  • 253 – Device has clones - if some of user's tracker has a clone.
{
    "success": false,
    "status": {
        "code": 253,
        "description": "Device has clones"
    }
}

create

Creates a new user.

required permissions: [users: "corrupt", "global"].

  • users: "global" - Optional. Allows creating users of users, not only owned by a current dealer (use user.dealer_id parameter for other owners).

parameters

name description type
user User object without the "id", "dealer_id" and read-only fields. JSON object
time_zone User timezone. string
locale User locale. string
password User password, 6 to 20 printable characters. string
discount Discount object. JSON object

If user.verified not passed then it set equal to user.activated.

example

curl -X POST 'https://api.navixy.com/v2panel/user/create' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "user": {"activated": true, "verified": true, "login": "[email protected]", "first_name": "John", "middle_name": "William", "last_name": "Smith", "legal_name": "E. Biasi GmbH", "legal_type": "legal_entity", "phone": "491761234567", "post_country": "Germany", "post_index": "61169", "post_region": "Hessen", "post_city": "Wiesbaden", "post_street_address": "Marienplatz 2", "registered_country": "Germany", "registered_index": "61169", "registered_region": "Hessen", "registered_city": "Wiesbaden", "registered_street_address": "Marienplatz 2", "state_reg_num": "12-3456789", "tin": "1131145180", "okpo_code": "93281776", "iec": "773101001"}, "time_zone": "Europe/Moscow", "locale": "en_US", "password": "[email protected]$", "discount": {"value": 5.5, "min_trackers": 10, "end_date": null, "strategy": "sum_with_progressive"}}'

response

{
    "success": true, 
    "id" : 15534
}
  • id - int. An id of the created user.

errors

  • 206 - Login already in use – if this email already registered.

export

Returns list of all users belonging to dealer as file.

If filter is used (parameter filter is passed, it isn't empty and does not consist only of space characters), entities will be returned only if filter string is contained within one of the following fields: id, login, last_name, first_name, middle_name, phone, post_city, post_region, post_country, post_index, post_street_address, registered_country, registered_index, registered_region, registered_city, registered_street_address, tin, iec, legal_name.

required permissions: users: "read".

parameters

name description type
filter Optional. Text filter string. string
order_by Optional. Specify list ordering. May be one of: id, login, last_name, balance, bonus, phone, post_city. Default is id. string
ascending Optional. If true, ordering will be ascending, descending otherwise. Default is true. boolean
limit Optional. Max number of records to return, used for pagination. int
offset Optional. Starting offset, used for pagination. Default is 0. int
hide_inactive Optional. If true only activated users will be returned. Default is false. boolean
format Optional. Format of exported list. Can be xlsx or csv. Default is xlsx. string
columns Optional. A list of columns to export. Default is ["id", "login", "first_name", "middle_name", "last_name", "phone"] string array

About user object structure see above.

examples

curl -X POST 'https://api.navixy.com/v2/panel/user/export' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "fa7bf873fab9333144e171372a321b06"}'
https://api.navixy.com/v2/panel/user/export?hash=fa7bf873fab9333144e171372a321b06

response

XLSX or CSV file download starts.

errors

list

Returns a list of all users belonging to dealer.

If filter is used (parameter filter is passed, it is not empty and does not consist only of space characters), entities will be returned only if filter string is contained within one of the following fields: id, login, last_name, first_name, middle_name, phone, post_city, post_region, post_country, post_index, post_street_address, registered_country, registered_index, registered_region, registered_city, registered_street_address, tin, iec, legal_name.

required permissions: users: "read".

parameters

name description type
filter Optional. Text filter string. string
order_by Optional. Specify list ordering. May be one of: id, login, last_name, balance, bonus, phone, post_city. Default is id. string
ascending Optional. If true, ordering will be ascending, descending otherwise. Default is true. boolean
limit Optional. Max number of records to return, used for pagination. int
offset Optional. Starting offset, used for pagination. Default is 0. int
hide_inactive Optional. If true only activated users will be returned. Default is false. boolean

examples

curl -X POST 'https://api.navixy.com/v2/panel/user/list' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "fa7bf873fab9333144e171372a321b06"}'
https://api.navixy.com/v2/panel/user/list?hash=fa7bf873fab9333144e171372a321b06

response

{
    "success": true,
    "list" : [{ 
      "dealer_id": 5001,
      "activated": true,
      "verified": true,
      "login": "[email protected]",
      "first_name": "John",
      "middle_name": "William",
      "last_name": "Smith",
      "legal_name": "E. Biasi GmbH",
      "legal_type": "legal_entity",
      "phone": "491761234567",
      "post_country": "Germany",
      "post_index": "61169",
      "post_region": "Hessen",
      "post_city": "Wiesbaden", 
      "post_street_address": "Marienplatz 2",
      "registered_country": "Germany",
      "registered_index": "61169",
      "registered_region": "Hessen",
      "registered_city": "Wiesbaden",
      "registered_street_address": "Marienplatz 2",
      "state_reg_num": "12-3456789",
      "tin": "1131145180",
      "okpo_code": "93281776",
      "iec": "773101001",
      "id": 38935,
      "balance" : 10.01,
      "bonus": 0,
      "creation_date" : "2021-03-01 13:00:00",
      "trackers_count": 10
    }],
    "count" : 1
}
  • list - array of JSON objects. A list of user objects.
  • count - int. Total number of records (ignoring offset and limit).

errors

read

Returns user info by its id.

required permissions: users: "read".

parameters

name description type
user_id An id of a user to read. int

examples

curl -X POST 'https://api.navixy.com/v2/panel/user/read' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "user_id": 231485}'
https://api.navixy.com/v2/panel/user/read?hash=fa7bf873fab9333144e171372a321b06&user_id=231485

response

{
    "success": true,
    "value" : { 
        "dealer_id": 5001,
        "activated": true,
        "verified": true,
        "login": "[email protected]",
        "first_name": "John",
        "middle_name": "William",
        "last_name": "Smith",
        "legal_name": "E. Biasi GmbH",
        "legal_type": "legal_entity",
        "phone": "491761234567",
        "post_country": "Germany",
        "post_index": "61169",
        "post_region": "Hessen",
        "post_city": "Wiesbaden", 
        "post_street_address": "Marienplatz 2",
        "registered_country": "Germany",
        "registered_index": "61169",
        "registered_region": "Hessen",
        "registered_city": "Wiesbaden",
        "registered_street_address": "Marienplatz 2",
        "state_reg_num": "12-3456789",
        "tin": "1131145180",
        "okpo_code": "93281776",
        "iec": "773101001",
        "id": 38935,
        "balance" : 10.01,
        "bonus": 0,
        "creation_date" : "2021-03-01 13:00:00",
        "trackers_count": 10
    },
    "discount": {
        "value": 5.5,
        "min_trackers": 10,
        "end_date": "2021-03-01",
        "strategy": "sum_with_progressive"
    }
}

errors

  • 201 - Not found in the database – when user with specified id not found or belongs to other dealer.

update

Updates existing user with new field values (see user object). User must exist and must belong to authorized dealer. Changing of legal_type is not permitted, i.e. this field will not be changed.

required permissions: users: "update".

parameters

name description type
user User object without read-only fields. JSON object
discount Discount object. JSON object

If user.verified not passed then it set equal to user.activated.

example

curl -X POST 'https://api.navixy.com/v2panel/user/update' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "user": {"dealer_id": 5001, "activated": true, "verified": true, "login": "[email protected]", "first_name": "John", "middle_name": "William", "last_name": "Smith", "legal_name": "E. Biasi GmbH", "legal_type": "legal_entity", "phone": "491761234567", "post_country": "Germany", "post_index": "61169", "post_region": "Hessen", "post_city": "Wiesbaden", "post_street_address": "Marienplatz 2", "registered_country": "Germany", "registered_index": "61169", "registered_region": "Hessen", "registered_city": "Wiesbaden", "registered_street_address": "Marienplatz 2", "state_reg_num": "12-3456789", "tin": "1131145180", "okpo_code": "93281776", "iec": "773101001", "id": 38935}, "discount": {"value": 5.5, "min_trackers": 10, "end_date": null, "strategy": "sum_with_progressive"}}'

response

{
    "success": true
}

errors

  • 201 - Not found in the database – if specified user does not exist or belongs to different dealer.
  • 206 - Login already in use – if specified "login" is used by another user.

session/create

Creates an interface session for specified user and returns the hash for the created session.

required permissions: [users: "update", user_sessions: ["create", "global"].

user_sessions: "global" - Optional. Allows sessions of users creation, not only owned by a current dealer.

parameters

name description type
user_id An id of a user to create session. int

examples

curl -X POST 'https://api.navixy.com/v2/panel/user/session/create' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "user_id": 231485}'
https://api.navixy.com/v2/panel/user/session/create?hash=fa7bf873fab9333144e171372a321b06&user_id=231485

response

{
    "success": true,
    "hash" : "a2caa32267f028bd41b982980467132c"
}
  • hash - string. Hash of the created session.

errors

  • 201 - Not found in the database – if specified user does not exist or belongs to different dealer.

transaction/change_balance

Changes user balance (increase or decrease) or bonus and write this change in transactions (type = payment, subtype = partner).

New balance (bonus) must be not negative.

required permissions: [users: "update", transactions: "create"].

parameters

name description type
user_id An id of user whom balance changed. int
amount Amount to change. Can be negative. double (2 digits after decimal mark)
type Type of balance to change. Can be "balance" or "bonus". enum
text Description of transaction. string (min length is 5 chars)

example

curl -X POST 'https://api.navixy.com/v2/panel/user/transaction/change_balance' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "user_id": 231485, "amount": 2.05, "type": "balance", "text": "additional payment"}'

response

{
    "success": true
}

errors

  • 201 – Not found in the database – if user not found or not owned by a current dealer.
  • 251 – Insufficient funds(403) – if user have not enough funds to withdraw passed (negative) amount.

list

Gets list of user's billing transactions for the specified period. Same as /transaction/list from main api.

required permissions: [users: "read", transactions: "read"].

parameters

name description type
user_id An id of user whom transactions listed. must be owned by a current dealer. int
from Start date/time for searching. date/time
to End date/time for searching. Must be after "from" date. date/time
limit Optional. A maximum number of the returned transactions. int

example

curl -X POST 'https://api.navixy.com/v2/panel/user/transaction/list' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "fa7bf873fab9333144e171372a321b06", "user_id": 231485, "from": "2020-02-03 03:04:00", "to": "2021-02-03 03:04:00"}'

response

{
  "success": true, 
  "list": [{
    "description": "Recharge bonus balance during tracker registration",
    "type": "bonus_charge",
    "subtype": "register",
    "timestamp": "2021-01-28 08:16:40",
    "user_id": 12203,
    "dealer_id": 5001,
    "tracker_id": 303126,
    "amount": -10.0000,
    "new_balance": 800.0000,
    "old_balance": 810.0000,
    "bonus_amount": 10.0000,
    "new_bonus": 10.0000,
    "old_bonus": 0.0000
  }]
}
  • list - array of objects. List of transaction objects.
    • description - string. Transaction description.
    • type - enum. Type of transaction.
    • subtype - enum. Subtype of transaction.
    • timestamp - date/time. When transaction created.
    • user_id - int. ID of a user which made a transaction.
    • dealer_id - int. ID of a dealer.
    • tracker_id - int. Tracker id. 0 if transaction not associated with tracker.
    • amount - double. Amount of money in transaction, can be negative. e.g. -10.0000 means 10 money units removed from user`s balance.
    • new_balance - double. User`s money balance after transaction.
    • old_balance - double. User`s money balance before transaction.
    • bonus_amount - double. Amount of bonus used in transaction, can be negative. e.g. 10.0000 means 10 bonuses units added to user`s bonus balance.
    • new_bonus - double. User`s bonus balance after transaction.
    • old_bonus - double. User`s bonus balance before transaction.

errors

  • 201 – Not found in the database - if user not found or not owned by a current dealer.

Last update: March 10, 2021