Bid event logs

Returns information about each available hourly log, including the time when it was generated, its expiry, its file size, and a download link.

Response values

The following array of availableDownloads objects is returned:

Parameter

Type

Description

subscriptionID

integer

Provides the unique identifier used to distinguish files created for different subscriptions.

subscriptionName

string

Provides the human-readable name of the subscription this file was generated under.

hour

string

Provides the file containing data for this particular hour. It uses the RFC 3339 date format. Values are in UTC (Universal Coordinated Time).

parts

array of objects

Provides an array of parts objects, containing the following:
dateCreated (string) = Provides the date and time when the client audit log file was generated.
expires (string) = Provides the date and time when the client audit log file expires.
fileSize (integer) = Provides the size of the file in bytes.
downloadURL (string) = Provides the download link to download a particular file.
md5sum (string) = Provides the MD5 checksum. To check for an error during download, calculate the MD5 checksum of the downloaded log file and compare it to the checksum in the response from step 1. If they don't match, try the download again.
downloadStatus (string) = Specifies whether the file is newly available, has already been downloaded, or has been updated since the last time it was downloaded. The possible values are:
new
updated
downloaded

Note: If there are late arrivals after the file is downloaded, we'll indicate this by flipping downloadStatus to updated. If there's a late arrival and the download hasn't happened yet, the downloadStatus remains new.
Note: The updated downloadStatus value will not be seen on bid logs. Late arrivals are instead added to a new part/file.

Language