Skip to main content

Get all Promotions

GET 

https://useast.api.elasticpath.com/v2/promotions

Returns all promotions.

note

You can use pagination with this resource. For more information, see pagination.

Filtering

The following operators and attributes are available when filtering on this endpoint. See Supported Filtering Characters.

Use code filter to search codes within promotions.

AttributeTypeOperatorExample
codestringeqeq(code,some_code)

For filtering advanced promotion usages, pass the EP-Public-Search-Type=cm_search header. Advanced search filtering is only applicable when the promotion code is consumed and the promotion is not deleted.

AttributeTypeOperatorExample
promo_idstringeqeq(promo_id, 69c63c9d-8ccf-44b1-8e98-1e7feebfb581)
promo_namestringeq, likeeq(promo_name,cart percent discount)
promo_typestringeqeq(promo_type,fixed_discount)
promo_statusstringeqeq(promo_status,Running)
promo_checkoutsstringeq,gt, ge, lt, leeq(promo_checkouts,2)
promo_skus_prod_idsstringeq, likeeq(promo_skus_prod_ids, sku1)
promo_start_datestringeq, gt, gr, lt, leeq(promo_start_date,2023-01-01)
promo_end_datestringeq, gt, gr, lt, leeq(promo_end_date,2050-06-15)
code_idstringeqeq(promo_id,2ea0cd1d-43a9-441b-b03f-3cab84aaee0c):eq(code_id,14b55e6c-3f80-436e-a90a-4de5f0e36240)
code_codestringeq, likeeq(code_code,cart_fixed_10)
code_usedstringeq, gt, gr, lt, leeq(code_used,2)
code_created_datestringeq, gt, gr, lt, leeq(code_created_date,2023-11-15)
order_idstringeq, likeeq(order_id,ccb13673-627c-4976-88da-f77c542b528f)
order_customer_emailstringeq, likelike(order_customer_email,andy*)
order_created_datestringeq, gt, gr,lt, lele(order_created_date,2023-11-15)

Request

Responses

Response Headers

    Authorization: http

    name: bearerAuthtype: httpscheme: bearer

    Request Collapse all
    Base URL
    https://useast.api.elasticpath.com
    Auth
    Parameters
    — headerrequired
    — query
    — query
    ResponseClear

    Click the Send API Request button above and see the response here!

    We use cookies to enhance your experience. By continuing to visit this site you agree to our use of cookies.