PUT api/subscription/reinstate/campaign/display

Reinstates a given display campaign's subscription. If reinstatement occurs before the set end of the campaign then the campaign is simply returned to active billing retaining all previous billing timelines. If the subscription is reinstated after the scheduled campaign end date then new charges apply immediately and the billing cycle is reset to the date of the reinstatement request.

Request Information

Authentication Method

Partner/Account Authentication

URI Parameters

None.

Body Parameters

Display Campaign Subscription (Reinstate)

Name	Description	Type	Additional information
campaignId	Id of campaign for which the last subscription should be reinstated	integer	Required
chargedSpend	Amount of money whith which the campaign is funded today. This amount in conjuction with the budget will determine how long the campaign can run assuming the normal budget amount is spread evenly over 30 days. For example a campaign with a budget of 100 and initialFunds of 300 should run for 90 days before neededing to be replenished.	decimal number	Range: inclusive between 0 and 999999999
chargedFee	If the fee is to be prorated then specify the prorated amount here. It should be proportional to the spend. If not passed then the fee will be calculated based on on the ratio of initial spend to the budget amount.	decimal number	Range: inclusive between 0 and 999999999
nextCharge	Date when the campaign is expected to be cahrged next. For subscriptions with a type of Automatic this will be the date the spend is refilled and the partner is invoiced. For subscriptions with a type of Triggered this will represent the date when the spend is expected to be refilled. If not passed the date will be calculated based on the ratio of initial spend to the budget amount. Expected format is yyyy-MM-dd HH:mm:ssK.	string

Request Formats

application/json, text/json

Sample:

{
  "campaignId": 1,
  "chargedSpend": 2.0,
  "chargedFee": 3.0,
  "nextCharge": "sample string 4"
}

application/xml, text/xml

Sample:

<DisplayCampaignSubscription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SiteWit.PartnerAPI.Models.ReinstateModels">
  <campaignId>1</campaignId>
  <chargedFee>3</chargedFee>
  <chargedSpend>2</chargedSpend>
  <nextCharge>sample string 4</nextCharge>
</DisplayCampaignSubscription>

Response Information

Successful Response:

Resource Description

Campaign Subscription Charge

Name	Description	Type	Additional information
charge		Campaign Charge Detail
googleCoupon		Google Coupon
id		integer
name		string
status		string
type		string
endDate		date
subscription		Subscription Detail
partnerSKUs		Collection of Partner Sku
budgetLockExpiration		date
subscriptionExpiration		date

Response Formats

application/json, text/json

Sample:

{
  "charge": {
    "items": [
      {
        "name": "Silver Spend",
        "price": 1500.0,
        "currency": "USD",
        "type": "SearchCampaignFee",
        "partnerSKU": null,
        "exchangeRate": 0.071008
      },
      {
        "name": "Silver Fee",
        "price": 100.0,
        "currency": "USD",
        "type": "SearchCampaignSpend",
        "partnerSKU": null,
        "exchangeRate": 0.071008
      }
    ],
    "termRatio": 1.0
  },
  "googleCoupon": null,
  "id": 111,
  "name": "My campaign",
  "status": "Active",
  "type": "Search",
  "endDate": null,
  "subscription": {
    "budget": 1500.0,
    "currency": "USD",
    "active": true,
    "type": "SearchCampaign",
    "billingType": "Automatic",
    "nextCharge": "2025-07-30T02:49:26.5580935+00:00"
  },
  "partnerSKUs": null,
  "budgetLockExpiration": null,
  "subscriptionExpiration": null
}

application/xml, text/xml

Sample:

<CampaignSubscriptionCharge xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SiteWit.PartnerAPI.Models.ReturnModels">
  <budgetLockExpiration i:nil="true" />
  <endDate i:nil="true" />
  <id>111</id>
  <name>My campaign</name>
  <partnerSKUs i:nil="true" />
  <status>Active</status>
  <subscription>
    <active>true</active>
    <billingType>Automatic</billingType>
    <budget>1500</budget>
    <currency>USD</currency>
    <nextCharge>2025-07-30T02:49:26.5580935+00:00</nextCharge>
    <type>SearchCampaign</type>
  </subscription>
  <subscriptionExpiration i:nil="true" />
  <type>Search</type>
  <charge>
    <items>
      <ChargeItem>
        <currency>USD</currency>
        <exchangeRate>0.071008</exchangeRate>
        <name>Silver Spend</name>
        <partnerSKU i:nil="true" />
        <price>1500</price>
        <type>SearchCampaignFee</type>
      </ChargeItem>
      <ChargeItem>
        <currency>USD</currency>
        <exchangeRate>0.071008</exchangeRate>
        <name>Silver Fee</name>
        <partnerSKU i:nil="true" />
        <price>100</price>
        <type>SearchCampaignSpend</type>
      </ChargeItem>
    </items>
    <termRatio>1</termRatio>
  </charge>
  <googleCoupon i:nil="true" />
</CampaignSubscriptionCharge>