Skip to main content
GET
/
v1
/
coupons
/
{uuid_code}
Get coupon
curl --request GET \
  --url https://api.example.com/v1/coupons/{uuid_code}
{
  "data": {
    "name": "PARTNERO25",
    "uuid_code": "coupon_123",
    "active": true,
    "coupon_discount_type": "percent",
    "coupon_discount_amount": 25,
    "coupon_duration_type": "months",
    "coupon_duration_value": 11,
    "redemption_specific_date_status": false,
    "redemption_specific_date_value": null,
    "redemption_times_status": true,
    "redemption_times_value": 24,
    "metadata": [],
    "additional_info": [],
    "times_redeemed": 3,
    "created_at": "2025-05-07T17:43:26.000000Z",
    "updated_at": "2025-05-07T17:43:26.000000Z",
    "deleted_at": null
  },
  "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/coupons/{uuid_code}

​
Path Parameters

ParameterTypeRequiredDescription
uuid_codestringYesCoupon’s unique UUID code

​
Request

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

​
Response

{
  "data": {
    "name": "PARTNERO25",
    "uuid_code": "coupon_123",
    "active": true,
    "coupon_discount_type": "percent",
    "coupon_discount_amount": 25,
    "coupon_duration_type": "months",
    "coupon_duration_value": 11,
    "redemption_specific_date_status": false,
    "redemption_specific_date_value": null,
    "redemption_times_status": true,
    "redemption_times_value": 24,
    "metadata": [],
    "additional_info": [],
    "times_redeemed": 3,
    "created_at": "2025-05-07T17:43:26.000000Z",
    "updated_at": "2025-05-07T17:43:26.000000Z",
    "deleted_at": null
  },
  "status": 1
}

​
Response Fields

FieldTypeDescription
data.namestringCustomer-facing coupon name
data.uuid_codestringUnique coupon identifier
data.activebooleanWhether coupon is active
data.coupon_discount_typestringpercent or static
data.coupon_discount_amountnumberDiscount amount or percentage
data.coupon_duration_typestringDuration type
data.coupon_duration_valueintegerDuration value
data.redemption_times_statusbooleanWhether redemption limit is enabled
data.redemption_times_valueintegerMax redemptions allowed
data.times_redeemedintegerTotal number of times this coupon has been redeemed
data.additional_infoobjectInternal data, including a redemptions log when redemptions are recorded via the API