Get a promo code (discount)
Returns one of the company’s promo codes (discounts) with its full configuration, eligibility rules, schedule, and usage count, including any customer emails uploaded by CSV. It also returns a manual discount by id, although the list endpoint excludes manual discounts. Requires a company admin Bearer token with coupons view permission. Returns 404 when the discount does not exist in the company.
curl --request GET \
--url https://api.fluid.app/api/v2025-06/discounts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v2025-06/discounts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v2025-06/discounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v2025-06/discounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v2025-06/discounts/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v2025-06/discounts/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v2025-06/discounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": 5821,
"code": "PAPERDAY10",
"name": "PAPERDAY10",
"description": "10% off orders over $50 for National Paper Day week",
"price_discount_type": "percentage",
"price_discount_amount": 0,
"price_discount_percent": 10,
"percentage_value": "10.0",
"source": "promo",
"value_managed_by_droplet": false,
"reason": null,
"created_by": {
"id": 20410,
"full_name": "Michael Scott"
},
"active": true,
"automatic": false,
"applicable_for": "everything",
"apply_only_once": false,
"apply_to_subscriptions": false,
"apply_to_recurring_subscription_orders": false,
"apply_to_volume": false,
"country_filter": "apply_all",
"customer_filter": "all_customers",
"shipping_method_filter": "apply_all_methods",
"purchase_requirement": "minimum_purchase_amount",
"purchase_requirement_applies_to_whole_cart": true,
"has_end_date": true,
"start_date_time": "2026-09-20T04:00:00.000Z",
"end_date_time": "2026-10-01T03:59:00.000Z",
"start_date": "2026-09-20",
"start_time": "00:00",
"end_date": "2026-09-30",
"end_time": "23:59",
"time_zone": "America/New_York",
"discount_type": "product_discount",
"total_usage": 37,
"free_variant_ids": [],
"free_enrollment_pack_ids": [],
"waive_enrollment_fee": false,
"exclude_free_items_from_volume": false,
"applicable_product_ids": [],
"inapplicable_product_ids": [],
"applicable_collection_ids": [],
"applicable_enrollment_pack_ids": [],
"inapplicable_enrollment_pack_ids": [],
"collection_ids": [],
"product_ids": [],
"customer_ids": [],
"country_codes": [],
"eligible_customer_ids": [],
"csv_uploaded_customer_emails": [],
"eligible_country_ids": [],
"ineligible_country_ids": [],
"eligible_shipping_method_ids": [],
"eligible_customer_segments": [],
"minimum_purchase_requirement_amount": 50,
"minimum_purchase_requirement_amount_max": null,
"minimum_purchase_requirement_quantity": 0,
"minimum_cv": null,
"maximum_cv": null,
"customer_usage_limit": 1,
"minimum_amount_cents": 50,
"limit_usage_of_code": false,
"limit_usage_per_customer": true,
"other_shipping_discounts": true,
"other_product_discounts": false,
"created_at": "2026-09-10T19:04:22Z",
"updated_at": "2026-09-10T19:04:22Z",
"meta": {
"request_id": "4f1c2a9e-7b3d-4e8a-9c61-2d5f8a0b3e17",
"timestamp": "2026-09-15T14:32:08Z"
}
}{
"message": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 123,
"prev_cursor": "<string>",
"next_cursor": "<string>",
"total_count": 123
}
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 123,
"prev_cursor": "<string>",
"next_cursor": "<string>",
"total_count": 123
}
}
}Authorizations
Response
Success
What the code gives. percentage: takes percentage_value percent off each matching line. flat: takes flat_value off (see flat_value). free_product: adds the variants in free_variant_ids to the cart at no charge. free_shipping: waives shipping on the cart. free_enrollment_pack: makes the lines added from the packs in free_enrollment_pack_ids free. For stacking, free_shipping counts as a shipping discount and every other type counts as a product discount.
flat, percentage, free_product, free_shipping, free_enrollment_pack Who manages the discount. promo: a merchant promo code that shoppers can enter. droplet: created by a droplet and not redeemable at customer checkout. manual: a one-off discount an admin applied to a cart; the list endpoint never returns these. subscription_pro: a tier or offer discount that Subscription Pro manages; the list endpoint returns these only with source=subscription_pro, and update and delete refuse them.
promo, manual, droplet, subscription_pro Which cart lines the discount targets. everything, specific_products, except_specific_products, specific_collections, specific_enrollment_packs, or except_specific_enrollment_packs; see the request field of the same name. Null for manual discounts.
everything, specific_products, specific_collections, except_specific_products, specific_enrollment_packs, except_specific_enrollment_packs, null curl --request GET \
--url https://api.fluid.app/api/v2025-06/discounts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v2025-06/discounts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v2025-06/discounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v2025-06/discounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v2025-06/discounts/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v2025-06/discounts/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v2025-06/discounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": 5821,
"code": "PAPERDAY10",
"name": "PAPERDAY10",
"description": "10% off orders over $50 for National Paper Day week",
"price_discount_type": "percentage",
"price_discount_amount": 0,
"price_discount_percent": 10,
"percentage_value": "10.0",
"source": "promo",
"value_managed_by_droplet": false,
"reason": null,
"created_by": {
"id": 20410,
"full_name": "Michael Scott"
},
"active": true,
"automatic": false,
"applicable_for": "everything",
"apply_only_once": false,
"apply_to_subscriptions": false,
"apply_to_recurring_subscription_orders": false,
"apply_to_volume": false,
"country_filter": "apply_all",
"customer_filter": "all_customers",
"shipping_method_filter": "apply_all_methods",
"purchase_requirement": "minimum_purchase_amount",
"purchase_requirement_applies_to_whole_cart": true,
"has_end_date": true,
"start_date_time": "2026-09-20T04:00:00.000Z",
"end_date_time": "2026-10-01T03:59:00.000Z",
"start_date": "2026-09-20",
"start_time": "00:00",
"end_date": "2026-09-30",
"end_time": "23:59",
"time_zone": "America/New_York",
"discount_type": "product_discount",
"total_usage": 37,
"free_variant_ids": [],
"free_enrollment_pack_ids": [],
"waive_enrollment_fee": false,
"exclude_free_items_from_volume": false,
"applicable_product_ids": [],
"inapplicable_product_ids": [],
"applicable_collection_ids": [],
"applicable_enrollment_pack_ids": [],
"inapplicable_enrollment_pack_ids": [],
"collection_ids": [],
"product_ids": [],
"customer_ids": [],
"country_codes": [],
"eligible_customer_ids": [],
"csv_uploaded_customer_emails": [],
"eligible_country_ids": [],
"ineligible_country_ids": [],
"eligible_shipping_method_ids": [],
"eligible_customer_segments": [],
"minimum_purchase_requirement_amount": 50,
"minimum_purchase_requirement_amount_max": null,
"minimum_purchase_requirement_quantity": 0,
"minimum_cv": null,
"maximum_cv": null,
"customer_usage_limit": 1,
"minimum_amount_cents": 50,
"limit_usage_of_code": false,
"limit_usage_per_customer": true,
"other_shipping_discounts": true,
"other_product_discounts": false,
"created_at": "2026-09-10T19:04:22Z",
"updated_at": "2026-09-10T19:04:22Z",
"meta": {
"request_id": "4f1c2a9e-7b3d-4e8a-9c61-2d5f8a0b3e17",
"timestamp": "2026-09-15T14:32:08Z"
}
}{
"message": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 123,
"prev_cursor": "<string>",
"next_cursor": "<string>",
"total_count": 123
}
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 123,
"prev_cursor": "<string>",
"next_cursor": "<string>",
"total_count": 123
}
}
}