---
title: "Returns a list of products loaded into BrandLovers Marketplace"
method: GET
path: "/products"
tags: ["products"]
---

# Returns a list of products loaded into BrandLovers Marketplace

`GET /products`

Get a list of my products loaded into the Marketplace. This dosen't means that products are eligible for sale, just that they are loaded in the database.

## Query parameters

- `offset` integer
- `limit` integer

## Headers

- `authorization` string, required

## Response `200`

Success!

- GetProductsResponse
  - `skus` GetProduct[]
    - `skuSellerId` string, required — Unique Product Id (SKU) in the seller system
    - `productGroupId` string — Unique Product Group ID. Products with the same `productGroupId` will be grouped and displayed as a unique entry. Use `productGroupId` to group diferent SKUs that represent diferent colors, sizes, capacities, etc..
    - `title` string, required — Product name as advertised by manufacturer. This how the product will be displayed in the Marketplace
    - `description` string, required — Product text description.
    - `brand` string, required — Brand name
    - `gtin` string[] — Array of product EAN and/or ISBN and/or ASIN codes
    - `categories` string[], required — Array of categories associated with this product
    - `images` string[], required — List of valid Product image URLs. HTTP or HTTPS are valid. HTTPS is prefered.
    - `videos` string[] — List of videos de URLs associated with this product. HTTP or HTTPS are valid. HTTPS is prefered.
    - `price` ProductPrice, required
      - `default` integer, required — List price, also known as MSRP (Manufacturer Suggest Retail Price) or the recommended retail price (RRP). All prices must be provided in cents. No commas or periods are accepeted. For example one dollar should be informed as 100. $1,2345.67 should be informed solely as 1234567
      - `offer` integer, required — Product price. This is what will be offered to the customer. All prices must be provided in cents. No commas or periods are accepeted. For example one dollar should be informed as 100. $1,2345.67 should be informed solely as 1234567
    - `stock` integer, required — Number of products availble for sale from the seller. Each new successfull order will automatically reduce the number of products available.
    - `dimensions` Dimensions
      - `weight` integer, required — Product weight in Grams. No commas or periods are accepeted. For example one killo must be informed as 1000. Another example 1 Kilo and 234 grams should be informed solely as 1234
      - `length` integer, required — Product length in millimeters. No commas or periods are accepeted. For example one meter produc must be informed as 1000. Another example 1 meter and 23 centimeters should be informed solely as 1230
      - `width` integer, required — Product width in millimeters. No commas or periods are accepeted. For example one meter produc must be informed as 1000. Another example 1 meter and 23 centimeters should be informed solely as 1230
      - `height` integer, required — Product height in millimeters. No commas or periods are accepeted. For example one meter produc must be informed as 1000. Another example 1 meter and 23 centimeters should be informed solely as 1230
    - `giftWrap` GiftWrap
      - `available` boolean, required — Flag that defines if this product is eligible for giftwrapping
      - `value` integer, required — Amount charged for gift wrap. All prices must be provided in cents. No commas or periods are accepeted. For example one dollar should be informed as 100. $1,2345.67 should be informed solely as 1234567
      - `messageSupport` boolean — Flag that defines if seller supports giftwrapp with a message
    - `attributes` ProductAttribute[], required
      - `name` string, required — Attribute name
      - `value` string, required — Attribute value
    - `status` string, required — Product status
    - `errors` Error[]
      - `type` string, required — Error type
      - `message` string, required — Friendly message describing the error
      - `skuSellerId` string — When applicabe will include `skuSellerId` related to this error
  - `metadata` Metadata[] — Payload with response
    - `key` string, required — JSON attribute key
    - `value` string, required — JSON object value

## Other responses

- `400` — Bad request.
- `401` — Access denied. You're not authenticated or token expired. Check your request header the `authorization` field is required.
- `403` — Server refused to process your request. Please check the API SLA and reduce number of requests per second.

---

[API](https://skmtc.net/brandlovers/apis/brandlovers-marketplace-api-v1.md) · [All operations](https://skmtc.net/brandlovers/apis/brandlovers-marketplace-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brandlovers/brandlovers-marketplace-api-v1/revisions/cb3af6151ae4/schema)