コンテンツにスキップ

find-available-koukikourei

指定した日付の時点で有効な後期高齢保険のうち、代表となる 1 件を取得する。該当する保険が複数あるときは最後の 1 件を返し、なければ null を返します。

リクエスト

項目 内容
メソッド GET
パス /api/find-available-koukikourei
クエリ patient-id — 患者 ID(正の整数)、at — 基準日 (YYYY-MM-DD)

GET /api/find-available-koukikourei?patient-id=1234&at=2026-07-10

レスポンス

有効な Koukikourei が 1 件、または該当がなければ null

{
  "koukikoureiId": 77,
  "patientId": 1234,
  "hokenshaBangou": "39131234",
  "hihokenshaBangou": "12345678",
  "futanWari": 1,
  "validFrom": "2024-04-01",
  "validUpto": "0000-00-00"
}

エラー

ステータス 意味
400 patient-id または at が指定されていない、または不正
404 指定した ID の患者が存在しない
500 取得に失敗した