--- title: "Update a request" url: "https://docs.unified.to/verification/request/Update_a_request" description: "API reference for Update a request. Launch multiple pre-built Request integrations today with zero maintenance — all through a single API." generated_at: "2026-06-03T19:04:01.319Z" --- # Update a request PUT/verification/{connection\_id}/request/{id} ## Parameters **fields**string array id created\_at updated\_at package\_id parameters target\_url candidate\_id profile\_ip\_address profile\_name profile\_date\_of\_birth profile\_addresses profile\_gender profile\_emails profile\_telephones profile\_national\_identifier response\_completed\_at response\_expires\_at response\_issued\_at response\_status response\_score response\_redirect\_url response\_download\_urls response\_details response\_source raw Fields to return **raw**string Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar **connection\_id**string required ID of the connection **id**string required ID of the Request ## Payload **id**string read-only **created\_at**date read-only (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date read-only (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **package\_id**string **parameters** array **target\_url**string **candidate\_id**string points to ATS Candidate **profile\_ip\_address**string XXX.XXX.XXX.XXX **profile\_name**string **profile\_date\_of\_birth**string YYYY-MM-DD **profile\_addresses** array **profile\_gender** enum Valid values: "MALE" "FEMALE" "INTERSEX" "TRANS" "NON\_BINARY" **profile\_emails**string array **profile\_telephones**string array **profile\_national\_identifier**string **response\_completed\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **response\_expires\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **response\_issued\_at**date datetime that identify was issued (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **response\_status** enum Valid values: "COMPLETED" "FAILED" "PASSED" "PENDING" Background checks and compliance checks return CLEARFLAGGED or PASS/FAIL or YES/NO **response\_score**number Identity verification services provide confidence scores (e.g., 0-100), Credit checks return specific numeric scores (e.g., FICO score 300-850), Fraud prevention tools use risk scores (e.g., 1-999) **response\_redirect\_url**string Most modern IDV providers (like Onfido, Veriff, Jumio, ID.me). Background Check Providers, such as Checkr, GoodHire, Sterling, and HireRight. Credit bureaus and services often require direct user consent and information. This allows them to properly handle disclosures required by regulations like FCRA. Employment and Education Verification need users to confirm previous employers and schools. **response\_download\_urls**string array report download **response\_details** array **response\_source**string **raw**any ## Returns [VerificationRequest](/verification/request/model) **id**string read-only **created\_at**date read-only (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date read-only (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **package\_id**string **parameters** array **target\_url**string **candidate\_id**string points to ATS Candidate **profile\_ip\_address**string XXX.XXX.XXX.XXX **profile\_name**string **profile\_date\_of\_birth**string YYYY-MM-DD **profile\_addresses** array **profile\_gender** enum Valid values: "MALE" "FEMALE" "INTERSEX" "TRANS" "NON\_BINARY" **profile\_emails**string array **profile\_telephones**string array **profile\_national\_identifier**string **response\_completed\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **response\_expires\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **response\_issued\_at**date datetime that identify was issued (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **response\_status** enum Valid values: "COMPLETED" "FAILED" "PASSED" "PENDING" Background checks and compliance checks return CLEARFLAGGED or PASS/FAIL or YES/NO **response\_score**number Identity verification services provide confidence scores (e.g., 0-100), Credit checks return specific numeric scores (e.g., FICO score 300-850), Fraud prevention tools use risk scores (e.g., 1-999) **response\_redirect\_url**string Most modern IDV providers (like Onfido, Veriff, Jumio, ID.me). Background Check Providers, such as Checkr, GoodHire, Sterling, and HireRight. Credit bureaus and services often require direct user consent and information. This allows them to properly handle disclosures required by regulations like FCRA. Employment and Education Verification need users to confirm previous employers and schools. **response\_download\_urls**string array report download **response\_details** array **response\_source**string **raw**any ## Code Samples ### Node.js SDK ``` import { UnifiedTo } from '@unified-api/typescript-sdk'; const sdk = new UnifiedTo({ security: { jwt: '', }, }); const connectionId = '5de520f96e439b002043d8dc'; const id = '1234'; const results = await sdk.verification.updateVerificationRequest({ connectionId, id, verificationRequest: { }, fields: '', raw: '', }); ``` ### Node.js (axios) ``` const options = { method: 'PUT', url: 'https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8', headers: { authorization: 'bearer .....' }, data: undefined, params: { fields: '', raw: '', } }; const results = await axios.request(options); ``` ### Java ``` AsyncHttpClient client = new DefaultAsyncHttpClient(); client.prepare("PUT", "https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8?fields=&raw=") .setHeader("accept", "application/json") .setHeader("authorization", ".....") .execute() .toCompletableFuture() .thenAccept(System.out::println) .join(); client.close(); ``` ### Go ``` import ( "fmt" "net/http" "io/ioutil" ) url := `https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8?fields=&raw= req, _ := http.NewRequest("PUT", url, nil) req.Header.Add("accept", "application/json") req.Header.Add("authorization", ".....") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) ``` ### Python ``` import requests url = "https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8?fields=&raw=" headers = { "accept": "application/json", "authorization": "....." } response = requests.put(url, headers=headers) ``` ### PHP ``` $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8?fields=&raw=", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "PUT", CURLOPT_HTTPHEADER => [ "accept: application/json", "authorization: ....." ], ]); ``` ### Ruby ``` require 'uri' require 'net/http' require 'openssl' url = URI("https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8?fields=&raw=") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["accept"] = 'application/json' request["authorization"] = '....' response = http.request(request) puts response.read_body ``` ### cURL ``` curl --request PUT \ --url 'https://api.unified.to/verification/5de520f96e439b002043d8dc/request/5de520f96e439b002043d8d8?fields=&raw=' \ --header 'accept: application/json' \ --header 'authorization: .....' ```