{"name":"UniVoucher API v1","version":"1.0.0","description":"This is a read-only API and is designed to provide information about the UniVoucher ecosystem. You can use it to retrieve details about gift cards, query cards associated with specific addresses or blockchains, check current protocol fees, and more.","timestamp":"2026-05-25T18:57:47.437Z","endpoints":{"/health":{"description":"Health check endpoint","methods":["GET"],"response":"Service health status"},"/cards":{"description":"Card-related endpoints","subEndpoints":{"/all":{"description":"Get all cards with filtering options","methods":["GET"],"parameters":{"page":"Page number for pagination (default: 1)","limit":"Results per page (default: 20) - Set to 0 for stats only.","status":"Filter by card status (active, redeemed, cancelled)","chain":"Filter by chain ID","creator":"Filter by creator address","redeemedBy":"Filter by redeemer address","belongTo":"Filter to cards created by OR redeemed by this address. If creator or redeemedBy are also specified, they take precedence over the corresponding parts of belongTo.","tokenAddress":"Filter by token address (use 0x0000000000000000000000000000000000000000 for native currency)","sortDirection":"Sort direction for results based on creation date (asc or desc, default: desc)"}},"/single":{"description":"Get a single card by ID or slot ID","methods":["GET"],"parameters":{"id":"Card ID to look up","slotId":"Slot ID to look up"}},"/create":{"description":"Create new gift cards (POST)","methods":["POST"],"parameters":{"network":"Chain ID for the network (required)","tokenAddress":"Token address (zero address for native tokens) (required)","amount":"Amount in wei (required)","quantity":"Number of cards to create (1-100, default: 1)","privateKey":"Issuer private key (required)","orderId":"Order ID for reference (required)","callbackUrl":"Callback URL for notifications (required)","authToken":"Authentication token for callback verification (required)","message":"Optional message to attach to cards"}}}},"/fees":{"description":"Fee-related endpoints","subEndpoints":{"/current":{"description":"Get current fee percentages","methods":["GET"],"parameters":{"chainId":"Optional chain ID to filter by"}},"/history/{chainId}":{"description":"Get fee update history for a chain","methods":["GET"],"parameters":{"chainId":"Chain ID (required)"}}}},"/chains":{"description":"Chain-related endpoints","methods":["GET"],"parameters":{"chain":"Optional chain ID to filter by"}},"/events":{"description":"Raw blockchain event log endpoints","subEndpoints":{"/all":{"description":"Get all raw blockchain events with filtering options","methods":["GET"],"parameters":{"page":"Page number for pagination (default: 1)","limit":"Results per page (default: 20) - Set to 0 for stats only.","sortBy":"Sort field: timestamp or blockNumber (default: timestamp)","sortDirection":"Sort direction: asc or desc (default: desc)","chainId":"Filter by chain ID","eventType":"Filter by event type (CardCreated, CardRedeemed, CardCancelled, FeePercentageUpdated, FeesWithdrawn)","transactionHash":"Filter by transaction hash","blockNumber":"Filter by specific block number","blockNumberFrom":"Filter by block number range (from)","blockNumberTo":"Filter by block number range (to)","timestampFrom":"Filter by timestamp range (from)","timestampTo":"Filter by timestamp range (to)","CardCreated_cardId":"Filter CardCreated events by card ID","CardCreated_slotId":"Filter CardCreated events by slot ID","CardCreated_creator":"Filter CardCreated events by creator address","CardCreated_tokenAddress":"Filter CardCreated events by token address","CardRedeemed_cardId":"Filter CardRedeemed events by card ID","CardRedeemed_to":"Filter CardRedeemed events by redeemer address","CardRedeemed_partner":"Filter CardRedeemed events by partner address","CardCancelled_cardId":"Filter CardCancelled events by card ID","CardCancelled_creator":"Filter CardCancelled events by creator address","FeesWithdrawn_token":"Filter FeesWithdrawn events by token address","FeesWithdrawn_recipient":"Filter FeesWithdrawn events by recipient address"}}}}},"documentation":{"openapi":"/public/openapi.yaml","description":"For full API documentation, refer to the OpenAPI specification"}}