API Reference

List promotions

get
https://{domain_prefix}.retail.lightspeed.app/api/2026-04/promotions

This endpoint lists all promotions for a retailer.

There are optional query parameters that allow filtering promotions. They can't be combined:

  • end_time_from - only show promotions that have end_time after or equal to this time
  • end_time_to - only show promotions that have end_time before this time

For example. the time format for end_time_from and end_time_to are: 2047-06-21T13:00:00

🔒 Requires: promotions:read scope

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Upper limit for the promotion end date as UTC timestamp. Format: 2020-08-08T12:00:00Z.

string

Lower limit for the promotion end date as UTC timestamp. Format: 2020-08-08T12:00:00Z.

integer

The maximum number of items to be returned in the response.

Response

Updated 5 days ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago