---
title: "Adds a new item listing. Supports auctions (itemType 1), auctions with a Buy Now price (itemType 1 plus `buyItNowPrice`) and fixed-price \"Endast Köp Nu\" listings (itemType 3). Restricted seller accounts (new or unproven sellers) may only list plain auctions with no fixed price and an end date at least 7 days out; fixed-price and Buy Now listings are rejected until the restriction is lifted. Shop items are added via `POST shop-items` instead."
method: POST
path: "/v4/listings/items"
tags: ["Listings"]
---

# Adds a new item listing. Supports auctions (itemType 1), auctions with a Buy Now price (itemType 1 plus \`buyItNowPrice\`) and fixed-price "Endast Köp Nu" listings (itemType 3). Restricted seller accounts (new or unproven sellers) may only list plain auctions with no fixed price and an end date at least 7 days out; fixed-price and Buy Now listings are rejected until the restriction is lifted. Shop items are added via \`POST shop-items\` instead.

`POST /v4/listings/items`

## Request body

- ItemRequest
  - `title` string, nullable
  - `ownReferences` string[], nullable
  - `categoryId` integer
  - `duration` integer
  - `restarts` integer
  - `startPrice` integer
  - `reservePrice` integer
  - `buyItNowPrice` integer
  - `description` string, nullable
  - `paymentOptionIds` integer[], nullable
  - `shippingOptions` ItemShipping[], nullable
    - `shippingOptionId` integer, nullable
    - `cost` integer
    - `shippingWeight` number, double, nullable
    - `shippingWeightSpecified` boolean
    - `shippingProductId` integer, nullable
    - `shippingProductIdSpecified` boolean
    - `shippingProviderId` integer, nullable
    - `sellerSurcharge` integer, nullable — Optional seller-defined surcharge added on top of the shipping product's base cost. Not yet used to compute the buyer-facing shipping price — Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost is still the authoritative, required field today and must be sent. In a future API revision, Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost will be removed and the buyer-facing price will be derived from the shipping product (identified by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProductId) adjusted by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerSurcharge and Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerDiscount.
    - `sellerSurchargeSpecified` boolean
    - `sellerDiscount` integer, nullable — Optional seller-defined discount subtracted from the shipping product's base cost. Not yet used to compute the buyer-facing shipping price — Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost is still the authoritative, required field today and must be sent. In a future API revision, Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost will be removed and the buyer-facing price will be derived from the shipping product (identified by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProductId) adjusted by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerSurcharge and Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerDiscount.
    - `sellerDiscountSpecified` boolean
  - `acceptedBidderId` integer — The types of bidders allowed for the Item. Possible values: 1 = Sweden, 3 = International, 4 = EU. See the method !:PublicService.GetAcceptedBidderTypes for the authoritative list.
  - `expoItemIds` integer[], nullable
  - `customEndDate` string, date-time, nullable
  - `itemAttributes` integer[], nullable
  - `itemType` integer
  - `autoCommit` boolean
  - `vat` integer, nullable
  - `shippingCondition` string, nullable
  - `paymentCondition` string, nullable
  - `campaignCode` string, nullable
  - `descriptionLanguageCodeIso2` string, nullable
  - `attributeValues` ItemAttributeValues
    - `terms` TermValues[], nullable
      - `id` integer
      - `values` string[], nullable
    - `numbers` NumberValues[], nullable
      - `id` integer
      - `values` number[], nullable
  - `restartedFromItemId` integer, nullable

## Response `200`

OK

- QueuedRequestResponse
  - `requestId` integer
  - `itemId` integer

---

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