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 \
-X GET https://rest.api.24sevenoffice.com/v1/products \
-H "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
}
]