---
title: "List active meter ads by partner ID"
method: GET
path: "/v1/meter-ads/active"
tags: ["meter-ads"]
---

# List active meter ads by partner ID

`GET /v1/meter-ads/active`

Returns an array of active meter ads for a given partner ID. If no partner ID is provided, the default partner ID is used. Active means that the status is "published", the start date is in the past, and the end date is in the future.

## Query parameters

- `partnerId` string
- `url` string

## Response `200`

An array of MeterAd entities

- MeterAd[]
  - `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

---

[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)