---
title: "Update a request"
method: PATCH
path: "/verification/{connection_id}/request/{id}"
tags: ["verification", "request"]
---

# Update a request

`PATCH /verification/{connection_id}/request/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- VerificationRequest
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `package_id` string
  - `parameters` VerificationParameterInput[]
    - `id` string
    - `name` string
    - `inputs` string[]
  - `target_url` string
  - `candidate_id` string
  - `profile_ip_address` string
  - `profile_name` string
  - `profile_date_of_birth` string
  - `profile_addresses` VerificationAddress[]
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
  - `profile_gender` 'MALE' | 'FEMALE' | 'INTERSEX' | 'TRANS' | 'NON_BINARY'
  - `profile_emails` string[]
  - `profile_telephones` string[]
  - `profile_national_identifier` string
  - `response_completed_at` string, date-time
  - `response_expires_at` string, date-time
  - `response_issued_at` string, date-time
  - `response_status` 'COMPLETED' | 'FAILED' | 'PASSED' | 'PENDING'
  - `response_score` number
  - `response_redirect_url` string
  - `response_download_urls` string[] — report download
  - `response_details` VerificationResponseDetail[]
    - `title` string
    - `text` string
    - `is_private` boolean
    - `is_failed_reason` boolean
    - `parameter_id` string
    - `download_url` string
  - `response_source` string
  - `raw` object

## Response `200`

Successful

- VerificationRequest
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `package_id` string
  - `parameters` VerificationParameterInput[]
    - `id` string
    - `name` string
    - `inputs` string[]
  - `target_url` string
  - `candidate_id` string
  - `profile_ip_address` string
  - `profile_name` string
  - `profile_date_of_birth` string
  - `profile_addresses` VerificationAddress[]
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
  - `profile_gender` 'MALE' | 'FEMALE' | 'INTERSEX' | 'TRANS' | 'NON_BINARY'
  - `profile_emails` string[]
  - `profile_telephones` string[]
  - `profile_national_identifier` string
  - `response_completed_at` string, date-time
  - `response_expires_at` string, date-time
  - `response_issued_at` string, date-time
  - `response_status` 'COMPLETED' | 'FAILED' | 'PASSED' | 'PENDING'
  - `response_score` number
  - `response_redirect_url` string
  - `response_download_urls` string[] — report download
  - `response_details` VerificationResponseDetail[]
    - `title` string
    - `text` string
    - `is_private` boolean
    - `is_failed_reason` boolean
    - `parameter_id` string
    - `download_url` string
  - `response_source` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)