SIM Swap

SIM Swap（SIMスワップ）とは、ユーザーの電話番号を新しいSIMカードに紐付けるプロセスを指します。通常、カードの紛失による再発行、SIMカードのアップグレード、MNP（携帯電話番号ポータビリティ）、マルチSIMサービスの開始、または新しいユーザーが以前他人が使用していた番号を引き継いだ場合などに発生します。

攻撃者はSIM Swapを利用して他人の電話番号をハイジャックし、SMS認証コードを傍受してパスワードをリセットし、アカウントを乗っ取ることがあります。SIM Swap APIは、指定された電話番号でSIMスワップが発生したかどうかをリアルタイムで検出し、SMS OTP検証などの重要なプロセスにおける潜在的なSIMハイジャックのリスクを特定し、アカウント乗っ取りの確率を低減するのに役立ちます。

注意： 現在、以下の国/地域の番号でのみSIM Swapの照会をサポートしています：ブラジル、インドネシア。

本APIは2つの独立したインターフェースを提供します：

• Retrieve Date：指定された電話番号で直近にSIM Swapが発生した時間を照会します。
• Check：指定された電話番号で過去N時間以内にSIM Swapが発生したかどうかを検出します。

呼び出し認証

これらの2つのインターフェースはどちらもHTTP Basic Auth認証方式を採用しており、HTTP HeaderにAuthorizationを追加します：

              
              Authorization: Basic ${base64_auth_string}

            

${base64_auth_string}の生成アルゴリズムはbase64(dev_key:dev_secret)です。

API認証の実行方法について詳しくは、呼び出し認証をご参照ください。

Retrieve Date

指定された電話番号で直近にSIM Swapが発生した時間を照会します。

呼び出しアドレス

POST https://otp.api.engagelab.cc/v1/sim-swap/retrieve-date

リクエスト例

リクエストオブジェクトはJSON形式で表現されるため、リクエストヘッダーにContent-Type: application/jsonを含める必要があります。

リクエストヘッダー

              
              POST /v1/sim-swap/retrieve-date HTTP/1.1
Content-Type: application/json
Authorization: Basic ${base64_auth_string}

            

リクエストボディ

              
              {
  "phone_number": "+381692223535"
}

            

リクエストパラメータ

レスポンスパラメータ

成功レスポンス

成功レスポンス例：

              
              {
  "request_id": "2055136570436075520",
  "latest_sim_change": "2026-05-01T15:00:00Z"
}

            

失敗レスポンス

HTTPステータスコードは4xxまたは5xxで、レスポンスボディには以下のフィールドが含まれます：

一般的な失敗レスポンス例：

パラメータエラーの例：

              
              {
  "code": 3002,
  "message": "invalid phone_number"
}

            

残高不足の例：

              
              {
  "code": 3005,
  "message": "balance not enough"
}

            

番号がサービス提供エリア外の例：

              
              {
  "code": 5101,
  "message": "phone number is not in sim swap service coverage"
}

            

一般的な失敗の例：

              
              {
  "code": 5100,
  "message": "failed to retrieve sim swap date"
}

            

Check

指定された電話番号で過去N時間以内にSIM Swapが発生したかどうかを検出します。

呼び出しアドレス

POST https://otp.api.engagelab.cc/v1/sim-swap/check

リクエスト例

リクエストオブジェクトはJSON形式で表現され、リクエストヘッダーにも同様にContent-Type: application/jsonを含める必要があります。

リクエストヘッダー

              
              POST /v1/sim-swap/check HTTP/1.1
Content-Type: application/json
Authorization: Basic ${base64_auth_string}

            

リクエストボディ

              
              {
  "phone_number": "+381692223535",
  "max_age": 400
}

            

リクエストパラメータ

レスポンスパラメータ

成功レスポンス

成功レスポンス例：

              
              {
  "request_id": "2055136570293469184",
  "swapped": true
}

            

失敗レスポンス

構造はRetrieve Dateインターフェースと同じです。特有の失敗レスポンス例：

パラメータエラー（max_ageが範囲外）：

              
              {
  "code": 3002,
  "message": "max_age must be between 1 and 2400"
}

            

エラーコード