---
title: "List all Scheduled Scans"
method: POST
path: "/v1/autoscans/"
tags: ["Scans & Reports"]
---

# List all Scheduled Scans

`POST /v1/autoscans/`

Allows you to retrieve a list of all Auto Scans associated with your Local Falcon account.

If more records exist than is allowed within the set `limit`, a value will be returned under `next_token` that can be used as a parameter to request the next page of results.

## Response `200`

Successful response

- object
  - `code` integer
  - `code_desc` boolean
  - `success` boolean
  - `message` boolean
  - `parameters` object
  - `data` object
    - `count` integer
    - `next_token` string
    - `autoscans` object[]
      - `id` string
      - `autoscan_key` string
      - `nickname` union
        - string
        - boolean
      - `place_id` string
      - `location` object
        - `place_id` string
        - `name` string
        - `address` string
        - `lat` string
        - `lng` string
        - `rating` string
        - `reviews` string
        - `store_code` union
          - string
          - boolean
      - `keyword` string
      - `lat` string
      - `lng` string
      - `grid_size` string
      - `radius` string
      - `measurement` string
      - `data_points` string
      - `frequency` string
      - `last_run_timestamp` string
      - `last_run_date` string
      - `next_run_timestamp` union
        - string
        - boolean
      - `next_run_date` union
        - string
        - boolean
      - `status` string

## Other responses

- `400` — The request was malformed or missing required parameters.
- `401` — The API key is missing, invalid, or does not have permission for the requested resource.
- `429` — You have exceeded the rate limit. Please wait before making additional requests.
- `500` — An unexpected error occurred on the server. Please try again later.

---

[API](https://skmtc.net/localfalcon/apis/local-falcon-api.md) · [All operations](https://skmtc.net/localfalcon/apis/local-falcon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/localfalcon/local-falcon-api/revisions/06b5d428ba9e/schema)