Skip to main content

get articles

POST 
/ecom/article/v1/getarticles

Searches/loads articles. The request body is technically optional: a null body or a body without any supported filter intentionally returns an empty article list (logged server-side as "no restriction set!") and never raises an error. Supply at least one filter. Filters are evaluated in a fixed priority order and the FIRST non-empty one wins - the remaining filters are then ignored: (1) identifiers, (2) partnerIdentifiers, (3) any of productGroupIdentifiers / articleLineIdentifiers / marketingProjIdentifiers / articleGroupIdentifiers, (4) loadOnlyTransportPackings=true, (5) freeField4 (non-blank). numberOfDS limits the result size only for the identifiers branch; all other branches are unbounded and can return large result sets. A role-based FilterXD (ROLE_ARTICLE_ARTICLES_GET_API) is always applied on top of the selected filter, and filterXDSid narrows further. SID resolution: each entry in identifiers resolves via articleSid (direct), ean13, or searchString (article name / articleID LIKE match).

Request​

Responses​

successful operation