Skip to main content
GET
List articles

Authorizations

Authorization
string
header
required

Access token from POST /v2/oauth2/token, requested with an API credential. See https://api-docs.quivo.co/api-reference/authentication.

Query Parameters

query
string

Elasticsearch query string: field:value, joined with AND by default; AND/OR/NOT in upper case; quotes around values with spaces, / or :; * wildcards; ranges like created:[2026-10-01 TO 2026-10-31] or created:>=now-7d; exists:field. A condition on a wrong field name matches nothing and gives no error, so OR still returns the other matches and NOT drops nothing, which widens the result. Guide: https://api-docs.quivo.co/docs/quivo-guides/using-queries. Fields include: sku, barcode, articleIdentifier, articleType (PRODUCT, CARTON), sellerId, created, deletedAt, errorsCount, manufacturerProductId, tariffNumber. Examples: sku:"SKU-1" AND sellerId:123; errorsCount:>0 AND NOT exists:deletedAt.

sort
string

Optional sorting criteria for the results. Format is typically 'field:direction' (e.g., 'created:desc').

page
integer<int64>

The page number to retrieve when using offset-based pagination. Ignored if 'searchAfter' is provided.

searchAfter
string

Used for cursor-based pagination. Pass the 'sort' key value from the last item of the previous page to retrieve the next set of results efficiently. Overrides 'page'.

pageSize
integer<int64>

The maximum number of items to return per page. Used for both offset and cursor-based pagination.

Response

Returns an array of ArticleGetSummary matching the request criteria.

sku
string
required

Stock Keeping Unit (SKU) identifier

Required string length: 1 - 50
deletedAt
string<date-time>

The deleted at timestamp

alternativeSkus
string[]

Stock Keeping Unit (SKU) identifier

name
object

Detailed information for stringi18n

articleType
enum<string>

The type or category of the article (product).

Available options:
PRODUCT,
CARTON
barcode
string

Code or identifier

Maximum string length: 50
supplierReferenceNumber
string

Reference number provided by the supplier for this article.

Maximum string length: 20
alternativeBarcodes
string[]

Code or identifier

grossWeight
object

Detailed information for weight

netWeight
object

Detailed information for weight

lotRequired
boolean

Indicates whether lot is required

expirationDateRequired
boolean

Indicates whether an expiration date is required for this article.

serialNumberRequired
boolean

Indicates whether serial number is required

canShipWithoutCarton
boolean

Boolean flag indicating can ship without carton

length
object

Detailed information for lengthmeasurement

width
object

Detailed information for lengthmeasurement

height
object

Detailed information for lengthmeasurement

customsContentDescription
string

Description text

Maximum string length: 450
manufacturerProductId
string

Model, part or style number assigned by the manufacturer. Sent as Manufacturer Product ID with shipments into the EU from outside the EU.

Maximum string length: 35
Example:

"ABC-1234-XL"

cpsc
object
countryOfOrigin
enum<string>

Country code or name

Available options:
AF,
AX,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
KH,
CM,
CA,
CV,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KP,
KR,
XK,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MK,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SK,
SI,
SB,
SO,
ZA,
GS,
ES,
LK,
SD,
SR,
SJ,
CW,
BQ,
SX,
SZ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW
salesPrice
object

Detailed information for monetaryvalue

insuranceValue
object

Detailed information for monetaryvalue

customsValue
object

Detailed information for monetaryvalue

unNumber
string

Number value

customAttributes
object

Optional value for custom attributes of article.

Example:

"{\"attr1\":\"val1\"}"

itemGroup
string

The item group

lottableBatchRequired
boolean

Indicates whether lottable batch is required

id
integer<int64>

The unique identifier for the article.

sellerId
integer<int64>

The unique identifier for the seller

articleIdentifier
string

The unique identifier for the articleentifier

images
object[]

Image reference

minimumQuantities
object[]

Array of minimum quantitie

packagingUnits
object[]

Array of packaging unit

minimumExpirationDates
object[]

Minimum expiration dates required for this article.

minimumShelfLives
object[]

Array of minimum shelf live

tariffNumber
string

Number value

lengthM
number

Length measurement

widthM
number

Width measurement

heightM
number

Height measurement

grossWeightKG
number

Weight value

netWeightKG
number

Weight value

sort
object

The

items
object