電話番号・市外局番API
電話番号を渡すと、正しいハイフンの位置(04-7123-4567 など)と番号の種類(固定電話・携帯電話・フリーダイヤルなど)を返すAPIです。固定電話なら、市外局番・市内局番と、その番号の地域(都道府県・市町村)も返します。
- できること
- 電話番号 → ハイフン付きの形・種類 / 固定電話 → 市外局番・市内局番・地域・都道府県・番号を割り当てられた電話会社 / 市外局番の一覧 / 固定電話の先頭6桁の表(全件)
- 費用・登録
- 無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
- 向いている用途
- 入力された電話番号をハイフン付きの見やすい形にそろえる / 名簿の電話番号の地域を調べる / 打ち間違い(桁数の誤り・割り当ての無い番号)を見つける
- 気をつけること
- その番号を実際にだれかが使っているか、番号の持ち主や住所は分かりません。止まらないことは保証していません。
データ: 総務省「電気通信番号指定状況」(固定電話番号)・「市外局番の一覧」(版は /tel/v1/meta.json で確認できます)
はじめかた
- ブラウザで開いてみる: https://api.shirugear.com/tel/v1/0123456789.json を開くと、
0123-45-6789(北海道恵庭市・千歳市の固定電話の番号の形)が返ります。URLの数字を調べたい電話番号に変えるだけです。ハイフンを付けた0123-45-6789でも同じです。 - 携帯電話の番号を開いてみる: /tel/v1/09012345678.json を開くと、
typeが"mobile"(携帯電話)、formattedが"090-1234-5678"になります。 - 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。
いろいろな言語から呼ぶ
入力された電話番号をハイフン付きの形にそろえる例です。形の違う番号(桁数の誤りなど)は 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 | データの版(総務省の公表の何年何月何日現在か)・出典・件数 |
- 電話番号は
0から始まる半角数字で指定します。ハイフン(-)は付けても付けなくてもかまいません。空白・かっこ・全角の数字は使えません(HTTP 400)。 +81から始まる国際的な書き方は使えません。+81を0に直して指定してください(例:+81-3-…→03…)。- 呼び出しは
GET(またはHEAD)だけです。
電話番号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日現在) |
- 固定電話は、市外局番と市内局番を合わせるといつも5桁(頭の 0 を除く)で、加入者番号は4桁です。
area.nameは総務省「市外局番の一覧」の書き方そのままです。「北海道釧路市(音別町を除く。)、阿寒郡、釧路郡」のように、町や丁目の単位で区切られていることがあります。都道府県で分けたいときはarea.prefecturesを使ってください(大阪府と兵庫県にまたがる06のように、2つ以上入ることがあります)。
in_use と carrier についての注意
in_use が true でも、その番号を実際にだれかが使っているかは分かりません。総務省は電話番号を先頭6桁(1万番号)ずつまとめて電話会社に割り当てていて、in_use はその範囲が割り当て済み(使用中)かどうかだけを表します。このAPIは、番号の持ち主・住所・つながるかどうかは返しません。
carrier も、その範囲を割り当てられた電話会社です。番号ポータビリティ(電話会社を変えても番号をそのまま使える仕組み)で、今その番号を使っている会社とは違うことがあります。
番号の種類(type)
固定電話以外の番号は、頭の数字で種類を見分けます。種類ごとに決まった桁数でないと HTTP 400 になります。
| type | type_name | 番号の頭 | 桁数 | ハイフンの位置(例) |
|---|---|---|---|---|
fixed | 固定電話 | 下のどれでもない番号 | 10 | 市外局番・市内局番・4桁(03-1234-5678・0123-45-6789 など) |
mobile | 携帯電話 | 070・080・090 | 11 | 3-4-4(090-1234-5678) |
ip | IP電話 | 050 | 11 | 3-4-4(050-1234-5678) |
freedial | フリーダイヤル(着信課金) | 0120 | 10 | 4-3-3(0120-123-456) |
freedial | フリーダイヤル(着信課金) | 0800 | 11 | 4-3-4(0800-123-4567) |
navidial | ナビダイヤル(統一番号) | 0570 | 10 | 4-3-3(0570-123-456) |
teledome | テレドーム | 0180 | 10 | 4-3-3(0180-123-456) |
premium | 情報料代理徴収(0990) | 0990 | 10 | 4-3-3(0990-123-456) |
m2m | M2M等専用番号(IoT 機器など) | 020 | 11 | 3-4-4(020-1234-5678) |
fmc | FMC(固定と携帯の統一番号) | 060 | 11 | 3-4-4(060-1234-5678) |
- 固定電話の市外局番は、上の表の頭(0120・050・090 など)とは重なりません(データを作るたびに確かめています)。
- 固定電話以外の番号は、頭と桁数が合えば HTTP 200 を返します。その番号が電話会社に割り当てられているかは確かめていません。
- 種類はプログラムでは
typeで見分けてください。type_nameは説明文で、言い回しが変わることがあります。
ハイフンの位置の決め方
固定電話の番号は、市外局番の長さが2〜5桁(頭の 0 を含む)とばらばらなので、ハイフンの位置は番号を見ただけでは決まりません。このAPIは、番号の先頭6桁(0+市外局番+市内局番)を総務省「電気通信番号指定状況」の表で引いて、市外局番と市内局番の切れ目を決めています。
よくある「市外局番の一覧の中から、いちばん長く合うものを選ぶ」やり方では、正しく決まらない番号があります。
| 番号 | いちばん長く合う市外局番で切ると | 正しい形(このAPI) |
|---|---|---|
0471234567 | 047-123-4567(市外局番 047 は千葉県市川市・船橋市など) | 04-7123-4567(市外局番 04。千葉県柏市・我孫子市など) |
0154823456 | 0154-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": ["北海道"] }
]
},
…
]
}
area_codeは市外局番(頭の 0 を含む)、local_code_digitsは市内局番の桁数(市外局番と合わせて6桁になる数)です。sectionsはその市外局番を使う番号区画です。1つの市外局番に2つ以上の番号区画があることがあります。codeは電話番号1つの応答のarea.section_codeと同じです。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],
…
}
}
prefixesのキーは先頭6桁、値はfieldsの順の配列です。area_codeは市外局番、sectionは番号区画コード(areas.jsonのsections[].code)、in_useは使用中なら1、未使用なら0です。- 市内局番は、6桁から市外局番を除いた残りです(
"015482"なら市外局番015・市内局番482)。ハイフン付きの形は「市外局番-市内局番-残りの4桁」です。 - 電話会社(
carrier)は、大きさを抑えるためこの表には入れていません。必要なときは1件ずつのURLで引いてください。 - 表に無い6桁は、総務省の指定状況に載っていない番号です(1件ずつのURLでは HTTP 404)。
// 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 | いつ |
|---|---|---|
| 400 | invalid_number | 番号の形が違う(0 から始まる半角数字でない、00 から始まる、ハイフン以外の文字がある)/桁数が種類と合わない(固定電話・0120 などで10桁でない、携帯電話・050・0800 などで11桁でない) |
| 403 | region_not_allowed | 日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます) |
| 404 | number_not_found | 固定電話の番号で、先頭6桁(市外局番+市内局番)が総務省の指定状況の表に無い |
| 404 | not_found | URLが違う |
| 405 | method_not_allowed | GET / HEAD 以外で呼んだ |
表に載っているが「未使用」の範囲の番号(例: 0331234567)は、エラーではなく HTTP 200 で in_use: false・carrier: null を返します。
データの出典・更新・キャッシュ
- 固定電話の番号: 総務省「電気通信番号指定状況」の固定電話番号(市外局番の先頭の数字1〜9ごとの Excel)。先頭6桁ごとの市外局番・市内局番・番号区画・電話会社・使用状況はこれによります。
- 地域の名前: 総務省「市外局番の一覧」。番号区画の名前と市外局番はこれによります。
- 出典の表記: 総務省「電気通信番号指定状況」(固定電話番号)・「市外局番の一覧」を加工して作成。どちらも公共データ利用規約(第1.0版)(CC BY 4.0 互換)によります。
- 照合: 作るたびに、2つの出典の番号区画と市外局番の組がそろうか、先頭6桁が重ならないか、市外局番と市内局番が合わせて5桁か、固定電話の番号が特別な番号(0120・050・090 など)の頭と重ならないかを確かめ、合わなければ作り直しを止めます。
- データの版(
data_version): 使った総務省の公表のうち、いちばん新しいものが何年何月何日現在かです("2026-09-01"は2026年9月1日現在)。指定状況の Excel は市外局番の先頭の数字ごとに版が違うので、それぞれの版は/tel/v1/meta.jsonのsources[].as_ofにあります。作った日時(built_at・UTC)と件数もここにあります。 - 更新: 総務省の公表が変わったら作り直します(毎日の自動更新ではありません)。
- キャッシュ: 応答は1日(エラーは1時間)キャッシュしてかまいません。
ETag/Last-Modifiedに対応しているので、変わっていなければ 304 が返ります。 - 呼び出し回数の目安: 決まった上限はありませんが、1つの利用元から1秒あたり10回程度までにしてください。大量の番号を調べるときは
prefixes.jsonを1回取って使ってください。
変更の方針と更新履歴
- v1 の中では、項目を足すことはあっても、今ある項目の名前や意味は変えません。知らない項目が増えていても無視するように作ってください。
typeの値が増えることもあります。 - 互換性のない変更は、URLの版を分けて(
/tel/v2/など)行います。v1 を終わらせるときは、できるかぎり6か月以上前にこのページでお知らせします。 - 提供条件(無料・登録不要・アクセス回数の上限など)は、利用状況に応じて変えることがあります(利用規約第4条)。
更新履歴
- 2026年11月10日
- 公開(総務省の公表は2026年9月1日現在まで)。
機械で読める仕様(型定義・OpenAPI)
- TypeScript の型定義:
/tel/types.d.ts - OpenAPI 3.1:
/tel/openapi.json(コード生成やテストに使えます)
用語の説明
- 市外局番
- 固定電話の番号の頭にある、地域を表す番号です(頭の 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桁の表で決めています(ハイフンの位置の決め方)。
ご利用にあたって
ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。