Apple-specific image URL fields on items

What's new

Five Apple-specific image URL fields are now exposed on item responses across all item-bearing endpoints: image_url_apple, image_url_featured_apple, icon_url_apple, background_image_url_apple, and featured_card_background_image_url_apple. All five fields are marked deprecated on introduction.

Impact

These fields surface the previously internal Apple-specific image variants on items, lootboxes, subscriptions, and virtual currencies wherever item data is returned. Because they are deprecated, do not build new integrations against them — use the standard image_url, icon_url, background_image_url, and featured_card_background_image_url fields instead.

Changes

Resource	Change
get_item, get_items, create_item, update_item, bulk_create_or_update_items, bulk_update_items, translate_item	Added deprecated optional Apple image URL fields to item responses
get_store_items, get_all_store_items, get_user_store_items, get_campaign_store_items, create_store_item, update_store_item, bulk_update_store_items	Added deprecated optional Apple image URL fields to all nested item subtypes in response
get_coupon, get_coupons, get_user_coupons, create_coupon, update_coupon, bulk_update_coupon	Added deprecated optional Apple image URL fields to item in response
get_cashback_reward, get_cashback_rewards, create_cashback_reward, update_cashback_reward	Added deprecated optional Apple image URL fields to item in response
get_daily_reward, get_daily_rewards, create_daily_reward, update_daily_reward, copy_daily_reward	Added deprecated optional Apple image URL fields to all nested item types in response
get_loyalty_tiers, update_loyalty_tiers	Added deprecated optional Apple image URL fields to tier item responses

Upgrade

• Continue to read the standard image URL fields (image_url, icon_url, background_image_url, featured_card_background_image_url, image_url_featured) — they remain the source of truth.
• Treat the new *_apple fields as deprecated. Do not depend on them for new work; plan to remove any references in existing integrations.

Need help?
Contact our integration team at [email protected]