日付を指定して 47 都道府県の最低賃金を取得する

GET

/minimum-wages

const url = 'https://api.strata.lambdado.com/v1/minimum-wages';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.strata.lambdado.com/v1/minimum-wages \
  --header 'Authorization: Bearer <token>'

都道府県コードの昇順で 47 件を返す。ページングはない。

履歴の起点は都道府県ごとの 2002 年度の発効日で、最も早いのは滋賀県の 2002-09-29、最も遅いのは長崎県の 2002-10-06。at が起点より前の都道府県が 1 つでもあれば 422 を返し、coverage_since には最も遅い起点が入る。

Authorizations

apiKey

Parameters

Query Parameters

string format: date

/^\d{4}-\d{2}-\d{2}$/

日本の暦の日付。省略すると日本時間の今日。時刻を含む値（2026-01-01T09:00+09:00 など）は 400

Responses

200

その日の 47 都道府県の最低賃金

application/json

object

required

string format: date

/^\d{4}-\d{2}-\d{2}$/

projected

required

At が、sources に載ったどれかのデータの known_through より後。今分かっている最新の状態が続くとみなした答えで、新しいデータを取り込むと変わりうる。404 では、同じエンドポイントが 200 で返す sources のデータで決まる

boolean

items

required

Array<object>

object

prefecture

required

object

level

required

都道府県、市区町村（東京の特別区を含む）、政令市の区

string

Allowed values: prefecture municipality ward

code

required

string

/^(\d{2}|\d{5})$/

name

required

string

hourly_yen

required

時間額（円）

integer

valid_since

required

この日を含む

string format: date

/^\d{4}-\d{2}-\d{2}$/

valid_until

required

One of:

string
null

string format: date

/^\d{4}-\d{2}-\d{2}$/

scheduled

required

Valid_since が日本時間の今日より後なら true。at ではなく呼び出した日で決まるので、同じ at でも valid_since を過ぎてから呼び出すと false になる

boolean

basis

required

答申の時点で載せた額か、決定した額の一覧から取り込んだ額か

string

Allowed values: recommendation determination

next

required

One of:

object
null

object

hourly_yen

required

時間額（円）

integer

valid_since

required

この日を含む

string format: date

/^\d{4}-\d{2}-\d{2}$/

valid_until

required

One of:

string
null

string format: date

/^\d{4}-\d{2}-\d{2}$/

scheduled

required

Valid_since が日本時間の今日より後なら true。at ではなく呼び出した日で決まるので、同じ at でも valid_since を過ぎてから呼び出すと false になる

boolean

basis

required

答申の時点で載せた額か、決定した額の一覧から取り込んだ額か

string

Allowed values: recommendation determination

sources

required

Array<object>

応答に使ったデータの種類ごとの出典。データ源の利用条件が求める表示は attribution をそのまま出せば満たせる

object

dataset

required

string

Allowed values: administrative_areas postal_codes minimum_wages

publisher

required

string

title

required

string

url

required

string format: uri

license

required

データ源の利用条件

object

name

required

string

url

required

string format: uri

attribution

required

出典と、このサービスが加工したことを示す表示用の文

string

updated_on

required

このサービスがこのデータを最後に更新した日。訂正したときも変わる

string format: date

/^\d{4}-\d{2}-\d{2}$/

known_through

required

このデータで分かる最後の日付。at がこの日以前なら、新しいデータを取り込んでも応答は変わらない

string format: date

/^\d{4}-\d{2}-\d{2}$/

Examples

excerpt

2026-10-06 に呼び出した場合の抜粋（実際は 47 件）。東京都の額は答申によるもので、発効日は過ぎている

{
  "at": "2026-10-06",
  "projected": false,
  "items": [
    {
      "prefecture": {
        "level": "prefecture",
        "code": "05",
        "name": "秋田県"
      },
      "hourly_yen": 1031,
      "valid_since": "2026-03-31",
      "valid_until": "2026-10-14",
      "scheduled": false,
      "basis": "determination",
      "next": {
        "hourly_yen": 1090,
        "valid_since": "2026-10-14",
        "valid_until": null,
        "scheduled": true,
        "basis": "recommendation"
      }
    },
    {
      "prefecture": {
        "level": "prefecture",
        "code": "13",
        "name": "東京都"
      },
      "hourly_yen": 1280,
      "valid_since": "2026-10-01",
      "valid_until": null,
      "scheduled": false,
      "basis": "recommendation",
      "next": null
    }
  ],
  "sources": [
    {
      "dataset": "minimum_wages",
      "publisher": "厚生労働省",
      "title": "地域別最低賃金の全国一覧",
      "url": "https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/koyou_roudou/roudoukijun/minimumichiran/",
      "license": {
        "name": "公共データ利用規約（第1.0版）",
        "url": "https://www.digital.go.jp/resources/open_data/public_data_license_v1.0"
      },
      "attribution": "「地域別最低賃金の全国一覧」（厚生労働省）（https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/koyou_roudou/roudoukijun/minimumichiran/）を加工して strata が作成",
      "updated_on": "2026-10-01",
      "known_through": "2026-10-30"
    }
  ]
}

400

パラメータが正しくない

application/problem+json

説明

object

type

required

Allowed value: tag:lambdado.com,2026:strata/problems/invalid-parameter

title

required

string

status

required

integer

detail

string

parameter

required

string

Examples

datetime

at に時刻を付けた

{
  "type": "tag:lambdado.com,2026:strata/problems/invalid-parameter",
  "title": "Invalid parameter",
  "status": 400,
  "detail": "at must be a date (YYYY-MM-DD) without time",
  "parameter": "at"
}

401

API キーがない・正しくない・失効している、または組織が停止されている

application/problem+json

説明

object

type

required

Allowed value: tag:lambdado.com,2026:strata/problems/unauthorized

title

required

string

status

required

integer

detail

string

Examples

Authorization を付けていない

{
  "type": "tag:lambdado.com,2026:strata/problems/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authorization header with a Bearer API key is required"
}

失効したキーを使った

{
  "type": "tag:lambdado.com,2026:strata/problems/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "API key is invalid or revoked"
}

Headers

WWW-Authenticate

required

string

Authorization がないか Bearer 以外の方式なら Bearer、Bearer で渡したキーが無効なら Bearer error="invalid_token"（RFC 6750）

Examples

Authorization を付けていない、または Bearer 以外の方式

Bearer

Bearer で渡したキーが無効

Bearer error="invalid_token"

422

いずれかの都道府県の 2002 年度の発効日より前

application/problem+json

説明

object

type

required

Allowed value: tag:lambdado.com,2026:strata/problems/out-of-coverage

title

required

string

status

required

integer

detail

string

dataset

required

string

Allowed values: administrative_areas postal_codes minimum_wages

coverage_since

required

このデータ（最低賃金の一覧なら、いちばん遅い都道府県）の履歴の起点

string format: date

/^\d{4}-\d{2}-\d{2}$/

Examples

partlyCovered

at=2002-10-01 では、千葉県（2002-10-04）と長崎県（2002-10-06）がまだ起点より前

{
  "type": "tag:lambdado.com,2026:strata/problems/out-of-coverage",
  "title": "The date is before the history this API holds",
  "status": 422,
  "dataset": "minimum_wages",
  "coverage_since": "2002-10-06"
}

429

組織の上限を超えた

application/problem+json

説明

object

type

required

Allowed value: tag:lambdado.com,2026:strata/problems/too-many-requests

title

required

string

status

required

integer

detail

string

window

required

超えた上限。minute は 1 分あたり、month は日本時間の暦月あたり

Allowed values: minute month

limit

required

超えた上限の回数

integer

Examples

月の上限を超えた

{
  "type": "tag:lambdado.com,2026:strata/problems/too-many-requests",
  "title": "Too many requests",
  "status": 429,
  "detail": "monthly limit of 10000 requests reached",
  "window": "month",
  "limit": 10000
}

1 分あたりの上限を超えた

{
  "type": "tag:lambdado.com,2026:strata/problems/too-many-requests",
  "title": "Too many requests",
  "status": 429,
  "detail": "per-minute limit of 60 requests reached",
  "window": "minute",
  "limit": 60
}

Headers

Retry-After

required

integer

次に呼び出せるまでの秒数。月の上限なら日本時間の翌月 1 日 0 時まで、1 分の上限なら次の分まで（1〜60）