What parameters does GET /V1/coupons/search accept?

This endpoint accepts 1 parameter: searchCriteria (Magento\Framework\Api\SearchCriteriaInterface) required.

GETSalesRule · Magento 2.4.9 Admin · Magento_SalesRule::quote

GET /V1/coupons/search

Q: What does the GET /V1/coupons/search endpoint do in Magento 2?

GET /V1/coupons/search is a Magento 2 REST endpoint in the SalesRule module. Retrieve a coupon using the specified search criteria. Requires an admin Bearer token with ACL Magento_SalesRule::quote.

Q: What does GET /V1/coupons/search return?

The endpoint returns Magento\SalesRule\Api\Data\CouponSearchResultInterface.

Q: Does GET /V1/coupons/search require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_SalesRule::quote.

GET /V1/coupons/search is a Magento 2 REST endpoint in the SalesRule module. Retrieve a coupon using the specified search criteria. Requires an admin Bearer token with ACL Magento_SalesRule::quote.

This call returns an array of objects, but detailed information about each object’s attributes might not be included. See https://developer.adobe.com/commerce/webapi/rest/attributes#CouponRepositoryInterface to determine which call to use to get detailed information about all attributes for an object.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\SalesRule\Api\Data\CouponSearchResultInterface

Service contract

Magento\SalesRule\Api\CouponRepositoryInterface::getList

Authorization

Admin Bearer token with ACL:

Magento_SalesRule::quote

Query parameters

searchCriteria Magento\Framework\Api\SearchCriteriaInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.