---
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}`

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.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)