---
title: "Get all vendor assessments requests"
method: GET
path: "/v1/hire/{vendorId}/assessmentrequests"
tags: ["AssessmentRequest"]
---

# Get all vendor assessments requests

`GET /v1/hire/{vendorId}/assessmentrequests`

## Request

- Base URL: `https://{company}.keka.com/api`
- URL: `https://{company}.keka.com/api/v1/hire/{vendorId}/assessmentrequests`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://login.kekad.com/connect/token`

Get the list of all Vendor assessments requests

## Path parameters

- `vendorId` string, uuid, required

## Query parameters

- `assessmentStatus` string
- `candidateIds` string
- `lastModified` string, date-time
- `pageNumber` integer
- `pageSize` integer

## Response `200`

Success

- AssessmentRequestDto[]
  - `id` string, uuid: Gets or sets the assessment request identifier.
  - `candidateId` string, nullable: Gets or sets the candidate identifier.
  - `candidateName` string, nullable: Gets or sets the name of the candidate.
  - `candidateEmail` string, nullable: Gets or sets the candidate email.
  - `jobId` string, nullable: Gets or sets the job identifier.
  - `assessmentId` string, uuid, nullable: Gets or sets the assessment identifier.
  - `expiryInDays` integer: Gets or sets the expiry in days.
  - `assessmentStatus` 0 | 1 | 2 | 3 | 4

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `500`: Server Error

---

[API](https://skmtc.dev/keka/apis/keka-hire-api.md) - [All operations](https://skmtc.dev/keka/apis/keka-hire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keka/apis/keka-hire-api/revisions/fcf1c09be7ce?raw)