---
title: "List AEO reports"
method: GET
path: "/api/aeo/reports"
tags: ["AEO Reports"]
---

# List AEO reports

`GET /api/aeo/reports`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/aeo/reports`
- Auth: HTTP basic

Returns the account's one-time AEO reports, newest first. `site_name` is `null` in the response, because reports don't belong to a site.

## Query parameters

- `limit` string
- `offset` string

## Response `200`

OK

- PageResponseApiAeoReportSummaryResp
  - `limit` integer: Page size applied for request
  - `offset` integer: Offset applied for request
  - `results` ApiAeoReportSummaryResp[]: Content payload
    - `brand_name` string: Name of the brand the report covers.
    - `country_code` string: The report's country, as an ISO 3166-1 alpha-2 code.
    - `created_at` string, date: Date the report was created (UTC).
    - `id` string: Report ID.
  - `site_name` string: Owning site
  - `total_responses` integer: Total amount of elements matching requested filters

## Other responses

- `400`: Bad request. `error_code` is `InvalidInput` and `errors` is empty. - `limit` is not between 1 and 500, or `offset` is negative.
- `401`: Unauthorized. The credentials are missing or invalid.
- `403`: Forbidden. `error_code` is `AccessForbidden`, and `errors[0].code` names the cause: - `AeoPlanNotFound`: the account has no active AEO plan.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)