Skip to main content
GET
/
request
/
v1
/
requests
List requests
curl --request GET \
  --url https://api-{region}.sesametime.com/request/v1/requests \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "Vacation request",
      "status": "pending",
      "employeeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "requestType": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Vacation",
        "icon": "vacation"
      },
      "createdAt": "2020-01-01T10:00:00+01:00",
      "updatedAt": "2020-01-01T10:00:00+01:00",
      "resolvedAt": "2024-01-15T14:30:00+01:00",
      "resolvedById": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "flowTotalLevels": 3,
      "flowCurrentLevel": 2,
      "answers": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "questionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "questionName": "Start date",
          "questionType": "date",
          "value": "2024-01-15"
        }
      ]
    }
  ],
  "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

​
status
enum<string>

Filter by status (exact match)

Available options:
pending,
accepted,
rejected
​
status[in]
enum<string>[]

Filter by multiple statuses

Available options:
pending,
accepted,
rejected
​
requestTypeId[in]
string<uuid>[]

Filter by request type IDs

​
employeeId
string<uuid>

Filter by employee ID

​
createdAt[gte]
string<date>

Filter by created date (greater than or equal)

Example:

"2024-01-01"

​
createdAt[lte]
string<date>

Filter by created date (less than or equal)

Example:

"2024-12-31"

​
page
integer
default:1

Page number

​
limit
integer
default:50

Items per page (max 500)

Required range: x <= 500

Response

Successful response - List of requests

​
data
object[]
​
meta
object