# getFileTransferHistory

Version: 4.1.0+

Description: get file transfer history.

Only the files that have been fully accepted or sent will be displayed.

Request example:

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

Response example:

{
    "method": "getFileTransferHistory",
    "requestId" : "1",
    "filesRequests": [
        {
            "directionType": 0,
            "fileName": "2.jpg",
            "fileSize": 3200,
            "timestamp": 1659103698469,
            "fileRequestId": "7fbdd93e-c24f-41f2-a3e0-57d08b28f360",
            "peerDn": "820_1",
            "peerId": "820_1@some.server",
            "fileId": 346234218
        },
        {
            "directionType": 1,
            "fileName": "2.jpg",
            "fileSize": 3200,
            "timestamp": 1659251271,
            "fileRequestId": "0d99602a-82a7-4aea-9a1d-f0b612bab793",
            "peerDn": "820_1",
            "peerId": "820_1@some.server",
            "fileId": 346234218
        }
    ],
    "result": true
}

Parameter description:

  • peerId — the unique identifier (TrueConf ID) of a user. The field is available for all inbound requests. In case of outbound requests, this field is included only if the request was made outside a group conference.

  • peerDn — the user’s display name. The field is available for all inbound requests. In case of outbound requests, this field is included only if the request was made outside a group conference.

  • fileName — Original file name.

  • confId — Communication session identifier. This parameter is available in group conferences only.

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

  • directionType — File type. It can be as follows:

    • 0 — Incoming

    • 1 — Outgoing

  • fileSize — File size in bytes.

  • fileId — File identifier on the built-in HTTP server

  • filesRequests — the list of requests

  • fileRequestId — Request identifier

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

See also: