---
title: "Retrieve all offers"
method: GET
path: "/v1/shoppers/me/offers"
tags: ["Offers"]
---

# Retrieve all offers

`GET /v1/shoppers/me/offers`

Retrieve all offers, including:
* Trigger type is Always Triggered offers
* Trigger type is User Triggered (Promotional URL / External Triggered Offers) and has been triggered
* Trigger type is User Triggered (Coupon Code) and has been triggered

## Query parameters

- `apiKey` string
- `token` string
- `expand` string
- `fields` string
- `pageNumber` string
- `pageSize` string
- `format` string
- `currency` string
- `locale` string
- `skipOfferArbitration` boolean

## Response `200`

Successful response.

- union
  - DefaultOffers
    - `offers` object
      - `uri` string
      - `offer` DefaultOfferComponent[]
        - `uri` string
        - `name` string
        - `trigger` string — The offer trigger determines how the offer is activated or redeemed by shoppers, possible values are: User Triggered, Always Triggered. * Always Triggered: The offer is available to any shopper on your store. Shoppers simply have to meet the conditions you set up in the offer for the offer to be triggered and redeemed by shoppers. * User Triggered: To be redeemed when shopper taking additional actions on their part, for example click a link, enter a coupon code.
        - `productOffers` object — Product information of the offer.
          - `uri` string
        - `categoryOffers` object — Category information of the offer.
        - `offerBundleGroups` object — Data and items associated with the Custom Bundle offer groups.
          - `offerBundleGroup` OfferBundleGroup[]
            - `bundleGroupName` string — The group is named based on a sequence, beginning with "Primary," followed by "Secondary," and, if needed, "Third."
            - `bundleType` 'Mandatory' | 'Optional' — Mandatory means shopper should pick up at least N products in a group. Optional has no minimum amount restriction.
            - `minProductQuantity` integer — The quantity that the shopper must by at least.
            - `maxProductQuantity` integer — The quantity that the shopper can by at most.
            - `displayName` string — The name of the offer.
            - `description` string — The description of the offer.
            - `productOffers` DefaultProductOffer
              - …
      - `totalResults` integer
      - `totalResultPages` integer
  - ExpandedOffers
    - `offers` object
      - `uri` string
      - `offer` ExpandedOfferComponent[]
        - `uri` string
        - `id` integer
        - `name` string
        - `policyName` string — The bundle policy for bundle offers outlines the relationship between parent and child products within the bundle. For example:Semi-Tight, Loose, Tight.
        - `type` string
        - `image` string
        - `trigger` string — The offer trigger determines how the offer is activated or redeemed by shoppers, possible values are: User Triggered, Always Triggered. * Always Triggered: The offer is available to any shopper on your store. Shoppers simply have to meet the conditions you set up in the offer for the offer to be triggered and redeemed by shoppers. * User Triggered: To be redeemed when shopper taking additional actions on their part, for example click a link, enter a coupon code.
        - `salesPitch` string[] — Text or content appeared above the product image and information in the offer content.
        - `customAttributes` DefaultCustomAttributes
          - `attribute` object[]
            - `name` string
            - `value` string
            - `type` string
        - `productOffers` ExpandedProductOffersComponent — Product information of the offer. The productOffer objects for Custom Bundle offers are placed within the offerBundleGroup object.
          - `uri` string
          - `productOffer` object[]
            - `uri` string
            - `id` integer
            - `product` object
              - …
            - `addProductToCart` object
              - …
            - `salesPitch` string — Text or content appeared above the product image and information in the offer content.
            - `image` string
            - `pricing` object
              - …
        - `categoryOffers` object — Category information of the offer.
        - `offerBundleGroups` object — Data and items associated with the Custom Bundle offer groups.
          - `offerBundleGroup` OfferBundleGroup[]
            - `bundleGroupName` string — The group is named based on a sequence, beginning with "Primary," followed by "Secondary," and, if needed, "Third."
            - `bundleType` 'Mandatory' | 'Optional' — Mandatory means shopper should pick up at least N products in a group. Optional has no minimum amount restriction.
            - `minProductQuantity` integer — The quantity that the shopper must by at least.
            - `maxProductQuantity` integer — The quantity that the shopper can by at most.
            - `displayName` string — The name of the offer.
            - `description` string — The description of the offer.
            - `productOffers` DefaultProductOffer
              - …
      - `totalResults` integer
      - `totalResultPages` integer

## Other responses

- `401` — * Invalid Token

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-shopper-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-shopper-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-shopper-apis/revisions/4b69392f93b9/schema)