{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aws-security-hub/json-schema/aws-security-hub-get-finding-history-request-schema.json",
  "title": "GetFindingHistoryRequest",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aws-security-hub-operations-api-openapi.yml#/components/schemas/GetFindingHistoryRequest",
  "type": "object",
  "properties": {
    "FindingIdentifier": {
      "$ref": "#/$defs/AwsSecurityFindingIdentifier"
    },
    "StartTime": {
      "type": "string",
      "format": "date-time",
      "description": "A timestamp that indicates the start time of the requested finding history. If you provide values for both StartTime and EndTime, Security Hub CSPM returns finding history for the specified time period. If you provide a value for StartTime but not for EndTime, Security Hub CSPM returns finding history from the StartTime to the time at which the API is called. If you provide a value for EndTime but not for StartTime, Security Hub CSPM returns finding history from the CreatedAt timestamp of the finding to the EndTime. If you provide neither StartTime nor EndTime, Security Hub CSPM returns findin"
    },
    "EndTime": {
      "type": "string",
      "format": "date-time",
      "description": "An ISO 8601-formatted timestamp that indicates the end time of the requested finding history. If you provide values for both StartTime and EndTime, Security Hub CSPM returns finding history for the specified time period. If you provide a value for StartTime but not for EndTime, Security Hub CSPM returns finding history from the StartTime to the time at which the API is called. If you provide a value for EndTime but not for StartTime, Security Hub CSPM returns finding history from the CreatedAt timestamp of the finding to the EndTime. If you provide neither StartTime nor EndTime, Security Hub C"
    },
    "NextToken": {
      "type": "string",
      "description": "A token for pagination purposes. Provide NULL as the initial value. In subsequent requests, provide the token included in the response to get up to an additional 100 results of finding history. If you don’t provide NextToken, Security Hub CSPM returns up to 100 results of finding history for each request."
    },
    "MaxResults": {
      "type": "integer",
      "description": "The maximum number of results to be returned. If you don’t provide it, Security Hub CSPM returns up to 100 results of finding history."
    }
  },
  "required": [
    "FindingIdentifier"
  ],
  "$defs": {
    "AwsSecurityFindingIdentifier": {
      "type": "object",
      "properties": {
        "Id": {
          "type": "string",
          "description": "The identifier of the finding that was specified by the finding provider."
        },
        "ProductArn": {
          "type": "string",
          "description": "The ARN generated by Security Hub CSPM that uniquely identifies a product that generates findings. This can be the ARN for a third-party product that is integrated with Security Hub CSPM, or the ARN for a custom integration."
        }
      },
      "required": [
        "Id",
        "ProductArn"
      ]
    }
  }
}