# getIncomingFilesRequests

Version: 4.1.0+

Description: get the list of downloaded files and new inbound file requests.

Request example:

{
    "method": "getIncomingFilesRequests",
    "requestId" : "1"
}

Response example:

{
    "method": "getIncomingFilesRequests",
    "requestId" : "1",
    "incomingFilesRequests": [
        {
            "fileRequestId": "8e9dc8cc-fd65-47c0-8474-a4042bbbb395",
            "peerId": "820_1@some.server",
            "peerDn": "820_1",
            "fileName": "2.jpg",
            "size": 3200,
            "status": 1,
            "timestamp": 1659249467212
        },
        {
            "fileRequestId": "3fbbe5c1-a9c2-413e-9564-a485a018bd13",
            "peerId": "820_1@some.server",
            "peerDn": "820_1",
            "fileName": "3.png",
            "size": 7701,
            "status": 1,
            "timestamp": 1659249491211,
            "confId": "0000016f35f42ef6@some.server#vcs"
        }
    ],
    "result": true
}

Parameter description:

  • incomingFilesRequests — the list of requests

  • fileRequestId — Request identifier

  • peerId — Unique identifier (TrueConf ID) of a user who sent a file

  • peerDn — Display name of a user who sent a file

  • fileName — File name

  • size — File size in bytes.

  • timestamp — the timestamp indicating when the file request was created

  • confId — the unique identifier of the session during which the file request was made. The parameter is not included for the files sent outside group conferences.

  • status — the status of a file request. The following statuses are possible:

    • 0 — Internal failure

    • 1 — waiting for a reply to the request

    • 2 — the request has been accepted; the file is being downloaded

    • 3 — the request has been processed

  • requestId - a unique request identifier. You can learn more about it here.

See also: