List Products

GET {{baseUrl}}/products?page=<integer>&keyword=<string>&status=<string>&category=<string>&per_page=<integer>

You can list all available products related to your store directly from this endpoint.

Also, it allows you to filter them using a keyword, status, and category parameters. The endpoint would retrieve any product that matches used filters.

Scope: products.read- Products Read Only

Request Params

HEADERS

RESPONSES

status: OK

{"status":"\u003cnumber\u003e","success":"\u003cboolean\u003e","data":[{"id":"\u003cnumber\u003e","promotion":{"title":"\u003cstring\u003e","sub_title":"\u003cstring\u003e"},"sku":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","type":"product","name":"\u003cstring\u003e","short_link_code":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"taxed_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"pre_tax_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"tax":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"description":"\u003cstring\u003e","quantity":"\u003cinteger\u003e","unlimited_quantity":"\u003cboolean\u003e","status":"hidden","is_available":"\u003cboolean\u003e","views":"\u003cinteger\u003e","sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_end":"\u003cstring\u003e","require_shipping":"\u003cboolean\u003e","cost_price":"\u003cnumber\u003e","weight":"\u003cnumber\u003e","weight_type":"oz","with_tax":"\u003cboolean\u003e","url":"\u003cstring\u003e","images":[{"id":"\u003cnumber\u003e","url":"\u003cstring\u003e","main":true,"alt":"\u003cstring\u003e","video_url":"\u003cstring\u003e","type":"image","sort":"\u003cnumber\u003e","three_d_image_url":"\u003cstring\u003e","main_image":"\u003cstring\u003e"}],"sold_quantity":"\u003cinteger\u003e","rating":{"total":"\u003cinteger\u003e","count":"\u003cinteger\u003e","rate":"\u003cnumber\u003e"},"regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"max_items_per_user":"\u003cnumber\u003e","maximum_quantity_per_order":"\u003cnumber\u003e","show_in_app":"\u003cboolean\u003e","notify_quantity":"\u003cstring\u003e","hide_quantity":"\u003cboolean\u003e","channels":["app","web"],"managed_by_branches":"\u003cboolean\u003e","service_blocks":{"installments":[{"name":"\u003cstring\u003e","title":"\u003cstring\u003e","logo":"\u003cstring\u003e","details":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","title":"\u003cstring\u003e","logo":"\u003cstring\u003e","details":"\u003cstring\u003e"}]},"calories":"\u003cstring\u003e","starting_price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"allow_attachments":"\u003cboolean\u003e","is_pinned":"\u003cboolean\u003e","pinned_date":"\u003cstring\u003e","sort":"\u003cnumber\u003e","active_advance":"\u003cboolean\u003e","enable_upload_image":"\u003cboolean\u003e","updated_at":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","description":"\u003cstring\u003e","type":"radio","required":"\u003cboolean\u003e","associated_with_order_time":"\u003cinteger\u003e","sort":"\u003cinteger\u003e","display_type":"image","visibility":"on_condition","visibility_condition_type":"=","visibility_condition_option":"\u003cinteger\u003e","visibility_condition_value":"\u003cinteger\u003e","values":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"formatted_price":"\u003cstring\u003e","display_value":"\u003cstring\u003e","advance":"\u003cboolean\u003e","option_id":"\u003cnumber\u003e","image_url":"\u003cstring\u003e","hashed_display_value":"\u003cstring\u003e","translations":{"ar":{"option_details_name":"\u003cstring\u003e"}},"is_default":"\u003cboolean\u003e","is_out_of_stock":"\u003cboolean\u003e"}]}],"skus":[{"id":"\u003cnumber\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cost_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"has_special_price":"\u003cboolean\u003e","stock_quantity":"\u003cinteger\u003e","unlimited_quantity":"\u003cboolean\u003e","notify_low":"\u003cinteger\u003e","barcode":"\u003cstring\u003e","sku":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"related_options":["\u003cinteger\u003e","\u003cinteger\u003e"],"related_option_values":["\u003cinteger\u003e","\u003cinteger\u003e"],"weight":"\u003cnumber\u003e","weight_type":"\u003cstring\u003e","weight_label":"\u003cstring\u003e","is_user_subscribed_to_sku":"\u003cboolean\u003e","is_default":"\u003cboolean\u003e"},{"id":"\u003cnumber\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cost_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"has_special_price":"\u003cboolean\u003e","stock_quantity":"\u003cinteger\u003e","unlimited_quantity":"\u003cboolean\u003e","notify_low":"\u003cinteger\u003e","barcode":"\u003cstring\u003e","sku":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"related_options":["\u003cinteger\u003e","\u003cinteger\u003e"],"related_option_values":["\u003cinteger\u003e","\u003cinteger\u003e"],"weight":"\u003cnumber\u003e","weight_type":"\u003cstring\u003e","weight_label":"\u003cstring\u003e","is_user_subscribed_to_sku":"\u003cboolean\u003e","is_default":"\u003cboolean\u003e"}],"metadata":{"title":"\u003cstring\u003e","description":"\u003cstring\u003e","url":"\u003cstring\u003e"},"booking_details":{"id":"\u003cnumber\u003e","location":"\u003cstring\u003e","type":"date_time","session_duration":"\u003cnumber\u003e","session_gap":"\u003cnumber\u003e","session_count":"\u003cnumber\u003e","time_strict_value":"\u003cnumber\u003e","time_strict_type":"days","availabilities":[{"day":"monday","is_available":true,"times":[{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"},{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"}]},{"day":"tuesday","is_available":true,"times":[{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"},{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"}]}],"overrides":[{"id":"\u003cnumber\u003e","date":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","date":"\u003cstring\u003e"}]},"categories":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"items":[{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"}],"parent_id":"\u003cinteger\u003e","sort_order":"\u003cinteger\u003e","status":"active","metadata_title":"\u003cstring\u003e","metadata_description ":"\u003cstring\u003e","metadata_url":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"items":[{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"}],"parent_id":"\u003cinteger\u003e","sort_order":"\u003cinteger\u003e","status":"active","metadata_title":"\u003cstring\u003e","metadata_description ":"\u003cstring\u003e","metadata_url":"\u003cstring\u003e"}],"brand":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","description":"\u003cstring\u003e","banner":"\u003cstring\u003e","logo":"\u003cstring\u003e","ar_char":"\u003cstring\u003e","en_char":"\u003cstring\u003e","metadata":{"title":"\u003cstring\u003e","description":"\u003cstring\u003e","url":"\u003cstring\u003e"}},"tags":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e"}]},{"id":"\u003cnumber\u003e","promotion":{"title":"\u003cstring\u003e","sub_title":"\u003cstring\u003e"},"sku":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","type":"group_products","name":"\u003cstring\u003e","short_link_code":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"taxed_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"pre_tax_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"tax":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"description":"\u003cstring\u003e","quantity":"\u003cinteger\u003e","unlimited_quantity":"\u003cboolean\u003e","status":"deleted","is_available":"\u003cboolean\u003e","views":"\u003cinteger\u003e","sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_end":"\u003cstring\u003e","require_shipping":"\u003cboolean\u003e","cost_price":"\u003cnumber\u003e","weight":"\u003cnumber\u003e","weight_type":"g","with_tax":"\u003cboolean\u003e","url":"\u003cstring\u003e","images":[{"id":"\u003cnumber\u003e","url":"\u003cstring\u003e","main":true,"alt":"\u003cstring\u003e","video_url":"\u003cstring\u003e","type":"image","sort":"\u003cnumber\u003e","three_d_image_url":"\u003cstring\u003e","main_image":"\u003cstring\u003e"}],"sold_quantity":"\u003cinteger\u003e","rating":{"total":"\u003cinteger\u003e","count":"\u003cinteger\u003e","rate":"\u003cnumber\u003e"},"regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"max_items_per_user":"\u003cnumber\u003e","maximum_quantity_per_order":"\u003cnumber\u003e","show_in_app":"\u003cboolean\u003e","notify_quantity":"\u003cstring\u003e","hide_quantity":"\u003cboolean\u003e","channels":["app","app"],"managed_by_branches":"\u003cboolean\u003e","service_blocks":{"installments":[{"name":"\u003cstring\u003e","title":"\u003cstring\u003e","logo":"\u003cstring\u003e","details":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","title":"\u003cstring\u003e","logo":"\u003cstring\u003e","details":"\u003cstring\u003e"}]},"calories":"\u003cstring\u003e","starting_price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"allow_attachments":"\u003cboolean\u003e","is_pinned":"\u003cboolean\u003e","pinned_date":"\u003cstring\u003e","sort":"\u003cnumber\u003e","active_advance":"\u003cboolean\u003e","enable_upload_image":"\u003cboolean\u003e","updated_at":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","description":"\u003cstring\u003e","type":"radio","required":"\u003cboolean\u003e","associated_with_order_time":"\u003cinteger\u003e","sort":"\u003cinteger\u003e","display_type":"text","visibility":"always","visibility_condition_type":"=","visibility_condition_option":"\u003cinteger\u003e","visibility_condition_value":"\u003cinteger\u003e","values":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"formatted_price":"\u003cstring\u003e","display_value":"\u003cstring\u003e","advance":"\u003cboolean\u003e","option_id":"\u003cnumber\u003e","image_url":"\u003cstring\u003e","hashed_display_value":"\u003cstring\u003e","translations":{"ar":{"option_details_name":"\u003cstring\u003e"}},"is_default":"\u003cboolean\u003e","is_out_of_stock":"\u003cboolean\u003e"}]}],"skus":[{"id":"\u003cnumber\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cost_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"has_special_price":"\u003cboolean\u003e","stock_quantity":"\u003cinteger\u003e","unlimited_quantity":"\u003cboolean\u003e","notify_low":"\u003cinteger\u003e","barcode":"\u003cstring\u003e","sku":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"related_options":["\u003cinteger\u003e","\u003cinteger\u003e"],"related_option_values":["\u003cinteger\u003e","\u003cinteger\u003e"],"weight":"\u003cnumber\u003e","weight_type":"\u003cstring\u003e","weight_label":"\u003cstring\u003e","is_user_subscribed_to_sku":"\u003cboolean\u003e","is_default":"\u003cboolean\u003e"},{"id":"\u003cnumber\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cost_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"has_special_price":"\u003cboolean\u003e","stock_quantity":"\u003cinteger\u003e","unlimited_quantity":"\u003cboolean\u003e","notify_low":"\u003cinteger\u003e","barcode":"\u003cstring\u003e","sku":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"related_options":["\u003cinteger\u003e","\u003cinteger\u003e"],"related_option_values":["\u003cinteger\u003e","\u003cinteger\u003e"],"weight":"\u003cnumber\u003e","weight_type":"\u003cstring\u003e","weight_label":"\u003cstring\u003e","is_user_subscribed_to_sku":"\u003cboolean\u003e","is_default":"\u003cboolean\u003e"}],"metadata":{"title":"\u003cstring\u003e","description":"\u003cstring\u003e","url":"\u003cstring\u003e"},"booking_details":{"id":"\u003cnumber\u003e","location":"\u003cstring\u003e","type":"date","session_duration":"\u003cnumber\u003e","session_gap":"\u003cnumber\u003e","session_count":"\u003cnumber\u003e","time_strict_value":"\u003cnumber\u003e","time_strict_type":"days","availabilities":[{"day":"wednesday","is_available":true,"times":[{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"},{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"}]},{"day":"sunday","is_available":true,"times":[{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"},{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"}]}],"overrides":[{"id":"\u003cnumber\u003e","date":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","date":"\u003cstring\u003e"}]},"categories":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"items":[{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"}],"parent_id":"\u003cinteger\u003e","sort_order":"\u003cinteger\u003e","status":"active","metadata_title":"\u003cstring\u003e","metadata_description ":"\u003cstring\u003e","metadata_url":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"items":[{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/Category detected\u003e"}],"parent_id":"\u003cinteger\u003e","sort_order":"\u003cinteger\u003e","status":"hidden","metadata_title":"\u003cstring\u003e","metadata_description ":"\u003cstring\u003e","metadata_url":"\u003cstring\u003e"}],"brand":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","description":"\u003cstring\u003e","banner":"\u003cstring\u003e","logo":"\u003cstring\u003e","ar_char":"\u003cstring\u003e","en_char":"\u003cstring\u003e","metadata":{"title":"\u003cstring\u003e","description":"\u003cstring\u003e","url":"\u003cstring\u003e"}},"tags":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e"}]}],"pagination":{"count":"\u003cnumber\u003e","total":"\u003cnumber\u003e","perPage":"\u003cnumber\u003e","currentPage":"\u003cnumber\u003e","totalPages":"\u003cnumber\u003e","links":["\u003cstring\u003e","\u003cstring\u003e"]}}