Skip to main content
GET
/
schedule
/
v1
/
absence-day-off-requests
List Absence Day Off Requests
curl --request GET \
  --url https://api-{region}.sesametime.com/schedule/v1/absence-day-off-requests \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "absenceCalendar": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "employee": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "firstName": "Lucas",
          "lastName": "García",
          "email": "jsmith@example.com",
          "workStatus": "online",
          "imageProfileURL": "https://sesame-v2-prod-companies.s3.eu-west-3.amazonaws.com/48351485-1659-413d-bf7f-3ca34fadb521/public-read/g892f1fb-55a3-4e32-9cc9-7c19faa70gaa.png",
          "code": 1,
          "pin": 1000,
          "phone": "+34 111 11 11 11",
          "company": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "notificationEmail": "jsmith@example.com",
            "language": "<string>",
            "createdAt": "2020-01-01T10:00:00+01:00",
            "updatedAt": "2020-01-01T10:00:00+01:00"
          },
          "gender": "female",
          "contractId": "<string>",
          "nid": "<string>",
          "identityNumberType": "dni",
          "secondaryIdentityNumberType": "dni",
          "secondaryNid": "<string>",
          "ssn": "<string>",
          "pricePerHour": 123,
          "accountNumber": "<string>",
          "dateOfBirth": "2023-12-25",
          "customFields": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "name": "<string>",
              "slug": "<string>",
              "type": "<string>",
              "value": "<string>",
              "createdAt": "2020-01-01T10:00:00+01:00",
              "updatedAt": "2020-01-01T10:00:00+01:00"
            }
          ],
          "createdAt": "2020-01-01T10:00:00+01:00",
          "updatedAt": "2020-01-01T10:00:00+01:00",
          "status": "active",
          "children": 2,
          "disability": 25,
          "address": "<string>",
          "postalCode": "<string>",
          "city": "<string>",
          "province": "<string>",
          "country": "ES",
          "nationality": "ES",
          "nationalities": [
            "ES",
            "FR"
          ],
          "personalMail": "jsmith@example.com",
          "maritalStatus": "<string>",
          "emergencyPhone": "<string>",
          "description": "<string>",
          "salaryRange": "<string>",
          "studyLevel": "<string>",
          "professionalCategoryCode": "<string>",
          "professionalCategoryDescription": "<string>",
          "bic": "<string>",
          "jobChargeId": "<string>",
          "jobChargeName": "<string>",
          "jobChargeDescription": "<string>",
          "jobChargeCompetencies": "<string>",
          "language": "es-ES",
          "workPhone": "+34 111 11 11 11",
          "mainRecruiter": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "firstName": "Lucas",
            "lastName": "García",
            "imageProfileURL": "https://sesame-v2-prod-companies.s3.eu-west-3.amazonaws.com/48351485-1659-413d-bf7f-3ca34fadb521/public-read/g892f1fb-55a3-4e32-9cc9-7c19faa70gaa.png",
            "email": "jsmith@example.com",
            "workStatus": "online",
            "workCheckTypeColor": "#FF0000",
            "workCheckTypeName": "Remote"
          },
          "nfc": "<string>",
          "contributionGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "daysOff": [
          {
            "date": "2023-12-25",
            "seconds": 123,
            "startTime": "<string>",
            "endTime": "<string>"
          }
        ],
        "maxDaysOff": 123,
        "year": 123,
        "absenceType": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "needsValidation": true,
          "company": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "notificationEmail": "jsmith@example.com",
            "language": "<string>",
            "createdAt": "2020-01-01T10:00:00+01:00",
            "updatedAt": "2020-01-01T10:00:00+01:00"
          },
          "createdAt": "2020-01-01T10:00:00+01:00",
          "updatedAt": "2020-01-01T10:00:00+01:00",
          "deletedAt": "<string>",
          "type": "normal",
          "pickMode": "by_days",
          "maxPerPeriod": {
            "quantity": 123,
            "period": "day",
            "timeUnit": "day"
          },
          "remuneratedType": "remunerated",
          "category": "sick_leave",
          "status": "active",
          "documentMode": "mandatory",
          "accumulative": true,
          "color": "<string>",
          "maxDateToTakeAbsence": "2023-12-25",
          "creationDateNextYear": "2023-12-25"
        },
        "createdAt": "2020-01-01T10:00:00+01:00",
        "updatedAt": "2020-01-01T10:00:00+01:00",
        "deletedAt": "<string>"
      },
      "employee": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "firstName": "Lucas",
        "lastName": "García",
        "email": "jsmith@example.com",
        "workStatus": "online",
        "imageProfileURL": "https://sesame-v2-prod-companies.s3.eu-west-3.amazonaws.com/48351485-1659-413d-bf7f-3ca34fadb521/public-read/g892f1fb-55a3-4e32-9cc9-7c19faa70gaa.png",
        "code": 1,
        "pin": 1000,
        "phone": "+34 111 11 11 11",
        "company": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "notificationEmail": "jsmith@example.com",
          "language": "<string>",
          "createdAt": "2020-01-01T10:00:00+01:00",
          "updatedAt": "2020-01-01T10:00:00+01:00"
        },
        "gender": "female",
        "contractId": "<string>",
        "nid": "<string>",
        "identityNumberType": "dni",
        "secondaryIdentityNumberType": "dni",
        "secondaryNid": "<string>",
        "ssn": "<string>",
        "pricePerHour": 123,
        "accountNumber": "<string>",
        "dateOfBirth": "2023-12-25",
        "customFields": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "slug": "<string>",
            "type": "<string>",
            "value": "<string>",
            "createdAt": "2020-01-01T10:00:00+01:00",
            "updatedAt": "2020-01-01T10:00:00+01:00"
          }
        ],
        "createdAt": "2020-01-01T10:00:00+01:00",
        "updatedAt": "2020-01-01T10:00:00+01:00",
        "status": "active",
        "children": 2,
        "disability": 25,
        "address": "<string>",
        "postalCode": "<string>",
        "city": "<string>",
        "province": "<string>",
        "country": "ES",
        "nationality": "ES",
        "nationalities": [
          "ES",
          "FR"
        ],
        "personalMail": "jsmith@example.com",
        "maritalStatus": "<string>",
        "emergencyPhone": "<string>",
        "description": "<string>",
        "salaryRange": "<string>",
        "studyLevel": "<string>",
        "professionalCategoryCode": "<string>",
        "professionalCategoryDescription": "<string>",
        "bic": "<string>",
        "jobChargeId": "<string>",
        "jobChargeName": "<string>",
        "jobChargeDescription": "<string>",
        "jobChargeCompetencies": "<string>",
        "language": "es-ES",
        "workPhone": "+34 111 11 11 11",
        "mainRecruiter": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "firstName": "Lucas",
          "lastName": "García",
          "imageProfileURL": "https://sesame-v2-prod-companies.s3.eu-west-3.amazonaws.com/48351485-1659-413d-bf7f-3ca34fadb521/public-read/g892f1fb-55a3-4e32-9cc9-7c19faa70gaa.png",
          "email": "jsmith@example.com",
          "workStatus": "online",
          "workCheckTypeColor": "#FF0000",
          "workCheckTypeName": "Remote"
        },
        "nfc": "<string>",
        "contributionGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "daysOff": [
        {
          "date": "<string>",
          "seconds": 123,
          "startTime": "00:00",
          "endTime": "02:00"
        }
      ],
      "status": "accepted",
      "type": "create",
      "comment": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resolutionComment": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resolvedAt": "2020-01-01T10:00:00+01:00",
      "createdAt": "2020-01-01T10:00:00+01:00",
      "updatedAt": "2020-01-01T10:00:00+01:00",
      "deletedAt": "2020-01-01T10:00:00+01:00"
    }
  ],
  "meta": {
    "currentPage": 1,
    "lastPage": 1,
    "total": 1,
    "perPage": 1
  }
}

Authorizations

​
Authorization
string
header
required

API token obtained from Sesame HR Dashboard > Settings > Integrations > API

Query Parameters

​
employeeId
string<uuid>

The id of the employee

​
absencesValidator
string<uuid>

The id of the manager

​
fromDayOff
string<date>

First day of search period

​
toDayOff
string<date>

Last day of search period

​
updatedAt[gt]
string<date>

First updated date of search period

​
updatedAt[lt]
string<date>

Last updated date of search period

​
status
enum<string>

Request status

Available options:
accepted,
rejected,
pending
​
limit
integer

Limit day offs

​
page
integer

Request a specific page

​
orderBy
string

field1 asc, field2 desc

Response

200 - application/json

Array of Objects

​
data
object[]
​
meta
object