Query Delivery HTTP Status Code
Query HTTP status code of delivery requests.
Request
Request-Line
GET /lls/v1.0/analytics/delivery/httpCode
Request Parameters
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domains | Array | Mandatory | Array of delivery domains. |
| 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 HTTP Code Summary Object. |
Object: HTTP Code Summary
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | String | Mandatory | Delivery domain name. |
| httpCodes | Array | Mandatory | Array of HTTP Code Object. |
Object: HTTP Code
| Parameter | Type | Required | Description |
|---|---|---|---|
| timestamp | Timestamp | Mandatory | Exampling timestamp in UTC timezone. |
| httpCodeValues | Map | Mandatory | A group of key-value pairs. Each pair contains HTTP Code as the key and the count of the requests as the value. |
Status Codes, Error Codes and Error Messages
| Status Code | Error Code | Error Message |
|---|---|---|
| 400 | LLS.Analytics.InvalidTimestamp | Timestamp is empty or invalid. |
Examples
Request
GET /lls/v1.0/analytics/delivery/httpCode?domains=live.example.com&domains=live2.example.com&started=20250518T173000Z&ended=20250518T174000Z
Successful Response Body
[
{
"domain": "live.example.com",
"httpCodes": [
{
"timestamp": "20250518T173000Z",
"httpCodeValues": {
"200": 23248,
"401": 23,
"404": 4239
}
},
{
"timestamp": "20250518T173500Z",
"httpCodeValues": {
"200": 324832,
"401": 53,
"404": 5232
}
},
{
"timestamp": "20250518T174000Z",
"httpCodeValues": {
"200": 53322,
"401": 123,
"404": 283
}
}
]
},
{
"domain": "live2.example.com",
"httpCodes": [
{
"timestamp": "20250518T173000Z",
"httpCodeValues": {
"200": 42423,
"401": 23,
"404": 4239
}
},
{
"timestamp": "20250518T173500Z",
"httpCodeValues": {
"200": 534533,
"401": 53,
"404": 5232
}
},
{
"timestamp": "20250518T174000Z",
"httpCodeValues": {
"200": 24365,
"401": 123,
"404": 283
}
}
]
}
]
Best Practices
Rate Limiting
Rate Limits
Rate limiting is posed upon the API, check API calls to comply with the rate limit below:
- 100 requests per minute
- 1000 requests per hour