Get Campaign Pricing

Get the Pricing information by Campaign ID.

URL: /rest-api/campaign/{campaignId}/pricing.do
Method: GET
Response format: application/json

Error codes:

  • 401 Unauthorized – authentication error.
  • 403 Forbidden – not enough permissions.
  • 404 Not Found – no Pricing for given Campaign.

Response sample:
200 OK

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • campaignId – the given Campaign ID

Update Campaign Pricing

Updates the Pricing information by Campaign ID.

URL: /rest-api/campaign/{campaignId}/pricing.do
Method: POST
Response format: application/json

Error codes:

  • 400 Bad Request – wrong request format. E.g., wrong types for parameters or Campaign ID doesn't exist.
  • 401 Unauthorized – authentication error.
  • 403 Forbidden – not enough permissions.

Request Parameters:

  • price – Campaign Pricing as a double.
  • paymentModel – FIXED_PRICE.
  • pricingType – CPM, CPC or CPA.

Response sample:
200 OK

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • campaignId – the given Campaign ID.

Update Campaign Pricing for Country

Update the Country Pricing information for Campaign ID.

URL: /rest-api/campaign/{campaignId}/pricing/{countryCode}.do
Method: POST
Response format: application/json

Error codes:

  • 400 Bad Request – wrong request format. E.g., wrong types for parameters, given Campaign or Country do not exist.
  • 401 Unauthorized – authentication error.
  • 403 Forbidden – not enough permissions.

Request Parameters:

price – Campaign Pricing as a double.

Response sample:
200 OK

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • campaignId – the given Campaign ID.
  • countryCode – ISO Country code. To pass multiple Country codes use: "UK, US, CA".

Batch update of Country Pricing

Update the Country Pricing information by Campaign ID from csv pricing file.

URL: /rest-api/campaign/{campaignId}/pricing/batch.do
Method: POST
Response format: application/json

Error codes:

  • 400 Bad Request – wrong request format. E.g. wrong types for parameters, Campaign doesn't exist, or Campaign Pricing is disabled.
  • 401 Unauthorized – authentication error.
  • 403 Forbidden – not enough permissions.

Request Parameters:

countryPricing – csv formatted file with country prices.

Response sample:
200 OK

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • campaignId – the given Campaign ID.
  • countryPrices – csv formatted file with country prices.

Update Pricing for CPA/CPC Campaign

URL: /rest-api/campaign/{campaignId}/campaignPricing/actionPricing.do

Method: POST

Response format: application/json

Error codes:

  • 400 Bad Request – wrong request format. E.g., wrong types for parameters or Campaign ID doesn't exist.
  • 401 Unauthorized – authentication error.
  • 403 Forbidden – not enough permissions.

Response sample:
200 OK

Request parameters:

  • price – Campaign Pricing as a double.
  • actionName – name of an existing action in specified Campaign as a String.
  • actionKey – key of an existing action in specified Campaign as a String.

Parameters:

  • hash – a MD5 digest of concatenated username's MD5 password and the given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • campaignId – the given Campaign ID.

Disable Pricing for the Campaign

Disables Campaign Pricing.

URL: /rest-api/campaigns/{campaignId}/pricing.do
Method: DELETE
Response format: application/json

Error codes:

  • 400 Bad Request – wrong request format. E.g., Campaign doesn't exist.
  • 401 Unauthorized – authentication error.
  • 403 Forbidden – not enough permissions.

Response sample:
200 OK

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • campaignId – the given Campaign ID.

Need more help?

Should you require any additional help with our solutions, do not hesitate to contact Epom technical support at support@epom.com. Our support managers are dedicated to resolving any issues and providing you with solutions and support if you face difficulties or have questions.