GET /products

Récupère la liste de tous les produits du catalogue avec pagination, tri et recherche.

Recherche

Le paramètre search permet une recherche textuelle dans :

  • Le nom du produit
  • La référence
  • La description

Filtrage par catégorie

Utilisez category pour filtrer par catégorie de produit.

Tri

Utilisez sort avec le format champ:direction où direction est 1 (asc) ou -1 (desc).

Query parameters

  • limit integer

    Nombre maximum de produits à retourner

    Default value is 20.

  • skip integer

    Nombre de produits à ignorer (pagination)

    Default value is 0.

  • sort string

    Champ et direction de tri (ex. "name:1", "price:-1")

  • state string

    Filtrer par état (active = visible, inactive = archivé)

    Values are active or inactive.

  • category string

    Filtrer par catégorie de produit

Responses

  • 200 application/json

    Liste des produits avec pagination

    Hide response attributes Show response attributes object
    • products array[object]

      Tableau des produits

      Hide products attributes Show products attributes object
      • _id string

        Unique identifier for the product

      • name string

        Product name (required)

      • reference string

        Product reference

      • sku string

        Stock Keeping Unit

      • description string

        Product description

      • price_ht number

        Price without tax

      • buying_price number

        Buying/cost price

      • cost_price number

        Cost price (coût de revient)

      • commercial_margin number

        Commercial margin (price_ht - buying_price)

      • gross_margin number

        Gross margin (price_ht - cost_price)

      • tva string

        Reference to VAT rate

      • tva_rate number

        VAT rate value

      • ecotax number

        Ecotax amount

      • category string

        Reference to product category

      • company string

        Reference to the company

      • unit string

        Unit of measurement

      • electronic boolean

        Is electronic product

      • is_marchandise boolean

        Is merchandise

      • url_ext string

        External URL

      • mandatory_mentions string

        Mandatory legal mentions

      • analytical_code string

        Analytical code

      • hasVariations boolean

        Has product variations

        Default value is false.

      • hasStockManagement boolean

        Stock management enabled

        Default value is false.

      • hasSpecifications boolean

        Has specifications

        Default value is false.

      • stock object
        Hide stock attributes Show stock attributes object
        • forceSell boolean
        • nb_alert number
        • nb_min number
        • nb_stock number
        • value_ht number
        • value_ttc number
        • sell_value_ht number
        • sell_value_ttc number
      • specifications object
        Hide specifications attributes Show specifications attributes object
        • depth number
        • height number
        • weight number
        • width number
      • options array[object]
        Hide options attributes Show options attributes object
        • name string
        • values array[string]
      • images array[object]
        Hide images attributes Show images attributes object
        • filename string
        • id string
        • mime string
        • size number
        • url string
      • files array[object]
        Hide files attributes Show files attributes object
        • filename string
        • id string
        • mime string
        • size number
        • url string
      • variants array[string]

        List of variant references

      • suppliers array[string]

        List of supplier (client) references

      • state string

        Values are active or inactive. Default value is active.

      • createdAt string(date-time)
      • updatedAt string(date-time)
    • total integer

      Nombre total de produits

    • limit integer

      Limite utilisée

    • skip integer

      Offset utilisé

GET /products
curl \
 --request GET 'https://wuro.pro/api/v3.2/products' \
 --header "X-APP-ID: $API_KEY" \
 --header "X-APP-SECRET: $API_KEY"
Response examples (200)
{
  "products": [
    {
      "_id": "string",
      "name": "string",
      "reference": "string",
      "sku": "string",
      "description": "string",
      "price_ht": 42.0,
      "buying_price": 42.0,
      "cost_price": 42.0,
      "commercial_margin": 42.0,
      "gross_margin": 42.0,
      "tva": "string",
      "tva_rate": 42.0,
      "ecotax": 42.0,
      "category": "string",
      "company": "string",
      "unit": "string",
      "electronic": true,
      "is_marchandise": true,
      "url_ext": "string",
      "mandatory_mentions": "string",
      "analytical_code": "string",
      "hasVariations": false,
      "hasStockManagement": false,
      "hasSpecifications": false,
      "stock": {
        "forceSell": true,
        "nb_alert": 42.0,
        "nb_min": 42.0,
        "nb_stock": 42.0,
        "value_ht": 42.0,
        "value_ttc": 42.0,
        "sell_value_ht": 42.0,
        "sell_value_ttc": 42.0
      },
      "specifications": {
        "depth": 42.0,
        "height": 42.0,
        "weight": 42.0,
        "width": 42.0
      },
      "options": [
        {
          "name": "string",
          "values": [
            "string"
          ]
        }
      ],
      "images": [
        {
          "filename": "string",
          "id": "string",
          "mime": "string",
          "size": 42.0,
          "url": "string"
        }
      ],
      "files": [
        {
          "filename": "string",
          "id": "string",
          "mime": "string",
          "size": 42.0,
          "url": "string"
        }
      ],
      "variants": [
        "string"
      ],
      "suppliers": [
        "string"
      ],
      "state": "active",
      "createdAt": "2025-05-04T09:42:00Z",
      "updatedAt": "2025-05-04T09:42:00Z"
    }
  ],
  "total": 42,
  "limit": 42,
  "skip": 42
}