Time off entries

GET /2023-03-01/xhr/time-off-entries

Access token

Retrieve time off / absence entries

Query parameters

start_date string(date) Required

The start date of the search period
end_date string(date) Required

The end date of the search period

Responses

200 application/json

Success
Hide response attributes Show response attributes object
- id string Required
  
  The Affix-assigned id of the time off entry
- remote_id string Required
  
  the remote system-assigned id of the time off entry
- employee_id string Required
  
  the Affix-assigned id of the individual
- employee_remote_id string Required
  
  the remote system-assigned id of the individual
- start_date string(date) | null Required
- end_date string(date) | null Required
- amount number Required
- unit string Required
  
  Values are null, hours, days, or months.
- status string | null Required
  
  Values are null, approved, pending, or rejected.
- employee_note string | null Required
- policy_id string | null Required
  
  The Affix-assigned id of the policy
- policy_remote_id string | null Required
  
  The remote system-assigned id of the policy
- policy_name string | null Required
  
  The name of the policy, as assigned by the remote system
- policy_type string | null Required
  
  Values are null, bereavement, holiday, jury_duty, personal, sick, vacation, or volunteer.
- remote_created_at string(date) | null Required
- remote_modified_at string(date) | null Required
202 application/json

Accepted + pending (async job started)
Hide headers attribute Show headers attribute
- Retry-After integer
  
  Retry your call after the specified amount of seconds
Hide response attribute Show response attribute object
- message string Required
401 application/json

Authentication Error
Hide response attributes Show response attributes object
- error string Required
  
  The type of error
  
  Value is authentication_error.
- message string Required
  
  A descriptive description of the error
- code string Required
  
  Values are incorrect_username_or_password, incorrect_mfa_or_otp, reauthentication_required // cookies are now expired, additional_account_setup_required // password reset, etc, captcha_challenge // amazon type1 captcha challenge (currently unsovable), no_valid_accounts // not used currently but reserved for future use, or insufficient_permission // not enough privileges (ie not an admin, or not enough provider scopes on a provider api token for the Affix scopes requested).
429 application/json

Rate Limited / Too Many Requests
Hide headers attribute Show headers attribute
- Retry-After integer
  
  Retry your call after the specified amount of seconds
Hide response attribute Show response attribute object
- message string Required
500 application/json

Server Error
Hide response attribute Show response attribute object
- message string Required
501 application/json

Not Implemented
Hide response attribute Show response attribute object
- message string Required

GET /2023-03-01/xhr/time-off-entries

curl \
 -X GET https://dev.api.affixapi.com/2023-03-01/xhr/time-off-entries?start_date=2021-01-01&end_date=2021-12-31 \
 -H "Authorization: $API_KEY"

Response examples (200)

[
  {
    "id": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
    "remote_id": "19202938",
    "employee_id": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
    "employee_remote_id": "19202938",
    "start_date": "2020-10-11",
    "end_date": "2020-10-14",
    "amount": 3,
    "unit": "days",
    "status": "approved",
    "employee_note": "Visiting my family",
    "policy_id": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
    "policy_remote_id": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
    "policy_name": "Comp/In Lieu Time",
    "policy_type": "vacation",
    "remote_created_at": "2020-10-11",
    "remote_modified_at": "2020-10-12"
  }
]

Response examples (202)

# Headers
Retry-After: 42

# Payload
{
  "message": "string"
}

Response examples (401)

{
  "error": "authentication_error",
  "message": "Your password is incorrect",
  "code": "incorrect_username_or_password"
}

Response examples (429)

# Headers
Retry-After: 42

# Payload
{
  "message": "string"
}

Response examples (500)

{
  "message": "string"
}

Response examples (501)

{
  "message": "string"
}