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.
| Header | Value |
|---|---|
ETag | Id of the report in double quotes, for example "jB47D". Send it back in the If-None-Match header to check whether a newer report is available |
Last-Modified | Date and time the report was generated, as an HTTP date in GMT |
Cache-Control | no-store |
X-Xeneta-Report-Id | Id of the report |
X-Xeneta-Configuration-Version | Version of the configuration the report was generated from |
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"
}