---
title: "Update an employee verification record"
method: PUT
path: "/api/v1/employee-verifications/employees/{employeeId}/{verificationId}"
tags: ["Employee Verification", "Public API"]
---

# Update an employee verification record

`PUT /api/v1/employee-verifications/employees/{employeeId}/{verificationId}`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/employee-verifications/employees/{employeeId}/{verificationId}`
- Auth: OAuth 2
  - Authorization code: `/authorize.php`
  - Token URL: `/token.php` scopes: `employee_verifications.write`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/employee-verifications/employees/:employeeId/:verificationId/put.ts> (a function with typed inputs; its response is checked against the schema)

Partial update of a single employee verification row. Any field omitted from the request body is left unchanged. Returns 404 when the verification id does not exist or does not belong to {employeeId}. Most verification updates flow in via partner webhooks; this endpoint exists for admin-level integrations that need to correct or annotate a record out-of-band, and requires onboarding view-and-edit permission on the employee.

OAuth Scopes: employee_verifications.write

## Path parameters

- `employeeId` integer, required
- `verificationId` integer, required

## Request body

- object
  - `verificationType` 'in-person' | 'hybrid' | 'remote', nullable
  - `verificationStatus` 'pending' | 'inprogress-section-1' | 'inprogress-section-2' | 'completed' | 'failed', nullable
  - `verificationStatusNotes` string, nullable
  - `remoteAccessUrl` string, nullable
  - `eVerifyStatus` 'pending' | 'inprogress' | 'completed' | 'failed', nullable

## Response `200`

Success — returns the updated verification record.

- object
  - `employeeVerification` EmployeeVerificationPublicApiRecord, required: A single employee verification row as returned by the public list API.
    - `id` integer
    - `employeeId` integer, nullable
    - `integrationType` string
    - `verificationType` string
    - `verificationStatus` string, nullable
    - `verificationStatusNotes` string, nullable
    - `remoteAccessUrl` string, nullable
    - `eVerifyStatus` string, nullable
    - `archived` boolean
    - `billingProcessed` boolean
    - `createdByUserId` integer
    - `createdYmdt` string: Creation timestamp (company DB format).
    - `lastModifiedYmdt` string: Last modified timestamp (company DB format).
    - `startDateYmdt` string

## Other responses

- `400`: Invalid request body (unknown enum value or no updatable fields supplied).
- `403`: Forbidden
- `404`: Verification id not found for the supplied employee.
- `500`: Internal server error

---

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