Service
Read-only access to Shinhan Bank internet banking through the customer's signed-in session: the full account list with balances, demand-deposit account details and transactions, easy-transfer result totals, and daily foreign-exchange rate boards.
58.54%30-day uptimeAvg response928ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/shinhan-bank/account-details | Returns the current balance, withdrawable amount, status, last transaction date, and service or restriction flags for one demand-deposit account. Use when the caller already has a twelve-character account_number from shinhan-bank:accounts and needs that account's current detail. Do NOT use to discover accounts — use shinhan-bank:accounts instead. Do NOT use for transaction history — use shinhan-bank:transactions instead. Only demand-deposit accounts (product subject code 110) are supported: an account_number this provider can rule out before calling the bank fails with INVALID_REQUEST, and one the bank itself refuses fails with UPSTREAM_REJECTED. Returns account_number, product_name, account_management_branch_code, balance_krw, withdrawable_amount_krw, opened_date, last_transaction_date, checked_at, status, unrecognized_status_code, and flags. | |
| POST | /v1/shinhan-bank/accounts | Lists every account in the signed-in customer's Shinhan Bank portfolio with balance, withdrawable amount, product codes, deposit type, status, and service flags. Use when the caller needs to discover account numbers or see all balances at once; no input is required. Do NOT use for one account's current detail — use shinhan-bank:account-details instead. Do NOT use for transaction history — use shinhan-bank:transactions instead. Returns items, returned_count, and total_balance_across_returned_accounts_krw. | |
| POST | /v1/shinhan-bank/easy-transfer-results | Returns the customer's easy-transfer (간편이체) result totals for an inclusive date window of at most one calendar year. Use when the caller needs the transfer, error, and fee amount totals for easy transfers in a period; start_date and end_date are required. Do NOT use for per-account transaction rows — use shinhan-bank:transactions instead. Individual result rows are not returned: items is always empty because the bank's row format has not been confirmed, and a request that does return rows fails with UPSTREAM_SCHEMA_ERROR. Returns start_date, end_date, checked_at, items, returned_count, transfer_amount_total_krw, error_amount_total_krw, and fee_amount_total_krw. |
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.
| POST | /v1/shinhan-bank/fx-rate-board | Returns Shinhan Bank's latest published foreign-exchange rate board for one past or current weekday business date: telegraphic-transfer, cash, and traveller's-cheque buy and sell rates and the base rate in KRW per currency quote unit, plus the USD cross rate for each currency. Use when the caller needs the bank's posted exchange rates for a given date. Do NOT use for account balances or transactions — use shinhan-bank:accounts or shinhan-bank:transactions instead. publication_date must be a weekday and not in the future in Korea Standard Time; dates the bank rejects, such as bank holidays, fail with UPSTREAM_REJECTED and are not worth retrying. Returns published_at, publication_round, items, and returned_count. |
| POST | /v1/shinhan-bank/transactions | Lists the transactions of one demand-deposit account within an explicit inclusive date window, newest first by default. Use when the caller has an account_number from shinhan-bank:accounts and needs its transaction history for a specific period; start_date and end_date are required and sort_by may be oldest_first or newest_first. Do NOT use for the account's current balance or flags — use shinhan-bank:account-details instead. Do NOT use for easy-transfer result totals — use shinhan-bank:easy-transfer-results instead. The response has no cursor or row limit; has_more is false when the bank reports the end of history and null for an unrecognized history-state code. Returns account_number, items, returned_count, has_more, and unrecognized_history_state_code. |
