---
title: "Claim badge tag reviews"
method: POST
path: "/v1/badge.claimTagReviews"
tags: ["badge"]
---

# Claim badge tag reviews

`POST /v1/badge.claimTagReviews`

## Request body

- BadgeClaimTagReviewsRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `limit` integer — Maximum number of reviews to claim. Defaults to 10.

## Response `200`

OK

- BadgeClaimTagReviewsResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `apps` BadgeClaimTagReviewsApp[], nullable, required
    - `appId` integer, required
    - `appName` string, required
    - `badges` BadgeClaimTagReviewsBadge[], nullable, required
      - `badgeId` string, required
      - `claimedUntil` string, date-time, required
      - `imageUrl` string, required
      - `isFoil` boolean, required
      - `level` integer, required
      - `name` string, required
      - `scarcity` integer, required — Number of tracked accounts that crafted this badge.
      - `suggestions` BadgeClaimTagReviewsSuggestions, required
        - `autoAudit` boolean, required — This prediction was sampled for scout audit instead of being auto-confirmed.
        - `autoColors` BadgeClaimTagReviewsColorSuggestion[], nullable, required — Already confirmed by the enabled auto-confirm color tier.
          - `coverage` number, double, required
          - `id` string, required
        - `autoDesigns` BadgeClaimTagReviewsDesignSuggestion[], nullable, required — Already confirmed by the enabled auto-confirm design tier.
          - `confidence` number, double, required
          - `id` string, required
        - `colors` BadgeClaimTagReviewsColorSuggestion[], nullable, required
          - `coverage` number, double, required
          - `id` string, required
        - `designs` BadgeClaimTagReviewsDesignSuggestion[], nullable, required
          - `confidence` number, double, required
          - `id` string, required
        - `proposedDesigns` string[], nullable, required
  - `colors` BadgeClaimTagReviewsColor[], nullable, required
    - `hex` string[], nullable, required
    - `id` string, required
    - `name` string, required
  - `designs` BadgeClaimTagReviewsDesign[], nullable, required
    - `id` string, required
    - `name` string, required
  - `metadata` BadgeClaimTagReviewsDesign[], nullable, required
    - `id` string, required
    - `name` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.dev/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/revisions/9930915a1df9/schema)