---
title: "List meter ads, filtered by search terms and sort options."
method: GET
path: "/v1/admin/meter-ads"
tags: ["meter-ads"]
---

# List meter ads, filtered by search terms and sort options.

`GET /v1/admin/meter-ads`

## Query parameters

- `partnerId` string
- `questionText` string
- `marketingText` string
- `status` 'DRAFT' | 'PUBLISHED' | 'CANCELLED'
- `startTime` TimeComparison
  - `value` number, required — Unix timestamp in milliseconds
  - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'neq', required — Comparison operator to apply
- `endTime` TimeComparison
  - `value` number, required — Unix timestamp in milliseconds
  - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'neq', required — Comparison operator to apply
- `sort` SortOptionsDto
  - `status` 'ASC' | 'DESC' — Sort direction for status
  - `partnerId` 'ASC' | 'DESC' — Sort direction for partnerId
  - `startTime` 'ASC' | 'DESC' — Sort direction for startTime
  - `endTime` 'ASC' | 'DESC' — Sort direction for endTime
  - `questionText` 'ASC' | 'DESC' — Sort direction for questionText
  - `marketingText` 'ASC' | 'DESC' — Sort direction for marketingText
- `page` number
- `pageSize` number

## Response `200`

A paginated list of MeterAd entities

- PaginatedMeterAdsDto
  - `items` MeterAd[], required
    - `id` string, required
    - `partnerId` string, required
    - `startTime` number, required — Unix timestamp in milliseconds
    - `endTime` number, required — Unix timestamp in milliseconds
    - `questionText` string, required
    - `marketingText` string
    - `sideA` object
      - `label` string, required — Label for side A
      - `percentage` number, required — Percentage allocated to side A (0-100)
      - `assetUrl` string, required — URL to the asset for side A
    - `sideB` object
      - `label` string, required — Label for side B
      - `percentage` number, required — Percentage allocated to side B (0-100)
      - `assetUrl` string, required — URL to the asset for side B
    - `status` 'DRAFT' | 'PUBLISHED' | 'CANCELLED', required
    - `createdAt` string, date-time, required — Unix Timestamp in milliseconds of when the record was created
    - `updatedAt` string, date-time, required — Unix Timestamp in milliseconds of when the record was last updated
    - `url` string, required
  - `total` number, required
  - `page` number, required
  - `pageSize` number, required
  - `pageCount` number, required

---

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