---
title: "Retrieve a buy x pay y promotion"
method: GET
path: "/buy_x_pay_y_promotions/{buyXPayYPromotionId}"
tags: ["buy_x_pay_y_promotions"]
---

# Retrieve a buy x pay y promotion

`GET /buy_x_pay_y_promotions/{buyXPayYPromotionId}`

## Request

- Base URL: `https://{your_organization_slug}.commercelayer.io/api`
- URL: `https://{your_organization_slug}.commercelayer.io/api/buy_x_pay_y_promotions/{buyXPayYPromotionId}`
- Auth: HTTP bearer

Retrieve a buy x pay y promotion

## Path parameters

- `buyXPayYPromotionId` string, required

## Response `200`

The buy x pay y promotion object

- BuyXPayYPromotionResponse
  - `data` object
    - `id` string: Unique identifier for the resource (hash).
    - `type` 'buy_x_pay_y_promotions': The resource's type
    - `links` object
      - `self` string: URL
    - `attributes` Attributes (unresolved $ref)
    - `relationships` object
      - `market` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'market': The resource's type
          - `id` string: The resource ID
      - `promotion_rules` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'promotion_rules': The resource's type
          - `id` string: The resource ID
      - `order_amount_promotion_rule` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'order_amount_promotion_rule': The resource's type
          - `id` string: The resource ID
      - `sku_list_promotion_rule` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'sku_list_promotion_rule': The resource's type
          - `id` string: The resource ID
      - `coupon_codes_promotion_rule` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'coupon_codes_promotion_rule': The resource's type
          - `id` string: The resource ID
      - `custom_promotion_rule` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'custom_promotion_rule': The resource's type
          - `id` string: The resource ID
      - `sku_list` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'sku_list': The resource's type
          - `id` string: The resource ID
      - `coupons` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'coupons': The resource's type
          - `id` string: The resource ID
      - `attachments` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'attachments': The resource's type
          - `id` string: The resource ID
      - `events` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'events': The resource's type
          - `id` string: The resource ID
      - `tags` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'tags': The resource's type
          - `id` string: The resource ID
      - `event_stores` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'event_stores': The resource's type
          - `id` string: The resource ID
      - `skus` object
        - `links` object
          - `self` string: URL
          - `related` string: URL
        - `data` object
          - `type` 'skus': The resource's type
          - `id` string: The resource ID

## Changes

- **2026-07-13** `859097ed3fe6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/buy_x_pay_y_promotions/:buyXPayYPromotionId/get.md)

---

[API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [All operations](https://skmtc.dev/commercelayer/apis/commerce-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commercelayer/apis/commerce-layer-api/revisions/b57015449446?raw)