Skip to content

Get Products

Request

  • term: Name, article or barcode

  • page (number, 1) - Page number (not used if product_id is passed)

  • count (number, 25) - Number of products on the page (not used if product_id is passed)

  • category_id (number, 777) - Id of the product category (not used if product_id is passed)

  • changed_after (string) - filtering products changed/created since a specific date and time (not used if product_id is passed)

  • changed_before (string) - filtering products changed/created before a specific date and time (not used if product_id is passed)

Security
BearerPartnerUser
Path
location_idnumberrequired

location ID

product_idnumberrequired

Product ID (if you need to get a specific product)

Query
termstring

name, article number or barcode

pagenumber

page number

Example:page=1
countnumber

number of products per page

Example:count=25
category_idnumber

Product category ID

changed_afterstring

filtering products modified/created since a specific date and time

Example:changed_after=2026-09-21T23:00:00.000-05:00
changed_beforestring

filtering products modified/created before a specific date and time

Example:changed_before=2026-01-01T12:00:00-0500
Headers
Acceptstringrequired

e.g. application/vnd.api.v2+json

Example:application/vnd.api.v2+json
Content-Typestringrequired

application/json

Authorizationstringrequired

Bearer partner_token, User user_token

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v1/openapi/locations/{location_id}/products/{product_id}?term=string&page=1&count=25&category_id=0&changed_after=2026-09-21T23%3A00%3A00.000-05%3A00&changed_before=2026-01-01T12%3A00%3A00-0500' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: string'

Responses

OK

Bodyapplication/json
successboolean

Execution success status (true)

Example:true
dataobject

Product data object

Example:
{ "title": "Shampoo 1", "value": "Shampoo 1", "label": "Shampoo 1 (123)", "good_id": 123456, "cost": 100500, "unit_id": 4835, "unit_short_title": "PC", "service_unit_id": 3548, "service_unit_short_title": "gr", "actual_cost": 1050, "unit_actual_cost": 105, "unit_actual_cost_format": "105 r", "unit_equals": 10, "barcode": "123", "loyalty_abonement_type_id": "150", "loyalty_certificate_type_id": "0", "loyalty_allow_empty_code": false, "critical_amount": 0, "desired_amount": 0, "actual_amounts": [ { … } ], "last_change_date": "2026-01-01T12:00:00-0500" }
metaArray of objects

Metadata (empty array)

Example:
[]
Response
{ "success": true, "data": [ { … } ], "meta": [] }