UpPromote Public API
  1. Referral
UpPromote Public API
  • API overview
  • Affiliate
    • Get affiliates
      GET
    • Get affiliate by ID
      GET
    • Create an affiliate
      POST
    • Approve/Deny affiliate
      POST
    • Set upline for an affiliate
      POST
    • Move an affiliate to a program
      POST
    • Connect a customer to an affiliate
      POST
  • Coupon
    • Get coupons
      GET
    • Assign a coupon to an affiliate
      POST
  • Payment
    • Get unpaid payments
      GET
    • Get paid payments (History)
      GET
    • Count total paid payments
      GET
    • Get a payment by ID
      GET
    • Mark as paid a manual payment
      POST
  • Referral
    • Get list referrals
      GET
    • Get a referral by ID
      GET
    • Create a referral
      POST
    • Add referral adjustment
      POST
  • Webhook
    • Get webhook subscriptions
      GET
    • Subscribe a webhook event
      POST
    • Update a webhook subscription
      PUT
    • Delete a webhook subscription
      DELETE
  • Webhook Event Payload
    • Webhook overview
    • Referral new
      POST
    • Referral approved
      POST
    • Referral denied
      POST
    • Referral status changed
      POST
    • Affiliate new
      POST
    • Affiliate approved
      POST
    • Affiliate inactive
      POST
    • Affiliate status changed
      POST
    • Payment paid
      POST
  1. Referral

Get a referral by ID

GET
/api/v2/referrals/{id}

Request

Path Params

Header Params

Responses

🟢200Success
application/json
Body

🔴500Server Error
🟠401Unauthorized
🟠422Parameter Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://aff-api.uppromote.com/api/v2/referrals/' \
--header 'Accept: application/json' \
--header 'Authorization: ****************************' \
--header 'Content-Type: application/json'
Response Response Example
200 - Example 1
{
    "status": 200,
    "message": "success",
    "data": {
        "id": 1781736,
        "order_id": 6439217201474,
        "order_number": 3833,
        "customer_id": "8680153416002",
        "quantity": 1,
        "total_sales": "1075.00",
        "commission_rule": {
            "program_id": 29486,
            "commission_rate": "50.00",
            "commission_type": "Percent Of Sale"
        },
        "commission_adjustment": "0.00",
        "status": "approved",
        "commission": "537.50",
        "refund_id": null,
        "tracking_type": "Tracked by coupon",
        "affiliate": {
            "id": 2029214,
            "email": "example@gmail.com",
            "first_name": "Example",
            "last_name": "Test"
        },
        "coupon_applied": "COUPON_NAME",
        "customer_email": "customer-name@gmail.com",
        "created_at": "2025-09-24T09:28:10Z"
    }
}
Modified at 2025-10-06 04:50:27
Previous
Get list referrals
Next
Create a referral
Built with