本文へスキップ
tomnumber

SMS認証API

ご自身のソフトウェアから番号を購入し、コードを取得できます。APIはサイトと同じ残高を使い、料金と20分の返金ルールも同じです。

APIキーはアカウント内で作成します。APIで購入した番号も、サイトと同じ残高から同じ料金で差し引かれます。

アカウント作成APIキー

1番号$0.0018から

主な情報

1番号あたりの最安料金
$0.0018
認証
APIキー
形式
HTTPS経由のJSON
レート制限
1分あたり120リクエスト
返金
サイトと同じ

RESTとJSON

残高、サービス、料金、番号の取得、状態、キャンセルの6つのリクエストで完結します。

キーはアカウントで発行

アカウントのAPIキーページでキーを作成し、Authorizationヘッダーで送信します。

サイトと同じ料金

番号の料金と20分の返金ルールはサイトと同じです。

送信できるリクエストは?

パスはベースURLのあとに付けます。すべてのリクエストにAPIキーが必要です。

送信できるリクエストは?
メソッドとパス内容
GET/balanceUSD建ての残高
GET/services全サービスと、それぞれの最安料金と対応国数
GET/prices?service=telegramあるサービスの、すべての国の番号1つ分の料金
POST/numbersサービスと国を指定して番号を取得。料金は残高から差し引かれます
GET/numbers/{id}番号の状態と、これまでに届いたすべてのコード
POST/numbers/{id}/cancelコードが届く前にキャンセル。料金は残高に戻ります

APIはどの順番で呼び出しますか?

  1. 1

    番号を取得 serviceとcountryを付けてPOST /numbers。idと番号を保存します。

  2. 2

    番号を入力 コードを送るサービスに番号を入力します。

  3. 3

    コードを確認 codesの一覧が空でなくなるまで、5秒ごとにGET /numbers/{id}を呼び出します。

  4. 4

    完了 コードを使います。コードが届く前に番号が不要になったらキャンセルしてください。

APIキーの取得方法は?

ログインして、アカウントの「APIキー」を開きます。キーを作成したらすぐにコピーしてください。表示は1回だけです。新しいキーを作ると古いキーは無効になります。

APIキー

ベースURLは?

すべてのリクエストをこのアドレスに送り、キーはAuthorizationヘッダー(Bearer)またはX-Api-Keyヘッダーに入れてください:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

リクエストのフィールド

リクエストのフィールド
フィールド使う場所値
servicePOST /numbers, GET /prices/services のサービス名 (例: telegram)
countryPOST /numbers2文字の国コード (例: gb)

レスポンスのフィールドと状態

レスポンスのフィールドと状態
値意味
waiting番号は有効で、まだコードは届いていません
receivedコードが1件以上届きました。expires_atまでは追加のコードも届きます
refunded20分以内にコードが届かず、料金は残高に戻りました
canceledコードが届く前にキャンセルされ、料金は残高に戻りました

レスポンス例

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

エラーコード

エラーコード
unauthorizedAPIキーがない、または正しくありません
rate_limited1分間に120リクエストを超えました
bad_service不明なサービス名です
bad_countryそのサービスでは利用できない国です
low_balance残高が料金より少ないです
unavailable現在使える番号がありません。料金は引き落とされていません
not_foundそのidの番号はアカウントにありません
cannot_cancelすでにコードが届いたか、番号が終了しています

コード例

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

SMS認証APIについてのよくある質問

SMS認証APIとは何ですか?

サイトの代わりに、ご自身のプログラムから番号を購入してコードを取得する方法です。

APIの利用に追加料金はかかりますか?

いいえ。番号の料金はサイトと同じで、同じ残高から支払われます。

リクエストはどのくらい送れますか?

1キーにつき1分あたり120リクエストまでです。5秒ごとの確認なら十分に収まります。

APIで取得した番号も返金されますか?

はい。ルールは同じで、20分以内にコードが届かなければ料金は残高に戻ります。

キーはどこで作成しますか?

アカウントの「APIキー」で作成します。

ほかのサービス向けの仮想番号