SPsponsorunited
Brand Competitors

List brand competitor review items

Paginated list of review items produced by the brand-competitor matching pipeline. Requires approve-company permission.

get/api/admin/brand-competitors/review-items

Request

Query parameters

status'pending' | 'approved' | 'rejected' | 'superseded'

Filter by review status. Defaults to pending.

source_brand_idinteger
Example:4711

Filter by source brand id (companies.id).

qstring
Example:coca

Substring search over raw_competitor_name / normalized_name.

order_by'last_seen_at' | 'first_seen_at' | 'suggested_score'

Sort column. Default: last_seen_at.

order_direction'asc' | 'desc'

Sort direction. Default: desc.

pageinteger
Example:1
per_pageinteger
Example:25

Response

Paginated review items.

current_pageinteger
first_page_urlstring nullable
frominteger nullable
last_pageinteger
last_page_urlstring nullable
next_page_urlstring nullable
pathstring nullable
per_pageinteger
prev_page_urlstring nullable
tointeger nullable
totalinteger

Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 12345,
      "raw_competitor_name": "Pepsi Inc.",
      "normalized_name": "pepsi",
      "suggested_score": 87,
      "status": "pending",
      "ingestion_run_id": "01HFK8MZ4Y3R6XPC8KH3D2VVPS",
      "first_seen_at": "2026-05-20T14:32:11+00:00",
      "last_seen_at": "2026-05-24T08:11:02+00:00",
      "source_brand": {
        "id": 4711,
        "name": "Coca-Cola Company"
      },
      "suggested_target": {
        "id": 9001,
        "name": "Pepsi"
      },
      "resolution_brand": {
        "id": 9001,
        "name": "Pepsi"
      },
      "resolved_by": {
        "id": 42,
        "name": "Jane Reviewer",
        "email": "jane@sponsorunited.com"
      },
      "candidates": [
        {
          "id": 9001,
          "name": "Pepsi",
          "score": 87,
          "exists": true
        }
      ],
      "matcher_version": "v1"
    }
  ],
  "from": 1,
  "last_page": 12,
  "per_page": 25,
  "to": 25,
  "total": 287
}

Changes

No recorded changes to this operation across all 2 revisions of this API.