---
title: "List of All Competitor Reports"
method: POST
path: "/v1/competitor-reports/"
tags: ["Scans & Reports"]
---

# List of All Competitor Reports

`POST /v1/competitor-reports/`

Allows you to retrieve a list of all Competitor Reports within 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
    - `reports` object[]
      - `id` string
      - `checksum` string
      - `report_key` string
      - `timestamp` string
      - `date` string
      - `looker_date` string
      - `type` string
      - `place_id` string
      - `location` object
      - `keyword` string
      - `lat` string
      - `lng` string
      - `grid_size` string
      - `radius` string
      - `measurement` string
      - `data_points` string
      - `found_in` string
      - `arp` string
      - `atrp` string
      - `solv` string
      - `image` string
      - `pdf` string
      - `public_url` 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/5487f4bd451b/schema)