Skip to main content
Promotion Details
curl --request GET \
  --url https://api.paritydeals.com/api/v1/deals/discount/
{
  "bar": {
    "backgroundColor": "#04888e",
    "backgroundTransparency": "0",
    "fontColor": "#59ebf1",
    "highlightFontColor": "#DD5C64",
    "placement": "top",
    "borderRadius": "0",
    "addCloseIcon": false,
    "noStyle": false
  },
  "couponCode": "PD8CEXAAJL",
  "discountPercentage": "50.00",
  "data": {
    "stripePromoCodeId": "promo_1RaFH8EEwDDegOMGqiAG"
  },
  "country": "India",
  "countryFlag": "🇮🇳",
  "countryFlagSvg": "<svg  viewBox=\"0 0 132 99\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g filter=\"url(#filter0_dd_1104_22880)\"><g clip-path=\"url(#clip0_1104_22880)\"><rect x=\"7.5\" y=\"3\" width=\"117.6\" height=\"84\" rx=\"9.14286\" fill=\"white\"/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M7.5 59H125.1V87H7.5V59Z\" fill=\"#249F58\"/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M66.2997 59C74.0277 59 80.2997 52.728 80.2997 45C80.2997 37.272 74.0277 31 66.2997 31C58.5717 31 52.2997 37.272 52.2997 45C52.2997 52.728 58.5717 59 66.2997 59ZM66.2997 53.4C70.9365 53.4 74.6997 49.6368 74.6997 45C74.6997 40.3632 70.9365 36.6 66.2997 36.6C61.6629 36.6 57.8997 40.3632 57.8997 45C57.8997 49.6368 61.6629 53.4 66.2997 53.4Z\" fill=\"#1A47B8\"/><path d=\"M66.2994 47.8001C67.8458 47.8001 69.0994 46.5465 69.0994 45.0001C69.0994 43.4537 67.8458 42.2001 66.2994 42.2001C64.753 42.2001 63.4994 43.4537 63.4994 45.0001C63.4994 46.5465 64.753 47.8001 66.2994 47.8001Z\" fill=\"#1A47B8\"/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M7.5 3H125.1V31H7.5V3Z\" fill=\"#FF6C2D\"/></g></g><defs><filter id=\"filter0_dd_1104_22880\" x=\"0.642857\" y=\"0.714285\" width=\"131.316\" height=\"97.7143\" filterUnits=\"userSpaceOnUse\" color-interpolation-filters=\"sRGB\"><feFlood flood-opacity=\"0\" result=\"BackgroundImageFix\"/><feColorMatrix in=\"SourceAlpha\" type=\"matrix\" values=\"0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0\" result=\"hardAlpha\"/><feOffset dy=\"4.57143\"/><feGaussianBlur stdDeviation=\"3.42857\"/><feComposite in2=\"hardAlpha\" operator=\"out\"/><feColorMatrix type=\"matrix\" values=\"0 0 0 0 0.258824 0 0 0 0 0.278431 0 0 0 0 0.298039 0 0 0 0.08 0\"/><feBlend mode=\"normal\" in2=\"BackgroundImageFix\" result=\"effect1_dropShadow_1104_22880\"/><feColorMatrix in=\"SourceAlpha\" type=\"matrix\" values=\"0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0\" result=\"hardAlpha\"/><feOffset/><feGaussianBlur stdDeviation=\"0.285714\"/><feComposite in2=\"hardAlpha\" operator=\"out\"/><feColorMatrix type=\"matrix\" values=\"0 0 0 0 0.258824 0 0 0 0 0.278431 0 0 0 0 0.298039 0 0 0 0.32 0\"/><feBlend mode=\"normal\" in2=\"effect1_dropShadow_1104_22880\" result=\"effect2_dropShadow_1104_22880\"/><feBlend mode=\"normal\" in=\"SourceGraphic\" in2=\"effect2_dropShadow_1104_22880\" result=\"shape\"/></filter><clipPath id=\"clip0_1104_22880\"><rect x=\"7.5\" y=\"3\" width=\"117.6\" height=\"84\" rx=\"9.14286\" fill=\"white\"/></clipPath></defs></svg>",
  "holiday": null,
  "time": null,
  "message": "<b>50% OFF</b> for India!",
  "messageText": "50% OFF for India!",
  "countryCode": "IN",
  "currencyCode": "INR",
  "currencySymbol": "₹",
  "pricingLocale": "en-IN",
  "usdConversionRate": "82.2",
  "baseCurrencyConversionRate": "82.2",
  "isVpn": false,
  "isProxy": false,
  "isTor": false
}

Query Parameters

​
product_id
string

Required for client-side API calls. The unique identifier for the product for which to retrieve a discount.

​
pd_identifier
string

Required for server-side API calls. A unique identifier associated with a particular deal.

​
ip_address
string<ipv4>

Required for server-side API calls. The user's IP address.

​
base_currency_code
string

Optional for server-side API calls. The desired base currency code for the discount information (e.g., EUR).

Response

200 - application/json

Successful retrieval of discount information. The response structure varies depending on whether a discount is available and if the user is accessing via a VPN.

​
bar
object
​
couponCode
string | null
​
discountPercentage
string
​
data
object
​
country
string
​
countryFlag
string
​
countryFlagSvg
string
​
holiday
string | null
​
time
string | null
​
message
string
​
messageText
string
​
countryCode
string
​
currencyCode
string
​
currencySymbol
string
​
pricingLocale
string
​
usdConversionRate
string
​
baseCurrencyConversionRate
string
​
isVpn
boolean
​
isProxy
boolean
​
isTor
boolean