従業員休暇履歴取得

GET

/staff/holidaySettings/{staff_id}/history

サンドボックス
本番

従業員休暇履歴を取得します。
この機能は従業員本人も利用可能です。

対象

プラン
- プレミアム
- プレミアムプラス
- エンタープライズ、旧有料

対象ユーザー権限

休暇管理閲覧

Authorizations

AppAccessToken
timecard.holidays:read
UserAccessToken
timecard.holidays:read

Parameters

Path Parameters

staff_id

required

string

従業員ID

Example

Responses

200

取得成功

object

staffId

従業員ID

string

holidayHistories

有給取得履歴

Array<object>

object

digestionDate

有給取得日 [YYYY-MM-DD]

string format: date

digestionDateTime

有給取得日時 [YYYY-MM-DDThh:mm:ssTZD]
※ 時間休以外の場合はnull

string format: date-time

nullable

numberOfDays

取得日数

string

numberOfMinutes

時間休取得時間数(分)

integer

memo

メモ

string

grantDaysHistories

有給付与履歴

Array<object>

object

effectiveDate

有給付与日 [YYYY-MM-DD]

string format: date

expirationDate

有給有効期限日 [YYYY-MM-DD]

string format: date

numberOfDays

付与日数

string

numberOfMinutes

時間休付与時間数(分)

integer

grantInfo

有給情報

object

grantTotalDays

総付与日数

string

grantTotalMinutes

総時間休付与時間数(分)

integer

digestionTotalDays

総取得日数

string

digestionTotalMinutes

総時間休取得時間数(分)

integer

grantExpectationDate

付与予定日数（総付与日数に含まれない）

string

grantExpectationMinutes

時間休付与予定時間数（分。総時間休付与時間数に含まれない）

integer

digestionExpectationDate

取得予定日数（総取得日数に含まれる）

string

digestionExpectationMinutes

時間休取得予定時間数（分。総時間休取得時間数に含まれる）

integer

expirationDays

失効日数

string

expirationMinutes

時間休失効時間数(分)

integer

remainingDays

有給残日数

string

remainingMinutes

有給時間休残時間数(分)

integer

Example

{
  "staffId": "1",
  "holidayHistories": [
    {
      "digestionDate": "2020-03-15",
      "digestionDateTime": "2020-03-15T14:00:00+09:00",
      "numberOfDays": "0",
      "numberOfMinutes": 120,
      "memo": "時間休（2時間）"
    },
    {
      "digestionDate": "2020-03-10",
      "digestionDateTime": "2020-03-10T14:00:00+09:00",
      "numberOfDays": "0",
      "numberOfMinutes": 120,
      "memo": "時間休（2時間）"
    },
    {
      "digestionDate": "2020-02-20",
      "digestionDateTime": null,
      "numberOfDays": "1",
      "numberOfMinutes": 0,
      "memo": "体調不良"
    },
    {
      "digestionDate": "2020-01-15",
      "digestionDateTime": null,
      "numberOfDays": "0.5",
      "numberOfMinutes": 0,
      "memo": "午前半休"
    }
  ],
  "grantDaysHistories": [
    {
      "effectiveDate": "2021-01-01",
      "expirationDate": "2022-12-31",
      "numberOfDays": "11",
      "numberOfMinutes": 0
    },
    {
      "effectiveDate": "2020-01-01",
      "expirationDate": "2021-12-31",
      "numberOfDays": "10",
      "numberOfMinutes": 0
    }
  ],
  "grantInfo": {
    "grantTotalDays": "21",
    "grantTotalMinutes": 0,
    "digestionTotalDays": "1.5",
    "digestionTotalMinutes": 120,
    "grantExpectationDate": "0",
    "grantExpectationMinutes": 0,
    "digestionExpectationDate": "0",
    "digestionExpectationMinutes": 120,
    "expirationDays": "0",
    "expirationMinutes": 0,
    "remainingDays": "18.5",
    "remainingMinutes": 240
  }
}

404

指定したIDのデータが存在しない場合

object

type

エラータイプを識別するURI、もしくはabout:blank

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Not Found",
  "detail": "データが確認できませんでした。従業員ID: 999"
}