This endpoint gets a list of scorecards for a given workspace. It supports several filtering options through query params.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
A scorecard is a named collection of creative assets scored against a specific set of guidelines and channels. Scorecards organize your scoring activity — either as an ongoing campaign tracker or a pre-launch quality check.
Scorecard types
| Type | Description |
|---|---|
IN_FLIGHT | An active or completed campaign being tracked in real time. Media in an in-flight scorecard has real impression data. |
PRE_FLIGHT | A pre-launch quality gate. Media is checked against guidelines before going live. No impression data applies. |
Using scoreDetail
By default, the response returns scorecard metadata only. Set scoreDetail=true to include per-channel score breakdowns inline — adherencePercent, pass/fail counts, and channel-level data. This is useful for building dashboard views without needing a secondary scores call.
Filtering
The endpoint supports several query filters to narrow results:
| Parameter | Description |
|---|---|
types | IN_FLIGHT or PRE_FLIGHT |
channels | Comma-separated channel identifiers (e.g. META,TIKTOK) |
brands | Comma-separated brand identifiers |
markets | Comma-separated market identifiers |
startDate / endDate | ISO 8601 dates — filters scorecards by their campaign date range |
Finding media within a scorecard
This endpoint lists scorecards — it does not return the creatives inside them. To retrieve the media associated with a specific scorecard, use the id from this response and call GET /v1/scoring/scorecard/{scorecardId}/media-metadata.
Pagination
Default: 10 results per page, max 20. Use offset to page through large workspaces.