v1

latestOpenAPI 3.0.02026-07-241310301.1 KB
Anomaly Detection

Get Anomalies

Retrieve the anomalies by timestamps

get/api/v1/anomaly-detection

Query parameters

startDatestring date required

date format "yyyy-MM-DD" (e.g: 2022-12-01)

endDatestring date required

date format "yyyy-MM-DD" (e.g: 2023-02-28)

exclusiveStartKeyinteger

Optional parameter to determine the page to return. When empty - the response returns the first 20 entries

Headers

Authorizationstring required
apikeystring required

Response

lastEvaluatedKeyinteger

Empty when no more entries to return

Example response

{
  "anomalies": [
    {
      "accountId": "72875123456",
      "startTime": 1777852800,
      "uuid": "0f3a-69fc-4baf-b1aa-e8bda7011dbc",
      "anomalyTriggeredItems": {
        "1778880939|369a12345678-4d65B321-173af7022e2d": {
          "percentChange": 37.25,
          "ruleUuid": "b0123456-8f01-493e-9395-bfc5aeefa921",
          "objectKey": "2026/05/15/78123456-69fc-4baf-b1aa-e8bda7011dbc.png",
          "currentCost": 54.67645222209997,
          "ruleName": "Demo Anomaly Alert",
          "recipients": "test@umbrellacost.com",
          "ruleOrganizationId": "ac000000-9f67-46bf-8fd0-50c9b7e54b15",
          "ruleAccountKey": "12345",
          "alertUuid": "36000000-d166-4d65-b321-173af7022e2d",
          "isClosed": true
        }
      },
      "anomalyType": "PATTERN_CHANGE",
      "baseline": [
        [
          1001200000
        ]
      ],
      "cloudProvider": "aws",
      "cubeletSplits": [
        {
          "dimensionName": "instance_family_type",
          "dimensionValue": "Other"
        }
      ],
      "currentCost": 132.232194262599,
      "lastDayImpact": 25,
      "dataPoints": [
        [
          0.07142857200000001
        ]
      ],
      "direction": "UP",
      "endDate": "2026-05-27",
      "endTime": 1779840000,
      "impact": 50,
      "isClosed": true,
      "linkedAccountId": "999932829999",
      "linkedAccountName": "Demo",
      "percentChange": 63.58,
      "purchaseOption": "on demand",
      "regionTagName": "us-east-2",
      "serviceName": "Amazon Elastic Compute Cloud",
      "sumAnomalyDeltas": 368.5272567948582,
      "totalCostImpact": 601,
      "updateDate": "2026-06-03",
      "usageQuantityType": "GB"
    }
  ],
  "lastEvaluatedKey": 2
}