電話番号・市外局番API

電話番号を渡すと、正しいハイフンの位置(04-7123-4567 など)と番号の種類(固定電話・携帯電話・フリーダイヤルなど)を返すAPIです。固定電話なら、市外局番・市内局番と、その番号の地域(都道府県・市町村)も返します。

できること
電話番号 → ハイフン付きの形・種類 / 固定電話 → 市外局番・市内局番・地域・都道府県・番号を割り当てられた電話会社 / 市外局番の一覧 / 固定電話の先頭6桁の表(全件)
費用・登録
無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
向いている用途
入力された電話番号をハイフン付きの見やすい形にそろえる / 名簿の電話番号の地域を調べる / 打ち間違い(桁数の誤り・割り当ての無い番号)を見つける
気をつけること
その番号を実際にだれかが使っているか、番号の持ち主や住所は分かりません。止まらないことは保証していません。

データ: 総務省「電気通信番号指定状況」(固定電話番号)・「市外局番の一覧」(版は /tel/v1/meta.json で確認できます)

はじめかた

  1. ブラウザで開いてみる: https://api.shirugear.com/tel/v1/0123456789.json を開くと、0123-45-6789(北海道恵庭市・千歳市の固定電話の番号の形)が返ります。URLの数字を調べたい電話番号に変えるだけです。ハイフンを付けた 0123-45-6789 でも同じです。
  2. 携帯電話の番号を開いてみる: /tel/v1/09012345678.json を開くと、type が "mobile"(携帯電話)、formatted が "090-1234-5678" になります。
  3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

入力された電話番号をハイフン付きの形にそろえる例です。形の違う番号(桁数の誤りなど)は HTTP 400、割り当ての範囲に無い固定電話の番号は HTTP 404 になります。

const res = await fetch("https://api.shirugear.com/tel/v1/0471234567.json");
if (res.ok) {
  const d = await res.json();
  console.log(d.formatted, d.type_name); // 04-7123-4567 固定電話
  if (d.area) console.log(d.area.prefectures.join("・")); // 千葉県
} else {
  const e = await res.json();
  console.log(e.error.code); // invalid_number・number_not_found など
}
curl -s https://api.shirugear.com/tel/v1/0471234567.json

# ハイフン付きの形だけ取り出す(jq を使う場合)
curl -s https://api.shirugear.com/tel/v1/0471234567.json | jq -r '.formatted'
<?php
$json = @file_get_contents('https://api.shirugear.com/tel/v1/0471234567.json');
if ($json === false) {
    // 400(形の誤り)・404(割り当ての範囲に無い)や通信の失敗のときは false になります
    echo "番号を確かめられませんでした\n";
} else {
    $d = json_decode($json, true);
    echo $d['formatted'], ' ', $d['type_name'], "\n"; // 04-7123-4567 固定電話
}
import json
import urllib.error
import urllib.request

def format_tel(number):
    """電話番号をハイフン付きの形にする(形の誤り・割り当ての無い番号なら None)"""
    url = f"https://api.shirugear.com/tel/v1/{number}.json"
    try:
        with urllib.request.urlopen(url, timeout=10) as res:
            d = json.load(res)
    except urllib.error.HTTPError as e:
        if e.code in (400, 404):
            return None
        raise
    return d["formatted"]

print(format_tel("0471234567"))  # 04-7123-4567

たくさんの番号をまとめて整える・調べるときは、1件ずつ呼ばずに 先頭6桁の表(prefixes.json)を1回取って手元で引くか、使う結果を覚えておいて使い回してください。

その場で試す

電話番号を調べる

試しに:

市外局番から地域

市外局番の一覧(/tel/v1/areas.json)を1回だけ読み込み、ブラウザの中で探します。

URLの一覧

どれも、URLを開く(GET)だけで JSON(UTF-8)が返ります。先頭は https://api.shirugear.com です。自分のサイトのJavaScriptから直接呼べます(CORS対応)。

URL返すもの
/tel/v1/{電話番号}.json電話番号1つの、ハイフン付きの形・種類(固定電話なら市外局番・地域なども)。例: /tel/v1/0123456789.json・/tel/v1/04-7123-4567.json
/tel/v1/areas.json市外局番の一覧(387件・約140KB。圧縮して送るので転送は約27KB)。例: /tel/v1/areas.json
/tel/v1/prefixes.json固定電話の先頭6桁の表(41,987件・約1MB。圧縮して送るので転送は約110KB)
/tel/v1/meta.jsonデータの版(総務省の公表の何年何月何日現在か)・出典・件数

電話番号1つ

応答の例(固定電話)

GET https://api.shirugear.com/tel/v1/0123456789.json

{
  "number": "0123456789",
  "formatted": "0123-45-6789",
  "type": "fixed",
  "type_name": "固定電話",
  "area_code": "0123",
  "local_code": "45",
  "subscriber": "6789",
  "area": {
    "section_code": "2",
    "name": "北海道恵庭市、千歳市",
    "prefectures": ["北海道"]
  },
  "carrier": "東日本電信電話株式会社",
  "in_use": true,
  "data_version": "2026-09-01"
}

応答の例(固定電話以外)

携帯電話・IP電話・フリーダイヤルなどは、番号の頭で種類を見分けてハイフンを入れます。地域や電話会社の項目は null です。

GET https://api.shirugear.com/tel/v1/09012345678.json

{
  "number": "09012345678",
  "formatted": "090-1234-5678",
  "type": "mobile",
  "type_name": "携帯電話",
  "area_code": null,
  "local_code": null,
  "subscriber": null,
  "area": null,
  "carrier": null,
  "in_use": null,
  "data_version": "2026-09-01"
}

各項目

項目の一覧を開く(11項目)
項目型内容
number文字列ハイフンを取り除いた電話番号
formatted文字列ハイフン付きの電話番号(例: "0123-45-6789")
type文字列番号の種類(下の表)
type_name文字列種類の日本語(「固定電話」など)
area_code文字列/null市外局番(頭の 0 を含む。例: "0123")。固定電話以外は null
local_code文字列/null市内局番。固定電話以外は null
subscriber文字列/null加入者番号(最後の4桁)。固定電話以外は null
areaオブジェクト/null地域(番号区画)。section_code(番号区画コード)・name(地域の名前)・prefectures(都道府県の配列)。固定電話以外は null
carrier文字列/null総務省がその番号の範囲(先頭6桁)を割り当てた電話会社(総務省の書き方そのまま。例: 「東日本電信電話株式会社」「KDDI株式会社」)。まだ割り当てられていない範囲と、固定電話以外は null
in_use真偽値/null総務省の指定状況でその範囲が「使用中」なら true、「未使用」なら false。固定電話以外は null(下の注意)
data_version文字列データの版("2026-09-01" は2026年9月1日現在)

in_use と carrier についての注意

in_use が true でも、その番号を実際にだれかが使っているかは分かりません。総務省は電話番号を先頭6桁(1万番号)ずつまとめて電話会社に割り当てていて、in_use はその範囲が割り当て済み(使用中)かどうかだけを表します。このAPIは、番号の持ち主・住所・つながるかどうかは返しません。

carrier も、その範囲を割り当てられた電話会社です。番号ポータビリティ(電話会社を変えても番号をそのまま使える仕組み)で、今その番号を使っている会社とは違うことがあります。

番号の種類(type)

固定電話以外の番号は、頭の数字で種類を見分けます。種類ごとに決まった桁数でないと HTTP 400 になります。

typetype_name番号の頭桁数ハイフンの位置(例)
fixed固定電話下のどれでもない番号10市外局番・市内局番・4桁(03-1234-5678・0123-45-6789 など)
mobile携帯電話070・080・090113-4-4(090-1234-5678)
ipIP電話050113-4-4(050-1234-5678)
freedialフリーダイヤル(着信課金)0120104-3-3(0120-123-456)
freedialフリーダイヤル(着信課金)0800114-3-4(0800-123-4567)
navidialナビダイヤル(統一番号)0570104-3-3(0570-123-456)
teledomeテレドーム0180104-3-3(0180-123-456)
premium情報料代理徴収(0990)0990104-3-3(0990-123-456)
m2mM2M等専用番号(IoT 機器など)020113-4-4(020-1234-5678)
fmcFMC(固定と携帯の統一番号)060113-4-4(060-1234-5678)

ハイフンの位置の決め方

固定電話の番号は、市外局番の長さが2〜5桁(頭の 0 を含む)とばらばらなので、ハイフンの位置は番号を見ただけでは決まりません。このAPIは、番号の先頭6桁(0+市外局番+市内局番)を総務省「電気通信番号指定状況」の表で引いて、市外局番と市内局番の切れ目を決めています。

よくある「市外局番の一覧の中から、いちばん長く合うものを選ぶ」やり方では、正しく決まらない番号があります。

番号いちばん長く合う市外局番で切ると正しい形(このAPI)
0471234567047-123-4567(市外局番 047 は千葉県市川市・船橋市など)04-7123-4567(市外局番 04。千葉県柏市・我孫子市など)
01548234560154-82-3456(市外局番 0154 は北海道釧路市など)015-482-3456(市外局番 015。北海道川上郡)

このような先頭6桁は、2026年9月1日現在の表で約1,200(うち使用中は約750)あります。番号を正しく区切りたいときは、市外局番の一覧ではなく、このAPIか 先頭6桁の表 を使ってください。

市外局番の一覧

/tel/v1/areas.json は、市外局番ごとに、その番号を使う地域(番号区画)をまとめたものです。市外局番の順に並んでいます。

GET https://api.shirugear.com/tel/v1/areas.json

{
  "data_version": "2026-09-01",
  "count": 387,
  "areas": [
    {
      "area_code": "011",
      "local_code_digits": 3,
      "prefectures": ["北海道"],
      "sections": [
        { "code": "1", "name": "北海道江別市、札幌市、北広島市、空知郡南幌町", "prefectures": ["北海道"] }
      ]
    },
    …
    {
      "area_code": "015",
      "local_code_digits": 3,
      "prefectures": ["北海道"],
      "sections": [
        { "code": "52", "name": "北海道川上郡", "prefectures": ["北海道"] },
        { "code": "54", "name": "北海道十勝郡、中川郡(池田町及び豊頃町に限る。)", "prefectures": ["北海道"] }
      ]
    },
    …
  ]
}

先頭6桁の表(全件)

/tel/v1/prefixes.json は、固定電話の先頭6桁(0+市外局番+市内局番)すべての表です。たくさんの番号をまとめて区切る・調べるときに、1回取って手元で引いてください(約1MB。圧縮して送るので転送は約110KB)。

GET https://api.shirugear.com/tel/v1/prefixes.json

{
  "data_version": "2026-09-01",
  "count": 41987,
  "fields": ["area_code", "section", "in_use"],
  "prefixes": {
    "011200": ["011", "1", 1],
    …
    "033101": ["03", "219", 1],
    …
    "015482": ["015", "52", 1],
    …
  }
}
// JavaScript: 表を1回取って、固定電話の番号を区切る
const t = await (await fetch("https://api.shirugear.com/tel/v1/prefixes.json")).json();
function formatFixed(n) {
  const p = t.prefixes[n.slice(0, 6)];
  if (!p || n.length !== 10) return null;
  const a = p[0];
  return a + "-" + n.slice(a.length, 6) + "-" + n.slice(6);
}
console.log(formatFixed("0471234567")); // 04-7123-4567

エラー

うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください(message は説明文で、言い回しが変わることがあります)。

{"error":{"status":404,"code":"number_not_found","message":"この番号は、総務省が事業者に割り当てた固定電話の番号の範囲にありません(…)。…"}}
状態codeいつ
400invalid_number番号の形が違う(0 から始まる半角数字でない、00 から始まる、ハイフン以外の文字がある)/桁数が種類と合わない(固定電話・0120 などで10桁でない、携帯電話・050・0800 などで11桁でない)
403region_not_allowed日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます)
404number_not_found固定電話の番号で、先頭6桁(市外局番+市内局番)が総務省の指定状況の表に無い
404not_foundURLが違う
405method_not_allowedGET / HEAD 以外で呼んだ

表に載っているが「未使用」の範囲の番号(例: 0331234567)は、エラーではなく HTTP 200 で in_use: false・carrier: null を返します。

データの出典・更新・キャッシュ

変更の方針と更新履歴

更新履歴

2026年11月10日
公開(総務省の公表は2026年9月1日現在まで)。

機械で読める仕様(型定義・OpenAPI)

用語の説明

市外局番
固定電話の番号の頭にある、地域を表す番号です(頭の 0 を含めて2〜5桁。東京は 03、札幌は 011 など)。同じ地域の中でかけるときは省けます。
市内局番
市外局番の次に続く番号です。市外局番と合わせて、頭の 0 を除くといつも5桁になります。
加入者番号
固定電話の番号の最後の4桁です。
番号区画
固定電話の番号を割り当てるために、総務省が全国を分けた地域です。1つの番号区画は1つの市外局番を使います。1つの市外局番を2つ以上の番号区画が使うことや、番号区画が都道府県をまたぐこともあります。
電気通信番号指定状況
総務省が、どの番号の範囲(固定電話なら先頭6桁ずつ)をどの電話会社に割り当てたか(指定したか)を公表している表です。
番号ポータビリティ
電話会社を変えても、同じ電話番号を使い続けられる仕組みです。このため、番号の範囲を割り当てられた会社と、今その番号を使っている会社が違うことがあります。
フリーダイヤル・ナビダイヤル
フリーダイヤル(着信課金)は、電話をかけた人ではなく受けた側が通話料を払う番号です(0120・0800)。ナビダイヤル(統一番号)は、全国どこからでも同じ番号でかけられる番号です(0570)。
IP電話・M2M・FMC
IP電話はインターネットの技術を使う電話(050)、M2M等専用番号は IoT 機器などの機械どうしの通信用の番号(020)、FMC は固定電話と携帯電話を1つの番号で使えるサービスの番号(060)です。

よくある質問

本当に無料ですか?登録は必要ですか?

現在は無料で、登録やAPIキーも要りません。個人・法人、営利・非営利を問わず使えます。ただし利用状況に応じて提供条件を変えることがあり、そのときはできるかぎりこのページでお知らせします。

ハイフンは付けて指定しますか?

付けても付けなくてもかまいません。ハイフンは取り除いてから判定するので、0471234567 でも 04-7123-4567 でも、まちがった位置のハイフン(047-123-4567)でも同じ結果になります。

その番号を今だれかが使っているかは分かりますか?

分かりません。in_use は、総務省がその番号の範囲(先頭6桁)を電話会社に割り当てているかどうかです。範囲が使用中でも、その番号を実際にだれかが使っているとは限りません。番号の持ち主や住所も返しません(in_use と carrier についての注意)。

携帯電話の会社は分かりますか?

分かりません。携帯電話などの番号では carrier は null です。固定電話の carrier も、総務省がその番号の範囲を割り当てた会社で、番号ポータビリティで今の会社と違うことがあります。

市外局番の一覧があれば、ハイフンの位置は決まりませんか?

決まらない番号があります。たとえば 0471234567 は、いちばん長く合う市外局番(047)で切ると 047-123-4567 ですが、正しくは 04-7123-4567 です。このAPIは先頭6桁の表で決めています(ハイフンの位置の決め方)。

データはどれくらい新しいですか?

総務省の公表の版(何年何月何日現在か)を meta.json の data_version で返します。総務省の公表が変わったときに作り直します。最新で正確な情報は総務省のページでご確認ください。

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。