---
search:
  tags:
    - Scans
    - GET
seo:
  description: >-
    Scan history for the workspace, newest first, with headline metric values
    for each scan.… Reference for the GET /scans endpoint in the Zaraftis Public
    API.
sidebar:
  label: List scans
  badge: GET
title: List scans
type: openapi-operation
---
Scan history for the workspace, newest first, with headline metric values for each scan. Filter by brand_id, setup_id, status, and date range.

`GET /scans`

**Responses**

- `200` — One scan list page

Response example, 200:

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "scan_id": "9a59f0f5-5572-476d-a7fc-c960ef43a5af",
        "brand_id": "1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da",
        "brand_name": "string",
        "status": "queued",
        "triggered_by": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "completed_at": "2019-08-24T14:15:22Z",
        "country": "st",
        "language": "string",
        "platforms": [
          "string"
        ],
        "prompt_count": 0,
        "requested": 0,
        "completed": 0,
        "failed": 0,
        "setup_id": "223e7533-659b-4438-b6f4-f841a5d7dfa9",
        "setup_version_id": "46e86b42-ef3c-4109-b8e4-2fc5ae51285c",
        "setup_checksum": "string",
        "metrics": {
          "property1": {
            "value": 0,
            "quality": "complete",
            "method_version": "string"
          },
          "property2": {
            "value": 0,
            "quality": "complete",
            "method_version": "string"
          }
        }
      }
    ],
    "pagination": {
      "has_more": true,
      "next_page_token": "string"
    }
  },
  "request_id": "string"
}
```