The Application Group IaC Scan Get API retrieves discovery information for an Application Group.

Retrieves IaC scan discovery information for an Application Group.

  • scan-type: Specifies the type of discovery to retrieve. Use 'active' for current active discovery (returns single discovery) or 'backup' for backup discovery recovery points (returns historical discoveries). Defaults to 'active'.
  • When recoverydatetime is provided and timewindow is omitted, the given scan-type is honored (default is 'active'). Use scan-type=backup to get backup recovery points at that time; scan-type=active returns current active discovery and recoverydatetime is ignored.
  • When timewindow is provided and is greater than zero, the backup collection is queried (scan-type is treated as backup).
  • When scan-type is 'active' and recoverydatetime is not provided: Returns the current active discovery from the regular collection. timewindow and aggregated parameters are ignored.
  • When scan-type is 'backup' or recoverydatetime is provided: Returns backup discovery recovery points from the time-series collection.
    • When recoverydatetime is not provided, returns the latest backup discovery.
    • When recoverydatetime is provided, returns recovery points (discovery timestamps) within the specified time window.
    • recoverydatetime: Start time in ISO 8601 format (e.g., "2025-01-27T00:00:00Z") for filtering recovery points. When specified, automatically routes to backup mode. Required if timewindow is specified.
    • timewindow: Duration in days for the time window. If set to 0, returns discoveries at the exact recoverydatetime timestamp (0-day window). If not provided, defaults to 0 (exact timestamp match). When timewindow is provided and greater than zero, the backup collection is queried (scan-type is backup). Note: timewindow can only be used when recoverydatetime is specified.
    • aggregated: If true, returns aggregated recovery point data grouped by repository ID. If false or omitted, returns individual recovery points.
  • page: Page number for pagination (default: 1, minimum: 1). Only applies when both recoverydatetime and timewindow are provided.
  • limit: Maximum number of items per page (default: 20, minimum: 1, maximum: 1000). Only applies when both recoverydatetime and timewindow are provided.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The Application Group ID.

Query Params
string
enum
Defaults to active

Specifies the type of discovery to retrieve. Use 'active' for current active discovery or 'backup' for backup discovery recovery points. Defaults to 'active'.

Allowed:
boolean
Defaults to false

If true, returns aggregated recovery point data grouped by repository ID. If false or omitted, returns individual recovery points. Only applies when scan-type is 'backup'.

date-time
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$

Start time in ISO 8601 format (e.g., "2025-01-27T00:00:00Z") for filtering recovery points. If not provided, returns the latest IaC scan.

int64
≥ 0
Defaults to 0

Duration in days for the time window. Required: recoverydatetime must be specified when using timewindow; the API returns 400 Bad Request if timewindow is provided without recoverydatetime. If set to 0, returns discoveries at the exact recoverydatetime timestamp (0-day window). Defaults to 0 (exact timestamp match) if not specified (when recoverydatetime is provided). When provided and greater than zero, the backup collection is queried by default (scan-type is backup).

integer
≥ 1
Defaults to 1

Page number for pagination (default: 1). Only applies when both recoverydatetime and timewindow are provided.

integer
1 to 1000
Defaults to 20

Maximum number of items per page (default: 20, max: 1000). Only applies when both recoverydatetime and timewindow are provided.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json