Service
Read-only access to normalized Shinhan Card cards, transactions, statements, points, limits, performance-screen cards, and tax deductions.
No measurements yet. Once the service goes live, its status will appear here.
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | Card approval history | /v1/shinhan-card/card-approvals | Lists card approval (authorization) transactions in a date range of at most six calendar months, consuming every cursor page. Use when the user asks what was charged, approved, or cancelled on their Shinhan Card. Do NOT use for merchant-settled purchases and refunds — use shinhan-card:card-purchases instead. Returns items with transaction_id, approved_at, merchant_name, amount (KRW), card_label, status, and optional funding_type, plus returned_count, total_count, start_date, and end_date. |
| POST | /v1/shinhan-card/card-performance | Lists the cards shown on Shinhan Card's spending-performance (실적) screen. Use only when the user asks which cards appear on that screen. Do NOT use for spending totals — use shinhan-card:card-approvals instead. Do NOT use for the full list of held cards — use shinhan-card:cards instead. No spending-performance or benefit amounts are available from this endpoint; only card identity is returned. Returns cards with product_code, card_name, masked_card_suffix, and network, plus returned_count. | |
| POST | /v1/shinhan-card/card-purchases | Lists merchant-settled purchases (매입) in a date range of at most six calendar months, consuming every cursor page. Use when the user asks for settled charges and refunds, purchase dates, or domestic/international scope. Do NOT use for authorization-time approvals — use shinhan-card:card-approvals instead. Returns items with transaction_id, purchased_on, direction, merchant_id, merchant_name, scope, and amount, plus returned_count and total_count. | |
| POST | /v1/shinhan-card/cards | Lists the cards held on the account with masked number, card name, product code, normalized network, expiration month, and whether transit payment is enabled. Use when the user asks which Shinhan cards they have. Do NOT use for the cards shown on the spending-performance (실적) screen — use shinhan-card:card-performance instead. Returns items and returned_count. | |
| POST | /v1/shinhan-card/credit-limits | Gets the current credit limits on the account. Use when the user asks about their total, cash-advance, installment, or business limit. Do NOT use for point balances or spending totals — use shinhan-card:point-balances or shinhan-card:card-approvals instead. Returns total_limit, cash_advance_limit, installment_limit, and business_limit; other values on the limit screen are not exposed. | |
| POST | /v1/shinhan-card/point-balances | Lists point-program balances on the account. Use when the user asks how many Shinhan Card points they have. Do NOT use for credit limits or transaction history — use shinhan-card:credit-limits or shinhan-card:card-approvals instead. Returns items with program_code, program_name, and balance in points, plus returned_count. | |
| POST | /v1/shinhan-card/statement-detail | Gets one monthly statement using the statement_date and statement_sequence returned by statement-months; both values must come from the same row. Use when the user asks for the per-card breakdown or payment bank of a specific statement. Do NOT use to discover which statements exist — use shinhan-card:statement-months instead. Returns statement_date, payment_bank_name, total_amount, cards, and returned_card_count. | |
| POST | /v1/shinhan-card/statement-months | Lists the available monthly statements with statement_date, statement_sequence, and the statement total. Use when the user asks how much a monthly statement was, or needs the date and sequence for a detail request. Do NOT use for per-card statement amounts or the payment bank — use shinhan-card:statement-detail instead. Returns items and returned_count. | |
| POST | /v1/shinhan-card/tax-deductions | Gets current-year monthly year-end tax-deduction usage, split by payment type (credit, debit, prepaid) and by additional-deduction category (traditional market, public transit, books and performances). Use when the user asks about year-end tax deduction (연말정산 소득공제) amounts. No year parameter is accepted; the current year is always returned. Do NOT use for individual transaction lists — use shinhan-card:card-approvals instead. Returns year, available_years, 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.
