Skip to main content
GET
/
v1
/
promotion-codes
/
{code}
Get promotion code
curl --request GET \
  --url https://api.example.com/v1/promotion-codes/{code}
{
  "data": {
    "code": "PROMO123",
    "first_time_order": true,
    "limit_to_specific_partner": false,
    "coupon_specific_partners": [],
    "limit_to_specific_customer": false,
    "coupon_specific_customers": [],
    "minimum_order_status": true,
    "minimum_order_value": 22,
    "expiration_date_status": false,
    "expiration_date_value": null,
    "redemption_times_status": false,
    "redemption_times_value": null,
    "metadata": [],
    "additional_info": [],
    "times_redeemed": 2,
    "coupon": {
      "name": "PARTNERO25",
      "uuid_code": "coupon_123",
      "active": true,
      "coupon_discount_type": "percent",
      "coupon_discount_amount": 25,
      "coupon_duration_type": "months",
      "coupon_duration_value": 11,
      "created_at": "2025-05-09T06:22:59.000000Z",
      "updated_at": "2025-05-09T06:23:44.000000Z"
    }
  },
  "status": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.partnero.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

GET https://api.partnero.com/v1/promotion-codes/{code}

​
Path Parameters

ParameterTypeRequiredDescription
codestringYesThe promotion code

​
Request

cURL
curl --location 'https://api.partnero.com/v1/promotion-codes/PROMO123' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Response

{
  "data": {
    "code": "PROMO123",
    "first_time_order": true,
    "limit_to_specific_partner": false,
    "coupon_specific_partners": [],
    "limit_to_specific_customer": false,
    "coupon_specific_customers": [],
    "minimum_order_status": true,
    "minimum_order_value": 22,
    "expiration_date_status": false,
    "expiration_date_value": null,
    "redemption_times_status": false,
    "redemption_times_value": null,
    "metadata": [],
    "additional_info": [],
    "times_redeemed": 2,
    "coupon": {
      "name": "PARTNERO25",
      "uuid_code": "coupon_123",
      "active": true,
      "coupon_discount_type": "percent",
      "coupon_discount_amount": 25,
      "coupon_duration_type": "months",
      "coupon_duration_value": 11,
      "created_at": "2025-05-09T06:22:59.000000Z",
      "updated_at": "2025-05-09T06:23:44.000000Z"
    }
  },
  "status": 1
}

​
Response Fields

FieldTypeDescription
data.codestringThe promotion code
data.couponobjectThe associated coupon details
data.first_time_orderbooleanValid only for first-time orders
data.minimum_order_valuenumberMinimum order amount required
data.times_redeemedintegerTotal number of redemptions for this code
data.additional_infoobjectInternal data, including a redemptions log when redemptions are recorded via the API