---
title: "Retrieve top items report"
method: GET
path: "/{globalCompanyId}/reports/topItems"
tags: ["Reports"]
---

# Retrieve top items report

`GET /{globalCompanyId}/reports/topItems`

Get the top X items (based on paging restriction) for the specified dimension and rsid. Defaults to last 90 days.

## Path parameters

- `globalCompanyId` string, required

## Query parameters

- `rsid` string, required
- `dimension` string, required
- `locale` string
- `dateRange` string
- `search-clause` string
- `startDate` string
- `endDate` string
- `searchAnd` string
- `searchOr` string
- `searchNot` string
- `searchPhrase` string
- `lookupNoneValues` boolean
- `limit` integer
- `page` integer

## Headers

- `Authorization` string, required
- `x-api-key` string, required

## Response `200`

Successful operation

- UnhashReportData
  - `totalPages` integer
  - `firstPage` boolean
  - `lastPage` boolean
  - `numberOfElements` integer
  - `number` integer
  - `totalElements` integer
  - `message` string
  - `reportId` string
  - `searchAnd` string
  - `searchOr` string
  - `searchNot` string
  - `searchPhrase` string
  - `oberonRequestXML` string
  - `oberonResponseXML` string
  - `rows` RowItem[]
    - `itemId` string
    - `value` string

## Other responses

- `206` — Partially successful operation. Some response columns contain errors. See the [Partial Responses](https://github.com/AdobeDocs/analytics-2.0-apis/blob/master/reporting-guide.md#partial-responses-206-status-code) for details.
- `400` — Invalid input; name, rsid, and definition are all required. Definition must be formatted as a JSON Object.

## Changes

- **2025-08-07** `f13c80692287` — 1 warning
  - deleted the `header` request parameter `x-gw-ims-org-id`
- **2025-08-06** `f49e893a6c2b` — 1 breaking
  - added the new required `header` request parameter `x-gw-ims-org-id`
- **2022-05-10** `dcd4514630c4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/adobe/apis/adobe-analytics-apis/changes/:globalCompanyId/reports/topItems/get.md)

---

[API](https://skmtc.dev/adobe/apis/adobe-analytics-apis.md) · [All operations](https://skmtc.dev/adobe/apis/adobe-analytics-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adobe/adobe-analytics-apis/revisions/b2e01ce0f30a/schema)