---
title: "Get all bgvrequests"
method: GET
path: "/hris/bgv/{bgvId}/requests"
tags: ["BGVRequest"]
---

# Get all bgvrequests

`GET /hris/bgv/{bgvId}/requests`

## Request

- Base URL: `https://{company}.keka.com/api/v1`
- URL: `https://{company}.keka.com/api/v1/hris/bgv/{bgvId}/requests`
- Auth: OAuth 2
  - Implicit: `https://login.keka.com/connect/authorize`

Get all bgvrequests

## Path parameters

- `bgvId` string, required

## Query parameters

- `bgvRequestIds` string
- `candidateIds` string
- `bgvStatus` string
- `lastModified` string, date-time
- `pageNumber` integer
- `pageSize` integer

## Response `200`

OK

- BGVRequestDTOPagedResponse: class represents paged response.
  - `succeeded` boolean: Gets or sets a value indicating whether this Keka.API.Web.Core.Response`1 is succeeded.
  - `message` string, nullable: Gets or sets the message.
  - `errors` string[], nullable: Gets or sets the errors.
  - `data` BGVRequestDTO[], nullable: Gets or sets the data.
    - `id` string, nullable
    - `candidateId` string, nullable
    - `firstName` string, nullable
    - `middleName` string, nullable
    - `lastName` string, nullable
    - `status` 0 | 1 | 2 | 3 | 4 | 35
    - `bgvDecision` 0 | 1 | 2
    - `email` string, nullable
    - `mobileNumber` string, nullable
    - `gender` 0 | 1 | 2 | 3
    - `checks` BGVCheckDTO[], nullable
      - `id` string, uuid
      - `name` string, nullable
      - `count` integer
    - `userType` 0 | 1
  - `pageNumber` integer: Gets or sets the page number.
  - `pageSize` integer: Gets or sets the size of the page.
  - `firstPage` string, uri, nullable: Gets or sets the first page.
  - `lastPage` string, uri, nullable: Gets or sets the last page.
  - `totalPages` integer: Gets or sets the total pages.
  - `totalRecords` integer: Gets or sets the total records.
  - `nextPage` string, uri, nullable: Gets or sets the next page.
  - `previousPage` string, uri, nullable: Gets or sets the previous page.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

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