Get all products

GET /products

This endpoint is used for all data manipulation with products - creating, updating, removing and also for updating specific values of stocks, prices and mapping to each of the marketplaces

Get all my products

Query parameters

  • limit integer(int32)

    How many items to return at one time (max 100)

Responses

  • 200 application/json

    all products are returned with default page limit of 1000 items

    Hide response attributes Show response attributes object
    • id integer(int64)
    • itemgroupId string
    • createdAt string(date-time)
    • updatedAt string(date-time)
    • currency string

      ISO currency code

    • remoteId string
    • ean string
    • brand string
    • isActive boolean
    • isAvailable boolean
    • vat number(float)
    • dataSource object
      Hide dataSource attributes Show dataSource attributes object
      • id integer(int64)
      • createdAt string(date-time)
      • updatedAt string(date-time)
      • title string
      • language string
      • currency string

        ISO currency code

      • isActive boolean

        Default value is false.

      • source string
      • pairingStrategy string
      • defaultBrand string
      • strategies array[object]
        Hide strategies attributes Show strategies attributes object
        • pricing array[object]
          Hide pricing attributes Show pricing attributes object
          • sellingMargin number(float)
          • automaticMarkup number(float)
        • stock array[object]
          Hide stock attributes Show stock attributes object
          • defaultStockValue number(float)
          • propagateDeliveryDelay boolean

            Default value is true.

    • price object
      Hide price attributes Show price attributes object
      • sellingPrice number(float)
      • buyPrice number(float)
      • forcedPrice number(float)
      • salePrice number(float)
      • currency string

        ISO currency code

      • strategies array[object]
        Hide strategies attributes Show strategies attributes object
        • remoteId string
        • productSetId integer
        • pricingStrategy array[object]
          Hide pricingStrategy attributes Show pricingStrategy attributes object
          • price number(float)
          • currency string

            ISO currency code

          • connectorId string
    • images array[object]
      Hide images attributes Show images attributes object
      • id number(int)
      • imageType string

        Values are basic_image, information_list, energy_label, or size_table.

      • source string
      • isMain boolean

        Default value is false.

      • isActive boolean

        Default value is true.

      • ranking number(int)
    • categories array[object]
      Hide categories attribute Show categories attribute object
      • source array[object]
        Hide source attributes Show source attributes object
        • title string
        • slug string
        • remoteId number
    • parameters array[object]
      Hide parameters attributes Show parameters attributes object
      • languageCode string
      • paramName string
      • paramValues array[string]
    • translations array[object]
      Hide translations attributes Show translations attributes object
      • languageCode string
      • title string
      • shortDescription string
      • description string
    • stock array[object]
      Hide stock attributes Show stock attributes object
      • availableStock number(float)
      • inOurWarehouseAvailableStock number(float)
      • realStock number(float)
      • strategies array[object]
        Hide strategies attributes Show strategies attributes object
        • stock number(float)
        • connectorId string
  • 204

    If none products are loaded onto platform - 204 No Content is returned

  • 403

    If your account is not allowed to access this endpoint you will receive 403 Forbidden in reply

GET /products
curl \
 --request GET 'api.services.omnicado.com/api/v2/products' \
 --header "X-OMNICADO-TOKEN: $API_KEY"
Response examples (200)
[
  {
    "id": 42,
    "itemgroupId": "string",
    "createdAt": "2025-05-04T09:42:00Z",
    "updatedAt": "2025-05-04T09:42:00Z",
    "currency": "CZK",
    "remoteId": "H839941",
    "ean": "0764502620",
    "brand": "Amazon",
    "isActive": true,
    "isAvailable": true,
    "vat": 21.0,
    "dataSource": {
      "id": 42,
      "createdAt": "2025-05-04T09:42:00Z",
      "updatedAt": "2025-05-04T09:42:00Z",
      "title": "Products for Amazon",
      "language": "cs_CZ",
      "currency": "CZK",
      "isActive": false,
      "source": "api",
      "pairingStrategy": "remoteId",
      "defaultBrand": "OMNICADO",
      "strategies": [
        {
          "pricing": [
            {
              "sellingMargin": 42.0,
              "automaticMarkup": 42.0
            }
          ],
          "stock": [
            {
              "defaultStockValue": 42.0,
              "propagateDeliveryDelay": true
            }
          ]
        }
      ]
    },
    "price": {
      "sellingPrice": 42.0,
      "buyPrice": 42.0,
      "forcedPrice": 42.0,
      "salePrice": 42.0,
      "currency": "CZK",
      "strategies": [
        {
          "remoteId": "H1234443",
          "productSetId": 1234,
          "pricingStrategy": [
            {
              "price": 129.0,
              "currency": "CZK",
              "connectorId": "mallCz"
            }
          ]
        }
      ]
    },
    "images": [
      {
        "id": 42.0,
        "imageType": "basic_image",
        "source": "https://image.eshop.cz/1.jpg",
        "isMain": false,
        "isActive": true,
        "ranking": 2
      }
    ],
    "categories": [
      {
        "source": [
          {
            "title": "Domácnost a zahrada",
            "slug": "domacnost-a-zahrada",
            "remoteId": 123
          }
        ]
      }
    ],
    "parameters": [
      {
        "languageCode": "cs_CZ",
        "paramName": "Barva",
        "paramValues": [
          "Černá",
          "Fialová"
        ]
      }
    ],
    "translations": [
      {
        "languageCode": "cs_CZ",
        "title": "Produkt v češtině",
        "shortDescription": "Popis v češtině",
        "description": "Dlouhý popis v češtině"
      }
    ],
    "stock": [
      {
        "availableStock": 2.0,
        "inOurWarehouseAvailableStock": 3.0,
        "realStock": 5.0,
        "strategies": [
          {
            "stock": 4.0,
            "connectorId": "mallCz"
          }
        ]
      }
    ]
  }
]