Service
Read-only access to the canonical card portfolio, credit limits, benefit-performance transactions, M Point balances, card approvals, payment statements, payment history, and income-tax deductions.
0.00%30-day uptimeAvg response435ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/hyundai-card/card-approvals | Lists card approvals (individual charges and their cancellations) approved within an inclusive date range, optionally limited to one card. Use when the user asks what they spent, where, or whether a charge was cancelled. Do NOT use for transactions counted toward a benefit's spending requirement — use hyundai-card:performance-transactions instead. Do NOT use for payments made to Hyundai Card — use hyundai-card:payment-history instead. Dates and times are ISO 8601 (KST); amounts are unsigned decimal strings in KRW, and cancellations are indicated by status and cancelled_at rather than a negative sign. Returns items[], returned_count, start_date, and end_date. | |
| POST | /v1/hyundai-card/card-benefits | Lists each card benefit's spending-requirement status for the current and next qualification windows, including the recognized spending and the required threshold. Use when the user asks whether they have met a benefit's spending requirement or how much more they need to spend, and to obtain the benefit id required by hyundai-card:performance-transactions. Do NOT use for the individual transactions behind a benefit — use hyundai-card:performance-transactions instead. Amounts are unsigned decimal strings in KRW, and periods are ISO 8601 dates. Returns base_month, benefits[], and returned_count. | |
| POST | /v1/hyundai-card/card-portfolio | Lists every card on the account from the dedicated card-portfolio page, including check cards, with network (lowercase visa, mastercard, amex, unionpay or jcb), kind (credit or check), masked number, and user alias. Use when the user asks which cards they hold or wants card details such as network or alias. Do NOT use when you only need the card_id for filtering hyundai-card:card-approvals — use hyundai-card:cards instead, which reflects the card selector on the approval-history screen. Returns items[] and returned_count. | |
| POST | /v1/hyundai-card/cards | Lists the cards offered by the card selector of the approval-history screen, with masked card numbers and the card_id accepted by hyundai-card:card-approvals. Use when you need a card_id to limit approvals to one card. Do NOT use for the full card portfolio with network, credit/check kind, and alias — use hyundai-card:card-portfolio instead. Card numbers are returned masked and are never reconstructed. Returns items[] with card_id, masked_card_number, masked_user_card_number, and card_name, plus returned_count. | |
| POST | /v1/hyundai-card/credit-limits | Returns the account's current total credit limit and domestic cash-advance limit, each as limit_krw, used_krw, and remaining_krw. Use when you need to know how much credit is available or already used. Do NOT use for the amount due on the next payment date — use hyundai-card:payment-statement instead. Amounts are unsigned decimal strings of won, and remaining_krw is derived as limit_krw minus used_krw. Returns total, cash_advance, and as_of. | |
| POST | /v1/hyundai-card/payment-history | Lists payments (deposits) the user has made to Hyundai Card within an inclusive date range, with the deposit date, depositing institution, method label, and KRW amount. Use when the user asks what they have already paid to Hyundai Card and when. Do NOT use for upcoming payment amounts or dates — use hyundai-card:payment-statement instead. Do NOT use for card charges at merchants — use hyundai-card:card-approvals instead. method_label stays free text because its full set of values is not known. Returns items[] and returned_count. | |
| POST | /v1/hyundai-card/payment-statement | Returns the upcoming payment (settlement) schedule as one entry per settlement date, each with the settlement account and the KRW amount to be settled. Use when the user asks when the next payment is or how much will be charged. Do NOT use for payments the user has already made — use hyundai-card:payment-history instead. Do NOT use for individual card charges — use hyundai-card:card-approvals instead. Returns settlements[] with statement_month, settlement_account_id, settlement_amount_krw, and realtime_discount_amount_krw. | |
| POST | /v1/hyundai-card/performance-transactions | Lists the transactions counted toward (scope included) or excluded from (scope excluded) the spending requirement of one card benefit, together with the total Hyundai Card recognizes. Use when the user asks which purchases count toward a benefit. Requires a benefit_id from hyundai-card:card-benefits, and the benefit must be available on this account. Do NOT use for general spending history across all cards — use hyundai-card:card-approvals instead. Amounts are unsigned decimal strings in KRW, and cancellations are indicated by is_cancelled. Returns recognized_amount_krw, items[], and returned_count. | |
| POST | /v1/hyundai-card/point-balances | Returns the account's M Point balance as total earned, total used, and remaining points. Use when the user asks how many M Points they have. Do NOT use for the remaining credit limit in KRW — use hyundai-card:credit-limits instead. Point values are unsigned decimal strings; family is included only when family points are enabled and is null otherwise. Returns total_earned, total_used, remaining, and family. | |
| POST | /v1/hyundai-card/tax-deductions | Lists the twelve monthly year-end income-tax deduction summaries for the current year or a requested four-digit year, split by category (general, traditional market, public transport, culture) and by credit versus check card. Use when the user asks about year-end tax settlement (연말정산) deduction amounts. Do NOT use for individual card charges — use hyundai-card:card-approvals instead. Amounts are decimal strings in KRW; amounts can carry a negative sign for net reversals, and deductible_krw equals used_krw minus excluded_krw. Returns year, months[], and returned_count. |
Scopes define which services and APIs a key may call.
Retry rules and backoff behaviour for idempotent calls.
Receive events such as reservation confirmations and delivery updates.
