List scans

GET

/v2/scans

Last modified:2026-03-30 18:54:20

Get a list of scans

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2/scans?page=undefined&per_page=undefined&q=undefined&date_range_start=undefined&date_range_end=undefined&relative_date_range=undefined&sort_by=undefined&limited=undefined&extended=undefined&scheduled=undefined&status=undefined' \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Scans list

Bodyapplication/json

Examples

Normal response exampleExtended response exampleLimited response example

{
    "content": {
        "application/json": {
            "schema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "string",
                                    "format": "uuid"
                                },
                                "type": {
                                    "type": "string"
                                },
                                "attributes": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "format": "uuid"
                                        },
                                        "name": {
                                            "type": "string",
                                            "description": "Name of the scan"
                                        },
                                        "comment": {
                                            "type": "string",
                                            "description": "Comment about the scan"
                                        },
                                        "creation_time": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "modification_time": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "status": {
                                            "type": "string",
                                            "description": "Status of the scan"
                                        },
                                        "schedule_next_time": {
                                            "type": "string",
                                            "description": "Next time the scan will run",
                                            "nullable": true
                                        },
                                        "target": {
                                            "type": "object",
                                            "description": "Target of the scan",
                                            "properties": {
                                                "id": {
                                                    "type": "string",
                                                    "format": "uuid"
                                                },
                                                "name": {
                                                    "type": "string"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "meta": {
                        "$ref": "spec/requests/v2/schemas/json/metadata.json"
                    }
                }
            }
        }
    }
}

🟠401Unauthorized

Modified at 2026-03-30 18:54:20

Statistics for a scan

Create Scan