List Delivery Log Files

List delivery logs and download URLs with a data sample of 5 minutes. If there are no logs in the 5-minute slot, the values array will be set to empty.

Request

Request-Line

GET /lls/v1.0/logs/delivery

Request Parameters

Query Parameters

Parameter	Type	Required	Description
domain	Array	Mandatory	Array of delivery domain names.
started	Timestamp	Mandatory	Timestamp of started time. Format yyyyMMddTHHmmssZ UTC time.
ended	Timestamp	Mandatory	Timestamp of ended time. Format yyyyMMddTHHmmssZ UTC time. Interval between start time and end time cannot be longer than 24 hours.

Response

Response Body

Parameter	Type	Required	Description
--	Array	Mandatory	Array of domains' logs. refer to Domains' Logs Object

Object: Domains' Logs

Parameter	Type	Required	Description
domain	String	Mandatory	domain name.
logs	Array	Mandatory	Array of logs. refer to Domain Log Object

Object: Domain Log

Parameter	Type	Required	Description
timestamp	String	Mandatory	Format yyyy-MM-ddTHH:mm:ssZ UTC time. E.g. 2025-03-29T17:35:00Z will return data from 2025-03-29T17:35:00Z to 2025-03-29T17:39:59Z.
values	Array	Mandatory	Array of log files. refer to Log File Object

Object: Log FIle

Parameter	Type	Required	Description
name	String	Mandatory	Log file name.
url	Array	Mandatory	Downloading URL of log file.
size	Long	Mandatory	Log file's size. Unit is byte.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	LLS.Domain.NotFound	Domain name is not found.

Examples

List Log Files

Request

GET /lls/v1.0/logs/delivery?domain=live.example.com&started=20250911T173000Z&ended=20250911T190000Z HTTP/1.1

Successful Response Body

[
  {
    "domain": "live.example.com",
    "logs": [
      {
        "timestamp": "2025-09-11T17:55:00Z",
        "values": [
          {
            "name": "20250911175500.log.gz",
            "url": "https://cdn-dl.swiftfederation.com/live.example.com/20250911/20250911175500.log.gz?expire=1656493304&sign=b7a786e4bae7b86ef75e7d59a64a9be4bd695c45",
            "size": 123223
          },
          {
            "name": "20250911175500-1.log.gz",
            "url": "https://cdn-dl.swiftfederation.com/live.example.com/20250911/20250911175500-1.log.gz?expire=1656493304&sign=523270e4bae7b86ef75e7d59a64a9be4bd695c45",
            "size": 123223
          },
          {
            "name": "20250911175500-2.log.gz",
            "url": "https://cdn-dl.swiftfederation.com/live.example.com/20250911/20250911175500-2.log.gz?expire=1656493304&sign=a3521b4bae7b86ef75e7d59a64a9be4bd695c45",
            "size": 123223
          }
        ]
      },
      {
        "timestamp": "2025-09-11T18:00:00Z",
        "value": [
          {
            "name": "20250911180000.log.gz",
            "url": "https://cdn-dl.swiftfederation.com/live.example.com/20250911/20250911180000.log.gz?expire=1656493304&sign=ab327814bae7b86ef75e7d59a64a9be4bd695c45",
            "size": 123223
          },
          {
            "name": "20250911180000-1.log.gz",
            "url": "https://cdn-dl.swiftfederation.com/live.example.com/20250911/20250911180000-1.log.gz?expire=1656493304&sign=361b76e4bae7b86ef75e7d59a64a9be4bd695c45",
            "size": 123223
          },
          {
            "name": "20250911180000-2.log.gz",
            "url": "https://cdn-dl.swiftfederation.com/live.example.com/20250911/20250911180000-2.log.gz?expire=1656493304&sign=eb3a26e4bae7b86ef75e7d59a64a9be4bd695c45",
            "size": 123223
          }
        ]
      }
    ]
  }
]

Best Practices

Rate Limiting

Rate Limits

Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour