====== get_list ======
**C → S {type:'get_list', list:..., from:..., data:...}**

Request fetch of a list from central storage on the IXNX server. Lists are different types of data at a secure, central location that survives power off. Some lists has been stored by previous [[ixnx:wrtc:rtcgate:set_list|set_list]] commands, others generated by the IXNX server.

arguments:
  * list - type of data to request:
    * "call_log" - fetch the list of calls user has made
    * "msg_log" - fetch the list of chat messages user has made
  * from - addressname of sender

optional arguments:
  * data - JSON structure containing details about the data to retrieve

**S → C {type:'get_list', list:..., data:...}**

IXNX server will return the requested list data.

Arguments:
  * list - type of requested data
  * data - JSON structure containing the requested data (see [[ixnx:wrtc:js:api:wrtc:onlist|wrtc.onList()]] for possible data formats)

===== Error =====
In case an unknown list has been requested IXNX server will send back:

S → C {type:'get_list', list:..., error:404, data:"Not Found"}

arguments:
  * list - type of requested data

====== see also ======
[[ixnx:wrtc:rtcgate:set_list|set_list]]