v1

latestOpenAPI 3.0.12026-07-2412502.6 MB
Offers

Add an offer swap option

Add an offer swap option

post/offers/{offer_id}/offer_swap_options

Request body

swap_offer_idinteger required
swap_offer_type_id1 | 2 | 3 required
  • 1 - In Cart Only
  • 2 - Ongoing Subscription
  • 3 - Both
swap_offer_descriptionstring

Response

OK

offer_idinteger
offer_namestring
offer_titlestring nullable
offer_codestring nullable
primary_offer_category_idinteger nullable
secondary_offer_category_idinteger nullable
offer_type_id1 | 2
  • 1 - One Time Sale
  • 2 - Recurring
offer_configurationstring nullable
offer_pricestring

Returns the price for the initial cycle of the offer. If null, then the offer has multiple items associated with it, to get full pricing for the offer, pass “with=offer_cycles”

offer_descriptionstring nullable
offer_globalboolean
offer_urlstring nullable
initial_item_idinteger nullable
offer_notesstring nullable
offer_activeboolean
date_createdstring date-time
created_byinteger
date_modifiedstring date-time
modified_byinteger

Example response

{
  "date_created": "2023-04-01 00:00:00",
  "date_modified": "2023-04-01 00:00:00",
  "offer_cycles": [
    {
      "date_created": "2023-04-01 00:00:00",
      "date_modified": "2023-04-01 00:00:00",
      "offer_cycle_items": [
        {
          "date_created": "2023-04-01 00:00:00",
          "date_modified": "2023-04-01 00:00:00"
        }
      ],
      "charge_timeframe": {
        "date_created": "2023-04-01 00:00:00",
        "date_modified": "2023-04-01 00:00:00"
      }
    }
  ],
  "offer_timeframes": [
    {
      "date_created": "2023-04-01 00:00:00",
      "date_modified": "2023-04-01 00:00:00"
    }
  ],
  "offer_swap_options": [
    {
      "date_created": "2023-04-01 00:00:00",
      "date_modified": "2023-04-01 00:00:00"
    }
  ]
}