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
-
page
integer(int) Specify the page number to fetch, defaults to 1.
-
limit
integer(int) Specify the number of items to fetch per page, defaults to 25.
-
productSearch
string 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'.
-
productNumber
string 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
}
]