Understanding Your File History Download

You’ve exported or downloaded your organization’s file transfer history, but some of the data may be unclear. Below is a breakdown of key terms to help you better understand your export and the information it contains.

Quick refresher on how to get your organization’s file transfer history and details:
– Once logged in, select Organization
– Then File History
– Choose your format version: JSON or CSV

1. Transfer-Level Fields (One per Transfer)

These fields describe the overall file transfer.

Field	Description	Type
transferlog.userid	Unique identifier for the user who initiated the transfer	String
transferlog.sender	Email address of the sender	String
transferlog.upload_date	Date and time the files were uploaded	DateTime
transferlog.daysuntilexpiration	Number of days the files are available before expiration	Integer
transferlog.filesetid	Unique identifier for the entire transfer	String
transferlog.message	Message entered by the sender for the transfer	String
transferlog.expired	Expiration status: blank = active, “max_retention” = expired	String
transferlog.filerequest	Indicates if the upload originated from a file request	Boolean/String

2. File-Level Fields (Repeats per File)

Each file included in a transfer generates its own set of fields. These fields repeat with an index (e.g., .0, .1, .2).

Field	Description	Type
transferlog.files.[n].status	Status of the individual file transfer	String
transferlog.files.[n].filename	Name of the file	String
transferlog.files.[n].filesize	File size in bytes	Integer
transferlog.files.[n].transferid	Unique identifier for the individual file	String
transferlog.files.[n].attachorder	Order in which the file was attached	Integer

3. Recipient-Level Fields (Repeats per Recipient)

Field	Description	Type
transferlog.recipients.[n].method	Delivery method (e.g., email)	String
transferlog.recipients.[n].downloads	Total number of downloads by the recipient	Integer
transferlog.recipients.[n].recipient	Recipient email address	String
transferlog.recipients.[n].notificationid	Unique notification ID (one per recipient)	String

Recipient Download Details

Field	Description	Type
transferlog.recipients.[n].zipdownloads.[m].downloaddate	Date and time of a download event	DateTime

4. Embedded Form Fields (Optional)

Field	Description	Type
transferlog.form	Name of the embedded form used	String

Custom Form Responses

Field	Description	Type
transferlog.response.[n].label	Label of the custom input field	String
transferlog.response.[n].response	Value entered by the user	String

5. Important Notes

• Repeating fields use indexed notation ([n], [m]).
• The CSV format expands repeated fields across columns.
• Transfers with more files or recipients will include additional indexed columns.