API

期間を問わず、全回線で無料です。エンタープライズ向けプランも、シート単位の料金も、営業電話もありません。

ベースURL

https://api.hushsms.com

認証

回線トークンをベアラー資格情報として渡してください。トークンは単一回線に限定され、パネルからローテーションできます。

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

リファレンス

エンドポイント

GET/v1/lines

トークンに紐づく回線を一覧表示します。番号、国、期間、有効期限を返します。

POST/v1/lines

回線をプロビジョニングします。ボディにはcountry、line_type、term、poolを指定します。暗号通貨のインボイスを返します。

GET/v1/lines/{id}/messages

回線への受信メッセージを新しい順に表示します。ボディは保持期間の経過後に削除されます。

POST/v1/lines/{id}/messages

送信SMSを送信します。全ての期間プランに含まれます。

GET/v1/catalog

各国の在庫、サービス別の互換性、現在の価格をリアルタイムで提供します。認証は不要です。

DELETE/v1/lines/{id}

回線を早期に解放します。月次プランでは返金なし、6ヶ月以上では日割りで返金します。

プッシュ

ウェブフック

受信メッセージはすべて、到着から1秒以内にHMAC-SHA256で署名されてエンドポイントへPOSTされます。

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

マシン

AIエージェント向け

機械可読なカタログはhttps://hushsms.com/v1/catalog/にあります。認証なしで、各国の在庫、サービス別の互換性、現在の価格をJSONで返します。

Open the catalog

このエンドポイントは、各国の在庫状況、非対応サービスを含むサービス別の互換性、全ての乗数を含む現在の価格、データ保持期間テーブルを返します。キーも、言及するほどのレート制限もなく、CORSは開放されています。電話番号を必要とするエージェントを構築しているなら、このエンドポイントを読むべきです。

サイト全体の平文サマリーは/llms.txtに、完全なコーパスは/llms-full.txtにあります。

呼び出し可能なコントラクトとしてのカタログ

平文コーパスはカタログを読めるようにしますが、呼び出し可能にはしません。全ての単語を読んだエージェントでも、リクエストの形式、国スラッグの列挙、サーバーが無視するフィールドを知らないため、購入できない番号を説明することになります。このギャップが、コンテンツのみの戦略が限界に達する点です。

/openapi.jsonがそのギャップを埋めます。認証不要の3つの公開エンドポイント（カタログの読み取り、注文の作成、ポーリング）をカバーするOpenAPI 3.1ドキュメントで、国、期間、プールの列挙は、ハンドラーが検証するのと同じカタログから生成されます。また、ドキュメントの冒頭でrel="service-desc"として宣言されているため、サービス記述を探すクライアントは場所を指示されなくても見つけられます。

OpenAPI記述を開く

出典

このページの番号計画データ（ダイヤルコード、国内番号長、市内プレフィックス、携帯番号帯）は、ITU-T E.164シリーズから取得しています。在庫、価格、測定された成功率は当社独自のものであり、その旨が明記されています。

ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication Union国番号、国内有効番号の長さ、番号構成
ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication Union国別の番号計画、モバイルレンジ、市外局番

番号計画の検証日 2026年8月1日

番号を取得お問い合わせ