Developer API

contacts.getFolderList

Get a list of «my messages» folder with a counter of contacts

Access level: 3 - General access + Right to access user's contacts

Description:

This method returns contacts first from «Favorites» folder, and then from «Common folder» and then from the rest folders until a given limit is reached. If a total number of contacts is less than a given limit – all the contacts are displayed.

Parameters:
Name Required parameter Description
sid +
Method response:
{
    "status" : int,
    "message" : "str",
    "data": {
    "folders":
    [
    {
    "folder_id" : int, //folder id
    "title" : "Income", //Folder «Incoming»
    "contact_cnt" : int, //Number of contacts
    "message_cnt" : int, //Number of messages
    "message_unread_cnt" : int, //Number of unread messages
    },
    {
    "folder_id" : int,
    "title":"Favorite", //Folder «Favorites»
    "contact_cnt" : int,
    "message_cnt" : int,
    "message_unread_cnt" : int,
    },
    {
    "folder_id" : int,
    "title":"VipBlocked", //Folder «Ignored»
    "contact_cnt" : int,
    "message_cnt" : int,
    "message_unread_cnt" : int,
    },
    {
    "folder_id" : int, //folder id
    "title" : "str", //Folder title
    "contact_cnt" : int,
    "message_cnt" : int,
    "message_unread_cnt" : int,
    }
    ]
    }
    }