curl --request GET \
--url https://playground.runa.io/v2/product/{product_code} \
--header 'X-Api-Key: <api-key>'
{
"name": "Example Merchant",
"code": "XYZ-US",
"currency": "USD",
"state": "LIVE",
"is_orderable": true,
"payout_type": "gift_card",
"categories": [
"food-and-drink",
"entertainment"
],
"countries_redeemable_in": [
"US"
],
"customer_service": {
"phone_number": "+1234567890",
"website_url": "https://merchant.example.com/customer-service"
},
"discount_multiplier": "0.05",
"availability": "realtime",
"gift_card": {
"assets": {
"card_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-card.png",
"icon_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-icon.png",
"primary_color": "#000000"
},
"balance_check_url": "https://merchant.example.com/balance-check",
"content_resources": {
"description_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/description.md",
"disclaimer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/disclaimer_markdown.md",
"refund_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/refund_policy_markdown.md",
"reissuance_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/reissuance_policy_markdown.md",
"terms_buyer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_buyer.md",
"terms_consumer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_consumer.md",
"redemption_instructions_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/redeem_markdown.md",
"locale": "en_US"
},
"expiry": {
"date_policy": "Expires 2 years from issue date",
"in_months": 12,
"type": "from-issue-date"
},
"redeemable_at": "all",
"website_url": "https://merchant.example.com",
"barcode_format": "code-128",
"e_code_usage_type": "url-only",
"denominations": {
"type": "fixed",
"minimum_value": "10.00",
"maximum_value": "100.00",
"available_list": [
"10.00",
"20.00",
"50.00",
"100.00"
]
}
},
"subscription": {
"assets": {
"card_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-card.png",
"icon_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-icon.png",
"primary_color": "#000000"
},
"balance_check_url": "https://merchant.example.com/balance-check",
"content_resources": {
"description_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/description.md",
"disclaimer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/disclaimer_markdown.md",
"refund_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/refund_policy_markdown.md",
"reissuance_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/reissuance_policy_markdown.md",
"terms_buyer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_buyer.md",
"terms_consumer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_consumer.md",
"redemption_instructions_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/redeem_markdown.md",
"locale": "en_US"
},
"expiry": {
"date_policy": "Expires 2 years from issue date",
"in_months": 12,
"type": "from-issue-date"
},
"redeemable_at": "all",
"website_url": "https://merchant.example.com",
"barcode_format": "code-128",
"e_code_usage_type": "url-only",
"subscription_plans": [
{
"length_unit": "MONTHS",
"length": 12,
"name": "3 month subscription",
"price": "10.00",
"subscription_plan_code": "XYZ-US-SUB-1"
}
]
},
"payment": {
"assets": {
"icon_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-icon.png",
"primary_color": "#000000"
},
"denominations": {
"minimum_value": "10.00",
"maximum_value": "100.00"
},
"content_resources": {
"description_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/description.md",
"disclaimer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/disclaimer_markdown.md",
"refund_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/refund_policy_markdown.md",
"reissuance_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/reissuance_policy_markdown.md",
"terms_buyer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_buyer.md",
"terms_consumer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_consumer.md",
"redemption_instructions_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/redeem_markdown.md",
"locale": "en_US"
}
}
}
Retrieve a single product’s details
curl --request GET \
--url https://playground.runa.io/v2/product/{product_code} \
--header 'X-Api-Key: <api-key>'
{
"name": "Example Merchant",
"code": "XYZ-US",
"currency": "USD",
"state": "LIVE",
"is_orderable": true,
"payout_type": "gift_card",
"categories": [
"food-and-drink",
"entertainment"
],
"countries_redeemable_in": [
"US"
],
"customer_service": {
"phone_number": "+1234567890",
"website_url": "https://merchant.example.com/customer-service"
},
"discount_multiplier": "0.05",
"availability": "realtime",
"gift_card": {
"assets": {
"card_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-card.png",
"icon_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-icon.png",
"primary_color": "#000000"
},
"balance_check_url": "https://merchant.example.com/balance-check",
"content_resources": {
"description_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/description.md",
"disclaimer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/disclaimer_markdown.md",
"refund_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/refund_policy_markdown.md",
"reissuance_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/reissuance_policy_markdown.md",
"terms_buyer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_buyer.md",
"terms_consumer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_consumer.md",
"redemption_instructions_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/redeem_markdown.md",
"locale": "en_US"
},
"expiry": {
"date_policy": "Expires 2 years from issue date",
"in_months": 12,
"type": "from-issue-date"
},
"redeemable_at": "all",
"website_url": "https://merchant.example.com",
"barcode_format": "code-128",
"e_code_usage_type": "url-only",
"denominations": {
"type": "fixed",
"minimum_value": "10.00",
"maximum_value": "100.00",
"available_list": [
"10.00",
"20.00",
"50.00",
"100.00"
]
}
},
"subscription": {
"assets": {
"card_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-card.png",
"icon_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-icon.png",
"primary_color": "#000000"
},
"balance_check_url": "https://merchant.example.com/balance-check",
"content_resources": {
"description_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/description.md",
"disclaimer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/disclaimer_markdown.md",
"refund_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/refund_policy_markdown.md",
"reissuance_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/reissuance_policy_markdown.md",
"terms_buyer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_buyer.md",
"terms_consumer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_consumer.md",
"redemption_instructions_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/redeem_markdown.md",
"locale": "en_US"
},
"expiry": {
"date_policy": "Expires 2 years from issue date",
"in_months": 12,
"type": "from-issue-date"
},
"redeemable_at": "all",
"website_url": "https://merchant.example.com",
"barcode_format": "code-128",
"e_code_usage_type": "url-only",
"subscription_plans": [
{
"length_unit": "MONTHS",
"length": 12,
"name": "3 month subscription",
"price": "10.00",
"subscription_plan_code": "XYZ-US-SUB-1"
}
]
},
"payment": {
"assets": {
"icon_image_url": "https://gift.runa.io/static/product_assets/XYZ-US/XYZ-US-icon.png",
"primary_color": "#000000"
},
"denominations": {
"minimum_value": "10.00",
"maximum_value": "100.00"
},
"content_resources": {
"description_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/description.md",
"disclaimer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/disclaimer_markdown.md",
"refund_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/refund_policy_markdown.md",
"reissuance_policy_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/reissuance_policy_markdown.md",
"terms_buyer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_buyer.md",
"terms_consumer_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/terms_consumer.md",
"redemption_instructions_markdown_url": "https://d2abcdef.cloudfront.net/resources/XYZ-US/redeem_markdown.md",
"locale": "en_US"
}
}
}
XYZ-US
.
This endpoint returns different payout types:
gift_card
: A gift card is a payout that can be redeemed for a specific value.subscription
: A subscription is a payout that can be ordered for a specific duration.payment
: A payment is a payout that can be ordered for a specific value.payout_type
field to determine which object to use to extract details for the product. The different payout types have different fields, so you should use the appropriate object to extract the details you need.
This endpoint supports returning product content in different formats. See the content parameter for more details.
The dated version of the API, if not specified a default is used. See API versioning for more information.
The code of the product.
Defines the format for product content resources.
url
(default) for external URLs to markdown contentmd
for Markdown content in the responsehtml
for rendered HTML in the responseurl
, md
, html
OK
Product details
Was this page helpful?