The report object

The report object describes one Datalink report and carries a short-lived link to download it. It is returned by a GET request to the /datalink/report endpoint.

Attributes

report_id

string Id of the report. Pass it as report_id to request this report again, or in the If-None-Match header to check whether a newer report is available. See Polling for new reports.

configuration_id

string Id of the Datalink configuration the report was generated from.

configuration_version

integer Version of the configuration the report was generated from.

created_at

string Date and time the report was generated, in UTC, in the YYYY-MM-DDTHH:MM:SSZ format.

format

string File type of the report: csv, xlsx or zip. Air reports are delivered as ZIP archives, so use format rather than the output file format of the configuration to name the downloaded file.

url

string Link that downloads the report file. The link is valid for 300 seconds and does not need your API key or any other header. It supports range requests, so you can resume an interrupted download. Once the link has expired, call the endpoint again to get a new one.

url_expires_at

string Date and time url expires, in UTC, in the YYYY-MM-DDTHH:MM:SSZ format.

File name

The file is served under the name of the configuration and the day the report was generated, <configuration name> Result File <YYYY-MM-DD>.<format>. For example, Asia to Europe Result File 2026-09-24.csv. Browsers and clients that use the server-provided file name, such as curl -OJ, save the file under this name.

Response headers

Every 200 and 304 response carries the following headers, including responses to HEAD requests.

Body

{
  "report_id": "jB47D",
  "configuration_id": "xArk",
  "configuration_version": 1,
  "created_at": "2026-09-24T06:00:12Z",
  "format": "csv",
  "url": "https://…amazonaws.com/…?X-Amz-Expires=300&…",
  "url_expires_at": "2026-09-25T09:05:00Z"
}