Primagest Trust Services
プロダクトドキュメント
よくあるご質問運営会社リリースノート
プロダクトドキュメント
よくあるご質問運営会社リリースノート
APIリファレンス
  1. マイナポータルAPI
  • ようこそ
  • 本人確認
    • 公的個人認証
      • 署名API
      • 利用者証明API
    • カード代替電磁的記録
      • スマートフォンのマイナンバーカードAPI
    • ICチップ読み取り
      • マイナンバーカード券面API
      • マイナンバーカード券面事項入力補助API
      • マイナンバーカード一括取得API
      • 運転免許証API
      • 在留カードAPI
      • 特別永住者証明書API
      • ICチップ画像OCR(オプション)
    • ICチップ読み取り+容貌撮影
  • 基本4情報提供
    • 同意
      • 同意取得API
      • 同意取消しAPI
      • 同意状況照会API
    • 証跡
      • 証跡照会API
    • 失効情報
      • 失効情報確認API
      • 失効情報通知API
    • 基本4情報提供
      • 基本4情報提供API
      • 基本4情報自動最新化API
  • 連携サービス
    • マイナアプリ(デジタル認証サービス)
      • マイナアプリ 署名API
      • マイナアプリ 認証API
      • マイナアプリ 同意取得API
      • マイナアプリ 同意取消しAPI
    • マイナポータルAPI
      • 自己情報取得API
      • 医療保険情報取得API
  • 本人確認サービス
    • 管理コンソール
    • 対面本人確認アプリ
    • 非対面本人確認アプリ
    • 確認記録取得API
  1. マイナポータルAPI

医療保険情報取得API


概要#

医療保険情報取得APIは、デジタル庁が提供するマイナポータルAPI(医療保険情報取得API)を利用して、利用者本人の同意のもとで医療保険情報を取得するためのAPIです。医療保険情報は、医療情報基盤・診療報酬審査支払機構と国民健康保険中央会が保管する、利用者本人の診療情報や薬剤情報、健診情報、医療費通知情報です。マイナポータルは、オンライン資格確認等システムを経由してこれらの情報を取得します。
利用者は、マイナポータルの画面で利用目的と提供する情報を確認し、マイナンバーカードで本人確認を行ったうえで、情報の提供を許可します。マイナポータルで代理人の登録を行っている場合は、代理人が委任者の医療保険情報を取得することもできます。
これにより、保険への加入やお薬手帳への登録などで、健診結果の提出や薬の情報の手入力を利用者に求めずに、必要な情報を確認できます。
サービスプロバイダ事業者は、マイナポータルAPIのAPI利用者としてデジタル庁に利用を申請します。プラットフォーム事業者は、その委託を受けてマイナポータルとの接続を行います。
取得できる情報の種類は、事前にデジタル庁へ提出した申請の内容によって決まります。
医療保険情報取得APIを利用するには、利用者がマイナポータルの利用者登録を完了している必要があります。そのため、デジタル庁の利用者登録等APIとの併用が必須です。
PHRサービス提供者の要件について
医療費通知情報以外の医療保険情報を取り扱うには、経済産業省・総務省・厚生労働省が定めるPHRサービス提供者による健診等情報の取扱いに関する基本的指針を遵守する必要があります。

活用シーン#

保険会社への提出(健診結果の確認)
電子版お薬手帳(処方や調剤の記録)
PHR・健康管理アプリ(健診や医療費の記録)
自治体の住民向けサービス(健診や薬の情報の表示)
導入の効果について
いずれの場合も、利用者が用意した書類や手入力の内容ではなく、オンライン資格確認等システムに登録された情報を直接受け取るため、記入内容を確認する手間を減らせます。
ほかの事業者の活用事例について
ほかの事業者の活用事例は、デジタル庁のマイナポータルAPI 活用事例一覧で確認できます。

取得できる項目#

診療情報・薬剤情報の取得項目
健診情報の取得項目
医療費通知情報の取得項目
取得できる項目の詳細について
詳細情報は、デジタル庁の取得情報一覧で確認できます。

アクセスコントロール#

実物のマイナンバーカード
スマートフォンのマイナンバーカード

処理の流れ#

システムの停止時間について
マイナポータルとオンライン資格確認等システムは、24時間365日稼働しています。ただし、医療保険情報取得のための利用設定が済んでいない利用者の場合は、情報提供ネットワークシステム(原則として第3土日に計画停止)と医療保険者向け中間サーバ(毎日午前3時から6時まで停止)も稼働している必要があります。
1
医療保険情報取得の要求(サービスプロバイダ事業者)
リダイレクト先URLと、取得する情報の照会年月日の範囲(絞り込み開始日と絞り込み終了日)などをAPIに送信します。本人同意・本人確認用のURLと、結果の取得に使用するIDが返却されます。
2
本人同意・本人確認(利用者)
返却されたURLにアクセスすると、利用者の端末にマイナポータルの画面が表示されます。利用者は、利用目的と提供する情報を確認し、マイナアプリでマイナンバーカードを読み取って本人確認を行います。続けて、情報の提供を許可します。PCまたはタブレットの場合は、画面に表示されたQRコードをスマートフォンのマイナアプリで読み取ります。PCの場合は、カードリーダーで読み取ることもできます。マイナポータルの利用者登録が済んでいない場合は、あわせて行います。医療保険情報取得のための利用設定が済んでいない場合は、マイナポータルが利用設定を行います。
3
医療保険情報の受信(プラットフォーム事業者)
利用者が情報の提供を許可すると、マイナポータルに医療保険情報の取得を要求します。マイナポータルは、オンライン資格確認等システムから医療保険情報を取得して返却します。返却された医療保険情報は保存します。
4
リダイレクト先URLへの遷移(プラットフォーム事業者)
医療保険情報を保存した後、利用者の画面をリダイレクト先URLへ遷移させます。遷移の際は、手順1で返却したIDを付けます。利用者が情報の提供を拒否した場合や、エラーが発生した場合も、リダイレクト先URLへ遷移します。
5
医療保険情報の取得(サービスプロバイダ事業者)
手順1で返却されたIDをAPIに送信すると、医療保険情報が返却されます。取得に失敗した場合は、エラーが返却されます。取得した結果をもとに、利用者に画面を表示します。

シーケンス図#

期間連携API#

期間連携APIは、利用者の同意に基づき、一定期間継続して医療保険情報を取得できるようにするマイナポータルAPIです。医療保険情報取得APIとあわせて利用します。
期間連携APIを併用すると、同意から最大90日間は、利用者がマイナンバーカードで本人確認を行わなくても医療保険情報を取得できます。90日を経過した後は、マイナンバーカードによる本人確認と同意をやり直す必要があります。
期間連携APIの併用について
期間連携APIを併用する場合は、次の対応が必要です。
デジタル庁への利用申請で、期間連携APIを利用することを明記する
照会年月日の範囲を、原則として必要最小限の期間(最大2か月以内)にする
利用者が任意のタイミングで同意を取り消せる画面を用意する

前へ
自己情報取得API
次へ
本人確認サービス
Built with