2026年春のサービス開始に先駆け事前相談受付中。気軽にお問い合わせください。
在留カードAPI
概要
在留カードまたは特定在留カードの情報を全て取得します（取得項目は選択可能です） 。また、在留カードまたは特定在留カードに格納されているチェックコードを検証することで真贋判定を行い、有効期間の末日と当日の日付を比較することで、有効性確認も同時に行います。真贋および有効性が確認できた場合のみ、在留カードまたは特定在留カードの情報を取得できます。
在留カードには第1世代と第2世代の2種類があり、一部の取得項目が異なります。各在留カードの取得項目については、「第1世代在留カードの取得項目」および「第2世代在留カードの取得項目」をご覧ください。
取得できる項目
アクセスコントロール
処理の流れ
在留カード・特定在留カードのデータ取得（サービスプロバイダ事業者）
SDKを利用して在留カードまたは特定在留カードのICチップを読み取り、利用者が入力した在留カード番号または特定在留カード番号を利用することで、在留カードまたは特定在留カードのデータを取得します。取得したデータは、署名検証・有効性確認・利用できる形式への変換を行うために、専用のAPIで送信します。
在留カード・特定在留カードの署名検証・有効性確認（プラットフォーム事業者）
APIで送信されたデータより、電子署名を取得し、署名検証による真贋判定を行います。署名検証後は、在留カードの在留期間満了日と当日の日時を比較することで、有効性確認を行います。どちらかの処理が以上終了した場合、在留カード情報の取得は行われず、署名検証および有効性確認の結果のみ返却します。
在留カード・特定在留カードの情報取得（プラットフォーム事業者）
署名検証および有効性確認が正常に完了した場合、在留カードの情報を利用できる形式へ変換し、サービスプロバイダ事業者へ返却します。取得項目を選択している場合は、対象の項目のみ返却されます。
シーケンス図
対面
非対面
実装例
iOS
Android
React Native
Windows