Gift Cards

Public gift-card balance / validity check

Public, unauthenticated endpoint. Rate-limited per source IP. Returns balance + status for a given code. Use this from checkout flows to verify a card before redeeming.

get/api/v1/gift-cards/validate

Request

  • Base URL: https://makeup.land
  • URL: https://makeup.land/api/v1/gift-cards/validate
  • Auth: none required

Query parameters

codestring required

Gift card code. Dashes are accepted (case-insensitive); normalized server-side.

Response

Gift card snapshot

statusstring required

active / depleted / similar

balance_centsinteger required

Amount in integer agorot (100 = ₪1)

initial_amount_centsinteger required

Amount in integer agorot (100 = ₪1)

currency'ILS' required

ISO 4217 currency code

Changes

No recorded changes to this operation across all 1 revision of this API.