---
title: "Validates a campaign code for a category."
method: POST
path: "/v4/listings/validate-campaign-code"
tags: ["Listings"]
---

# Validates a campaign code for a category.

`POST /v4/listings/validate-campaign-code`

## Request body

- ValidateCampaignCodeRequest — Request body for ValidateCampaignCode endpoint.
  - `campaignCode` string, nullable — The campaign code to validate.
  - `categoryId` integer — The category ID to validate against.

## Response `200`

OK

- ValidateCampaignCodeResult
  - `isValid` boolean
  - `isInvalidBecauseDoesNotExist` boolean
  - `isInvalidBecauseHasNotStarted` boolean
  - `isInvalidBecauseHasEnded` boolean
  - `isInvalidBecauseCategoryIsNotAllowed` boolean
  - `isInvalidBecauseAlreadyUsed` boolean
  - `isInvalidBecauseUserIsNotAllowed` boolean
  - `description` string, nullable
  - `discountFactor` number, double, nullable
  - `provisionFactor` number, double, nullable
  - `maxFeeCap` number, double, nullable
  - `isCustomLengthFeeFree` boolean
  - `isUnsoldFeeFree` boolean

---

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