---
updatedAt: 2026-07-28T12:55:35.000Z
agentTools:
  projectIndex: https://docs.ifeelgoods.com/llms.txt
---

# Get a Reward

Use this function to retrieve detailed description about a reward

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "paths": {
    "/fulfillment/v2/rewards/{sku}": {
      "get": {
        "summary": "Get a Reward",
        "tags": [
          "Rewards"
        ],
        "operationId": "getRewardBySKU",
        "description": "Use this function to retrieve detailed description about a reward",
        "security": [
          {
            "bearer_auth": []
          },
          {
            "api_key": [],
            "api_secret": []
          }
        ],
        "parameters": [
          {
            "name": "sku",
            "in": "path",
            "required": true,
            "description": "The reward SKU",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requested reward details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/reward_details"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "The authenticated user does not have permission to access this resource.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error_name": {
                      "type": "string",
                      "example": "forbidden"
                    },
                    "error_message": {
                      "type": "string",
                      "example": "The authenticated user does not have permission to access this resource.",
                      "nullable": true
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "The requested resource could not be found.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error_name": {
                      "type": "string",
                      "example": "not_found"
                    },
                    "error_message": {
                      "type": "string",
                      "example": "The requested resource could not be found.",
                      "nullable": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearer_auth": {
        "type": "http",
        "scheme": "bearer"
      },
      "api_key": {
        "type": "apiKey",
        "name": "Api-Key",
        "in": "header"
      },
      "api_secret": {
        "type": "apiKey",
        "name": "Api-Secret",
        "in": "header"
      }
    },
    "schemas": {
      "reward_details": {
        "type": "object",
        "description": "A Reward (aka Product SKU) is a specific denomination of a Digital or Physical Gift that can be delivered to a User. \"iTunes Code 10$ (US)\" is a Reward.",
        "properties": {
          "name": {
            "type": "string",
            "example": "Uggy Gift Card 10€",
            "description": "Reward name (eg. `$10 iTunes® Code`)."
          },
          "sku": {
            "type": "string",
            "example": "APP-ITC-10USD-US",
            "description": "Unique identifier that represents the reward (eg. `APP-ITC-10USD-US`). It must be used with the redeem APIs."
          },
          "denomination": {
            "type": "string",
            "example": "10€",
            "description": "Reward formatted value with currency (eg. `$10`)."
          },
          "display_value": {
            "type": "string"
          },
          "free_value": {
            "type": "boolean",
            "description": "Indicates whether the reward should be redeemed with a value. Range can be found in dimensions.available_denominations_range."
          },
          "cost": {
            "type": "number",
            "example": 9,
            "nullable": true,
            "description": "Reward cost for your account (eg. `9.0`). You need to query the API with the `client_id` parameter to retrieve the acutal cost, otherwise it will return `face_value`."
          },
          "cost_currency": {
            "type": "string",
            "example": "EUR",
            "description": "Reward cost currency (eg. `USD`, `EUR`)."
          },
          "face_value": {
            "type": "string",
            "example": "10.00",
            "description": "Reward face value, actual reward amount (e.g. `10.00`)."
          },
          "face_value_currency": {
            "type": "string",
            "example": "EUR",
            "description": "Reward face value currency. (eg. `EUR`)."
          },
          "in_stock": {
            "type": "boolean",
            "description": "Boolean that represent reward availability."
          },
          "stock_quantity": {
            "type": "integer",
            "example": 100,
            "nullable": true,
            "description": "Stock quantity. Can be `null` (if `stock_quantity` is `null`, `in_stock` is always `true`)."
          },
          "brand": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "example": "APP",
                "description": "Unique identifier that represents the brand (eg. `APP`)."
              },
              "name": {
                "type": "string",
                "example": "iTunes",
                "description": "Brand name (eg. `iTunes`)."
              },
              "status": {
                "type": "string",
                "enum": [
                  "active",
                  "deactivated"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri",
                "nullable": true,
                "description": "Brand URL (eg. `https://www.ifeelgoods.com`)."
              }
            },
            "description": "Reward brand. In ifeelgoods data model, it's a kind of 'parent' for the product."
          },
          "product": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "example": "APP-ITC",
                "description": "Unique identifier for the product (eg. `APP-ITC`)."
              },
              "name": {
                "type": "string",
                "example": "iTunes Code",
                "description": "The product name (eg. `iTunes Code`)."
              },
              "deliverable_as_pdf": {
                "type": "boolean",
                "description": "Indicates whether the product can be delivered as PDF or not."
              },
              "vat_rate": {
                "type": "number",
                "example": 0.19,
                "description": "Indicates product VAT rate."
              },
              "vat_rule": {
                "type": "string",
                "enum": [
                  "BUU",
                  "BUM"
                ],
                "description": "Indicates product VAT rule (BUU or BUM)."
              }
            }
          },
          "product_type": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "enum": [
                  "item",
                  "gift_card",
                  "media_content",
                  "cash",
                  "subscription",
                  "coupon_and_promo_codes",
                  "points_and_miles",
                  "experience"
                ],
                "example": "gift_card",
                "description": "Unique identifier for the product type."
              },
              "name": {
                "type": "string",
                "enum": [
                  "Item",
                  "Gift Card",
                  "Media Content",
                  "Cash",
                  "Subscription",
                  "Coupon & Promo Codes",
                  "Points & Miles",
                  "Experience"
                ],
                "example": "Gift Card",
                "description": "The product type name."
              }
            }
          },
          "usages": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "tracking",
                "security",
                "primary",
                "url",
                "security_url",
                "security_url_code"
              ]
            },
            "example": [
              "primary"
            ],
            "description": "Reward code format"
          },
          "expiration_date": {
            "type": "string",
            "example": "2023-03-31",
            "nullable": true,
            "description": "Expiration date (eg. `2023-03-31`)"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Sports"
            ],
            "description": "Reward categories (eg. `['Games & Entertainment', 'Sports']`) (not maintained)."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "Reward description."
          },
          "country": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Reward country list (eg. `[\"US\", \"CA\"]` or `[\"WW\"]` if worldwide). If the reward is not specific to a country, it will be considered as worldwide.",
            "example": [
              "US",
              "CA"
            ]
          },
          "conditions_of_sale": {
            "type": "string",
            "enum": [
              "on_demand",
              "special_order_only"
            ],
            "nullable": true
          },
          "dimensions": {
            "type": "object",
            "description": "Additional structured attributes associated with a reward. Each key represents a dimension label and its value is the dimension value for that reward. Not all dimensions are present on every reward — only the ones configured for that specific product will appear.",
            "properties": {
              "available_denominations_range": {
                "type": "string",
                "nullable": true,
                "description": "Indicates the range of values that can be used with open value reward (when free_value is true) (eg. 5..250).",
                "example": "5..250"
              },
              "custom_offer": {
                "type": "string",
                "nullable": true,
                "description": "When a custom offer has been configured for this product (eg. buy one get one, $20 off the second article, etc.).",
                "example": "Buy one get one"
              },
              "validity_period": {
                "type": "string",
                "nullable": true,
                "description": "Duration during which the reward code remains valid after delivery. Expressed as a number followed by a unit: d for days, m for months, y for years (eg. 30d for 30 days, 12m for 12 months, 1y for 1 year). Returns null if no validity period applies.",
                "example": "30d"
              },
              "available_denominations": {
                "type": "string",
                "nullable": true,
                "description": "List of specific monetary amounts available for this reward."
              },
              "breakable": {
                "type": "string",
                "nullable": true,
                "description": "Indicates whether the reward code can be broken into smaller values."
              },
              "cumulable": {
                "type": "string",
                "nullable": true,
                "description": "Indicates whether multiple reward codes can be combined."
              },
              "denomination": {
                "oneOf": [
                  {
                    "type": "string",
                    "example": "10"
                  },
                  {
                    "type": "number",
                    "example": 10
                  }
                ],
                "nullable": true,
                "description": "Monetary amount of the reward (eg. 10€, $20, etc.).",
                "example": "10"
              },
              "denomination_currency": {
                "type": "string",
                "nullable": true,
                "description": "Currency of the denomination amount (eg. EUR, USD, etc.).",
                "example": "EUR"
              },
              "duration": {
                "type": "string",
                "nullable": true,
                "description": "Duration of a subscription or service (eg. 2 months).",
                "example": "2"
              },
              "duration_unit": {
                "type": "string",
                "nullable": true,
                "description": "Unit of the duration dimension. Possible values: minute, hour, day, week, month, year, varying_duration.",
                "example": "month"
              },
              "people": {
                "type": "string",
                "nullable": true,
                "description": "Number of people concerned by the reward.",
                "example": "2"
              },
              "quantity": {
                "type": "string",
                "nullable": true,
                "description": "Virtual currency amount associated with the reward (eg. 300 points, 200 miles, etc.).",
                "example": "300"
              },
              "quantity_unit": {
                "type": "string",
                "nullable": true,
                "description": "Unit of the quantity dimension. Possible values: points, miles, facebook_credits, minutes, movie, meal, e_magazine, e_ticket, song, lesson, box, subscription.",
                "example": "points"
              },
              "redemption_channel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Channel(s) through which the reward can be redeemed. Possible values: `online`, `in_store`.",
                  "example": "online"
                },
                "nullable": true
              }
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Reward tags (not maintained).",
            "deprecated": true
          },
          "targeting": {
            "type": "object",
            "properties": {
              "gender": {
                "type": "array",
                "items": {
                  "type": "string",
                  "example": "male"
                }
              },
              "age_range": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "18-24",
                  "25-34"
                ]
              },
              "reach": {
                "type": "string"
              }
            },
            "description": "Marketing information (not maintained)",
            "deprecated": true
          },
          "catalog_badge_url": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "example": "//cdn.ifeelgoods.com/image.png",
            "description": "Reward image, without scheme (eg. `//cdn.ifeelgoods.com/image.png`)."
          },
          "catalog_card_url": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "example": "//cdn.ifeelgoods.com/image.png",
            "description": "(legacy) Reward image (same as catalog_badge_url).",
            "deprecated": true
          },
          "logo_url": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "example": "//cdn.ifeelgoods.com/images/logo.png",
            "description": "Brand logo, without scheme (eg. `//cdn.ifeelgoods.com/logo.png`)."
          },
          "terms_and_conditions_url": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "example": "https//ifeelgoods.com/terms_and_conditions",
            "description": "Reward 'Terms and Conditions' URL (when provided by brand, `null` otherwise)."
          },
          "terms_and_conditions": {
            "type": "string",
            "nullable": true,
            "description": "Reward 'Terms and Conditions'."
          },
          "how_to_use_instructions": {
            "type": "string",
            "nullable": true,
            "description": "Reward 'How to use' instructions."
          },
          "important_instructions": {
            "type": "string",
            "nullable": true,
            "description": "Reward additional information."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://{environment}.ifeelgoods.com",
      "variables": {
        "environment": {
          "default": "api-sandbox",
          "enum": [
            "api-sandbox",
            "api"
          ],
          "description": "The environment to target. Use \"api-sandbox\" for testing"
        }
      }
    }
  ],
  "info": {
    "title": "Fulfillment API",
    "description": "Public API exposed to ifeelgoods customers.",
    "version": "v2",
    "x-sdk-version": "0.2.0"
  }
}
```