# Get Promotion Coupon By Reference ID

Get promotion coupon details by reference ID.
Requires the "VIEW" role in the "Promotion" group.

Endpoint: GET /api/v3/PromotionCoupon/ByReferenceID
Version: 3.1.0
Security: OAuth2_clientCredentials

## Query parameters:

  - `ReferenceID` (string)
    Invoice ID

## Response 200 fields (application/json):

  - `Code` (string)
    Coupon Code
    Example: "889977"

  - `Limit` (integer)
    Coupon Limit
    Example: 5

  - `Balance` (integer)
    Coupon Balance
    Example: 5

  - `Discount` (integer)
    Coupon Discount
    Example: 99

  - `Created` (string)
    Coupon Created Time
    Example: "2019-12-17T14:58:15.447"

  - `StartDate` (string)
    Coupon Start Time
    Example: "2019-12-01T00:00:00"

  - `ExpiryDate` (string)
    Coupon Expired Time
    Example: "2019-12-19T00:00:00"

  - `Type` (string)
    Coupon Type
    Example: "Discount"

  - `Description` (string)
    Coupon Description
    Example: "Discount percentage 99%"

  - `CustomerCode` (string)
    The customer code that assigned to the coupon
    Example: "DP-001"