Read products
Read a list of products, including their details, with pagination, or a subset of products based on query parameters. Products may have different attributes such as name, description, price, and stock information. The endpoint supports various search criteria for filtering products based on specific attributes.
Query parameters
-
Specify the page number to fetch, defaults to 1.
-
Specify the number of items to fetch per page, defaults to 25.
-
Perform a search in productNumber, name, and supplier's productNumber and name. Wildcards are allowed using '%'. '%' at the end returns 'starts with'. '%' at the beginning returns 'ends with'. '%' at both ends returns 'contains'.
-
Searches for product number.
GET
/products
curl \
--request GET 'https://rest.api.24sevenoffice.com/v1/products' \
--header "Authorization: string"
Response examples (200)
[
{
"id": 123,
"ean": "0123456789000",
"name": "White shoe laces",
"type": "default",
"stock": {
"location": "A-313",
"quantity": 146,
"isManaged": true
},
"units": {
"id": 2,
"name": "Metre",
"symbol": "m"
},
"number": "SH-1234567",
"status": "active",
"category": {
"id": 12,
"name": "Shoe accessories"
},
"supplier": {
"id": 67890,
"name": "XYZ Inc."
},
"costPrice": 50,
"createdAt": "2022-01-01 18:00:00.000Z",
"modifiedAt": "2023-12-31 18:00:00.000Z",
"salesPrice": 400,
"description": "1 meter long shoe laces - white",
"indirectCost": 12.77,
"eanAlternative": "0123456789012345678901234"
},
{
"id": 456,
"ean": "0987654321000",
"name": "Black leather belt",
"type": "default",
"stock": {
"location": "B-105",
"quantity": 82,
"isManaged": true
},
"units": {
"id": 13,
"name": "Piece",
"symbol": "pcs"
},
"number": "BL-9876543",
"status": "active",
"category": {
"id": 15,
"name": "Fashion accessories"
},
"supplier": {
"id": 54321,
"name": "ABC Supplies"
},
"costPrice": 30,
"createdAt": "2022-02-15 12:00:00.000Z",
"modifiedAt": "2023-11-30 15:30:00.000Z",
"salesPrice": 150,
"description": "Genuine leather belt for men",
"indirectCost": 8.5
},
{
"id": 789,
"ean": "5678901234000",
"name": "Blue cotton t-shirt",
"type": "default",
"stock": {
"location": "C-212",
"quantity": 210,
"isManaged": true
},
"units": {
"id": 13,
"name": "Piece",
"symbol": "pcs"
},
"number": "TC-5678901",
"status": "active",
"category": {
"id": 18,
"name": "Apparel"
},
"supplier": {
"id": 12345,
"name": "Fashion Hub"
},
"costPrice": 15,
"createdAt": "2022-03-20 09:30:00.000Z",
"modifiedAt": "2023-10-25 10:45:00.000Z",
"salesPrice": 35,
"description": "Comfortable round-neck t-shirt for casual wear",
"indirectCost": 5.25
}
]