ID指定介護保険情報取得API

利用者の介護保険情報を取得するAPI

CAREKARTEに登録されている利用者の介護保険情報を取得するAPIです。
利用者IDを使用して利用者を特定し、指定した日付時点での有効な介護保険情報を取得可能です。
値がない場合はリクエストした日付で有効な介護保険情報を取得します。

API ID

I0001

Request URL

insurance/id-select
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/insurance/id-select
環境 URL
本番環境 https://api.link.carekarte.jp/insurance/id-select

HTTPメソッド

POST

リクエスト

header(すべて必須)

名前
Content-Type application/json
authorization tokenサービスで取得した値を設定

Body(JSON形式)

パラメータ 必須:○ サイズ・形式 説明 仕様
userId String 10桁 利用者ID  
date String   YYYY-MM-DD hh:mm:ss 日付指定 指定した日付時点で有効な介護保険情報を取得する
値がない場合はリクエストした時点で有効な介護保険情報を取得する

サンプルデータ

{
    "userId": "0000001721",
    "date": "2021-10-03"
}

レスポンス

Body(JSON形式)

パラメータ 必須 サイズ・形式 説明 仕様
userId String 10桁 利用者ID  
insuredNumber String 10桁 被保険者番号  
insuredClass String 1桁 被保険者区分 0:空白
1:第1号被保険者
2:第2号被保険者
9:その他
userName String   名前 CAREKARTEの「基本情報管理>基本情報」の氏名
kanaName String   名前フリガナ (半角カナ) CAREKARTEの「基本情報管理>基本情報」のフリガナ
deliveryDate String   YYYY-MM-DD 交付年月日  
provisionalFlag Boolean     暫定フラグ true:暫定保険者証
false:通常
isurerNumber String   保険者番号  
isurerName String   保険者名称  
careLevel String 2桁 要介護度 00:空白
01:非該当
11:要支援 (経過的要介護)
12:要支援1
13:要支援2
21:要介護1
22:要介護2
23:要介護3
24:要介護4
25:要介護5
31:再調査
88:取消
99:なし
certificationDate String   YYYY-MM-DD 認定年月日  
certificationSdate String YYYY-MM-DD 認定有効期間開始日  
certificationEdate String YYYY-MM-DD 認定有効期間終了日  
limitCost String     区分支給限度基準額
(1月あたり)
 
limitCostSdate String   YYYY-MM-DD 区分支給限度基準額有効期間開始日  
limitCostEdate String   YYYY-MM-DD 区分支給限度基準額有効期間終了日  
limitCostOfType [array]     種類支給限度基準額  
 serviceName String     種類支給限度基準額のサービス名称  
 cost String     サービスごとの種類支給限度基準額  
benefitRestrictions [array]     給付制限 最大内容数は3
 content String     給付制限内容  
 sdate String   YYYY-MM-DD 給付制限期間開始日  
 edate String   YYYY-MM-DD 給付制限期間終了日  
supportOfficeNumber String     居宅介護支援事業所番号  
supportOfficeName String     居宅介護支援事業所名称  
notificationDate String   YYYY-MM-DD 届出年月日  
selfCreated Boolean     自己作成フラグ true:自己作成
false:自己作成でない
opinion String     審査委員会意見
サービス種類指定
 

サンプルデータ

正常取得時
{
    "userId": "0000001721",
    "insuredNumber": "1000001011",
    "insuredClass": "1",
    "userName": "青椿あい",
    "kanaName": "アオツバキアイ",
    "deliveryDate": "2021-06-01",
    "provisionalFlag": true,
    "isurerNumber": "452094",
    "isurerName": "えびの市",
    "careLevel": "22",
    "certificationDate": "2021-06-02",
    "certificationSdate": "2021-06-03",
    "certificationEdate": "2025-06-04",
    "limitCost": "1000",
    "limitCostSdate": "2025-06-05",
    "limitCostEdate": "2025-06-06",
    "limitCostOfType": [
        {
            "serviceName": "訪問介護",
            "cost": "2000"
        },
        {
            "serviceName": "訪問看護",
            "cost": "3000"
        }
    ],
    "benefitRestrictions": [
        {
            "content": "4000",
            "sdate": "2021-06-07",
            "edate": "2021-06-08"
        },
        {
            "content": "5000",
            "sdate": "2021-06-09",
            "edate": "2021-06-10"
        }
    ],
    "supportOfficeNumber": "0000002020",
    "supportOfficeName": "居宅介護支援事業所名称",
    "notificationDate": "2021-06-11",
    "selfCreated": true,
    "opinion": "審査委員会意見サービス種類指定"
}

API個別エラー

HTTPコード message エラー説明
400 “UserId does not exist” 利用者IDが見つかりませんでした。
400 “Data does not exist” 有効な介護保険情報が見つかりませんでした。
400 “Validation failed: userId must be a string” 利用者IDの形式を修正してください。
400 “Validation failed: date is incorrect format YYYY-MM-DD” 日時の形式を修正してください。
{
    "code": 400,
    "timestamp": "10/3/2021, 4:08:37 AM",
    "path": "/insurance/id-select",
    "method": "POST",
    "message": "UserId does not exist"
}

連携イメージ(CAREKARTE)