--- title: "List all requests" url: "https://docs.unified.to/verification/request/List_all_requests" description: "API reference for List all requests. Launch multiple pre-built Request integrations today with zero maintenance — all through a single API." generated_at: "2026-06-03T19:04:00.275Z" --- # List all requests GET/verification/{connection\_id}/request ## Parameters **limit**number default=100 **offset**number default=0 **updated\_gte**date Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **sort** enum name updated\_at created\_at **order** enum asc desc **query**string Query string to search. eg. email address or name **package\_id**string The package ID to filter by **candidate\_id**string The candidate ID to filter by **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 ## Returns [VerificationRequest](/verification/request/model)array **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 results = await sdk.verification.listVerificationRequests({ connectionId, limit: 50, offset: 0, updated_gte: '2026-06-03T19:01:07.596Z', sort: 'updated_at', order: 'asc', query: '', package_id: '', candidate_id: '', fields: '', raw: '', }); ``` ### Node.js (axios) ``` const options = { method: 'GET', url: 'https://api.unified.to/verification/5de520f96e439b002043d8dc/request', headers: { authorization: 'bearer .....' }, params: { limit: 50, offset: 0, updated_gte: '2026-06-03T19:01:07.596Z', sort: 'updated_at', order: 'asc', query: '', package_id: '', candidate_id: '', fields: '', raw: '', } }; const results = await axios.request(options); ``` ### Java ``` AsyncHttpClient client = new DefaultAsyncHttpClient(); client.prepare("GET", "https://api.unified.to/verification/5de520f96e439b002043d8dc/request?limit=50&offset=0&updated_gte=2026-06-03T19:01:07.596Z&sort=updated_at&order=asc&query=&package_id=&candidate_id=&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?limit=50&offset=0&updated_gte=2026-06-03T19:01:07.596Z&sort=updated_at&order=asc&query=&package_id=&candidate_id=&fields=&raw= req, _ := http.NewRequest("GET", 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?limit=50&offset=0&updated_gte=2026-06-03T19:01:07.596Z&sort=updated_at&order=asc&query=&package_id=&candidate_id=&fields=&raw=" headers = { "accept": "application/json", "authorization": "....." } response = requests.get(url, headers=headers) ``` ### PHP ``` $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.unified.to/verification/5de520f96e439b002043d8dc/request?limit=50&offset=0&updated_gte=2026-06-03T19:01:07.596Z&sort=updated_at&order=asc&query=&package_id=&candidate_id=&fields=&raw=", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "accept: application/json", "authorization: ....." ], ]); ``` ### Ruby ``` require 'uri' require 'net/http' require 'openssl' url = URI("https://api.unified.to/verification/5de520f96e439b002043d8dc/request?limit=50&offset=0&updated_gte=2026-06-03T19:01:07.596Z&sort=updated_at&order=asc&query=&package_id=&candidate_id=&fields=&raw=") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["authorization"] = '....' response = http.request(request) puts response.read_body ``` ### cURL ``` curl --request GET \ --url 'https://api.unified.to/verification/5de520f96e439b002043d8dc/request?limit=50&offset=0&updated_gte=2026-06-03T19:01:07.596Z&sort=updated_at&order=asc&query=&package_id=&candidate_id=&fields=&raw=' \ --header 'accept: application/json' \ --header 'authorization: .....' ```