> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withpersona.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpersona.com/_mcp/server.

# Retrieve a Document Verification

GET https://api.withpersona.com/api/v1/verification/documents/{verification-id}

Retrieves the details of a specific document verification

Reference: https://docs.withpersona.com/api-reference/verifications/document-verifications/retrieve-a-document-verification

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `verification-id` (string, required)

### Query parameters

- `include` (string, optional) — A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details.
- `fields` (map from string to string, optional) — Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.

### Headers

- `Key-Inflection` (enum, optional) — Determines casing for the API response.
  - Allowed values: `camel`, `kebab`, `snake`
- `Idempotency-Key` (string, optional) — Ensures the request is idempotent.
- `Persona-Version` (enum, optional) — Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).
  - Allowed values: `2025-12-08`, `2025-10-27`, `2023-01-05`, `2022-09-01`, `2021-08-18`, `2021-07-05`, `2021-02-21`, `2020-05-18`

## Response

### 200

This endpoint returns a Document Verification object and (optionally) its related objects in `included`.

- `data` (Document Verification, required) — A Document Verification

## Errors

### 400 Bad Request Error

The request was unacceptable, often due to invalid parameters.

- `errors` (list of VerificationDocumentsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 401 Unauthorized Error

An invalid API key was provided.

- `errors` (list of VerificationDocumentsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 403 Forbidden Error

The given API key doesn’t have permissions to perform the request or a quota has been exceeded.

- `errors` (list of VerificationDocumentsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 404 Not Found Error

The requested resource doesn’t exist.

- `errors` (list of VerificationDocumentsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 429 Too Many Requests Error

Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

- `errors` (list of VerificationDocumentsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

## Types

### Document Verification

A Document Verification

- `id` (string, optional) — The token of the verification
- `attributes` (VerificationDiscriminatorMappingVerificationDocumentAttributes, optional)
- `relationships` (VerificationDiscriminatorMappingVerificationDocumentRelationships, optional)

### VerificationDocumentsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems

- `title` (string, optional)
- `details` (string, optional)

### VerificationDiscriminatorMappingVerificationDocumentAttributes

- `checks` (list of VerificationSharedAttributesChecksItems, optional)
- `completed-at` (datetime, optional, nullable) — The time the verification was completed in ISO 8601 format
- `completed-at-ts` (integer, optional, nullable) — The time the verification was completed in Unix timestamp format
- `country-code` (string, optional, nullable) — ISO 3166-1 alpha 2 country code.
- `created-at` (datetime, optional) — The time the verification was created in ISO 8601 format
- `created-at-ts` (integer, optional) — The time the verification was created in Unix timestamp format
- `document-type` (string, optional, nullable) — Document classification assignment based on document content.
- `extraction-responses` (list of ExtractionResponsesItems, optional, nullable) — A list of extractions resulting from processing the uploaded documents corresponding to the document's extraction configuration.
- `fields` (VerificationDiscriminatorMappingVerificationDocumentAttributesFields, optional) — JSON key-value pairs of field name to field value.
- `files` (list of File, optional) — The files uploaded to the associated document for processing.
- `files-normalized` (list of File, optional)
- `redacted-at` (datetime, optional, nullable) — The time the verification was redacted in ISO 8601 format
- `status` (string, optional) — The status of the verification Possible values: - initiated - submitted - tentatively_passed (only for `verification/document` and `verification/qes-infocert`) - tentatively_failed (only for `verification/database-business` and `verification/database-business-footprint`) - passed - failed - requires_retry - skipped - canceled - confirmed (only for `verification/email-address` and `verification/phone-number`) Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
- `submitted-at` (datetime, optional, nullable) — The time the verification was submitted in ISO 8601 format
- `submitted-at-ts` (integer, optional, nullable) — The time the verification was submitted in Unix timestamp format
- `tags` (list of string, optional) — Tags on the verification

### VerificationDiscriminatorMappingVerificationDocumentRelationships

- `accounts` (VerificationSharedRelationshipsAccounts, optional)
- `document` (VerificationDiscriminatorMappingVerificationDocumentRelationshipsDocument, optional)
- `inquiry` (VerificationSharedRelationshipsInquiry, optional) — The inquiry linked to the verification
- `inquiry-template` (VerificationSharedRelationshipsInquiryTemplate, optional)
- `inquiry-template-version` (VerificationSharedRelationshipsInquiryTemplateVersion, optional)
- `template` (VerificationSharedRelationshipsTemplate, optional)
- `transaction` (VerificationSharedRelationshipsTransaction, optional)
- `verification-template` (VerificationSharedRelationshipsVerificationTemplate, optional)
- `verification-template-version` (VerificationSharedRelationshipsVerificationTemplateVersion, optional)

### VerificationSharedAttributesChecksItems

- `name` (string, optional)
- `status` (string, optional) — Possible values: - passed - failed - not_applicable Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
- `category` (string, optional, nullable) — The category assigned to the check. Possible values include: - biometrics - fraud - user_action_required - validity This categorizes the check itself, not its outcome. A null category means the check is uncategorized or its category is unknown; it must not be interpreted as non-fraud. Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
- `reasons` (list of string, optional) — If applicable, reasons are the list of reasons explaining why the check failed or is not applicable. For some checks, `reasons` is the primary signal carrying the underlying detection results. For example, `business_website_malicious_website_detection` surfaces its IPQS and Google Web Risk signals here (e.g. `malware`, `phishing`, `spam-source`) rather than in `metadata`.
- `requirement` (string, optional) — Possible values: - required - not_required - requires_retry Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
- `metadata` (map from string to any, optional) — This is a free-form object containing relevant metadata to the processing and result of the check.

### ExtractionResponsesItems

- `extraction-type` (string, optional)
- `field-name` (string, optional)
- `structured-results` (list of map from string to any, optional) — A list of structured AI extraction results with locations stripped. Values are recursive — objects contain nested structured results — but bounding-box location data is omitted from the API response.
- `results` (list of ExtractionResponsesItemsResultsItems, optional) — A list of objects containing the actual value extracted and additional information relevant to the extraction result.

### VerificationDiscriminatorMappingVerificationDocumentAttributesFields

JSON key-value pairs of field name to field value.

### File

- `filename` (string, optional)
- `url` (string, optional)
- `byte-size` (integer, optional)

### VerificationSharedRelationshipsAccounts

- `data` (list of VerificationSharedRelationshipsAccountsDataItems, optional)

### VerificationDiscriminatorMappingVerificationDocumentRelationshipsDocument

- `data` (VerificationDiscriminatorMappingVerificationDocumentRelationshipsDocumentData, optional)

### VerificationSharedRelationshipsInquiry

The inquiry linked to the verification

- `data` (VerificationSharedRelationshipsInquiryData, optional, nullable)

### VerificationSharedRelationshipsInquiryTemplate

- `data` (VerificationSharedRelationshipsInquiryTemplateData, optional, nullable)

### VerificationSharedRelationshipsInquiryTemplateVersion

- `data` (VerificationSharedRelationshipsInquiryTemplateVersionData, optional, nullable)

### VerificationSharedRelationshipsTemplate

- `data` (VerificationSharedRelationshipsTemplateData, optional, nullable)

### VerificationSharedRelationshipsTransaction

- `data` (VerificationSharedRelationshipsTransactionData, optional, nullable)

### VerificationSharedRelationshipsVerificationTemplate

- `data` (VerificationSharedRelationshipsVerificationTemplateData, optional, nullable)

### VerificationSharedRelationshipsVerificationTemplateVersion

- `data` (VerificationSharedRelationshipsVerificationTemplateVersionData, optional, nullable)

### ExtractionResponsesItemsResultsItems

- `value` (string, optional)
- `page` (integer, optional) — The page number the extraction result is detected. Page is 1-indexed.
- `match-level` (string, optional) — If extraction-type is guided, match-level describes the degree in which the extracted value is similar to the source value. Otherwise the match-level is full.
- `metadata` (ExtractionResponsesItemsResultsItemsMetadata, optional, nullable) — This is a free-form object containing potentially helpful metadata on the extraction result.

### VerificationSharedRelationshipsAccountsDataItems

- `id` (string, optional)
- `type` ("account", optional)

### VerificationDiscriminatorMappingVerificationDocumentRelationshipsDocumentData

- `id` (string, optional)
- `type` (string, optional)

### VerificationSharedRelationshipsInquiryData

- `id` (string, optional)
- `type` ("inquiry", optional)

### VerificationSharedRelationshipsInquiryTemplateData

- `type` ("inquiry-template", optional)
- `id` (string, optional)

### VerificationSharedRelationshipsInquiryTemplateVersionData

- `type` ("inquiry-template-version", optional)
- `id` (string, optional)

### VerificationSharedRelationshipsTemplateData

- `type` ("template", optional)
- `id` (string, optional)

### VerificationSharedRelationshipsTransactionData

- `type` ("transaction", optional)
- `id` (string, optional)

### VerificationSharedRelationshipsVerificationTemplateData

- `type` (string, optional)
- `id` (string, optional)

### VerificationSharedRelationshipsVerificationTemplateVersionData

- `type` (string, optional)
- `id` (string, optional)

### ExtractionResponsesItemsResultsItemsMetadata

This is a free-form object containing potentially helpful metadata on the extraction result.

## Examples

**Response**

```json
{
  "data": {
    "id": "ver_ABC123",
    "attributes": {
      "checks": [],
      "completed-at": null,
      "completed-at-ts": null,
      "country-code": null,
      "created-at": "2023-11-15T16:21:09.000Z",
      "created-at-ts": 1700065269,
      "extraction-responses": [],
      "fields": {},
      "files": [
        {
          "filename": "multipage_example.pdf",
          "url": "https://files.withpersona.com/multipage_example.pdf?access_token=ACCESS_ABC123",
          "byte-size": 123456
        }
      ],
      "files-normalized": [
        {
          "filename": "multipage_example.pdf",
          "url": "https://files.withpersona.com/multipage_example.pdf?access_token=ACCESS_ABC123",
          "byte-size": 123456
        }
      ],
      "status": "initiated",
      "submitted-at": null,
      "submitted-at-ts": null
    },
    "relationships": {
      "document": {
        "data": {
          "id": "doc_BDxMaFYynbVrKPiGdfv4aJyC",
          "type": "document/generic"
        }
      },
      "inquiry": {
        "data": {
          "id": "inq_ABC123",
          "type": "inquiry"
        }
      },
      "inquiry-template": {
        "data": {
          "type": "inquiry-template",
          "id": "itmpl_ABC123"
        }
      },
      "inquiry-template-version": {
        "data": null
      },
      "template": {
        "data": null
      },
      "transaction": {
        "data": null
      },
      "verification-template": {
        "data": {
          "type": "verification-template/document",
          "id": "vtmpl_ABC123"
        }
      },
      "verification-template-version": {
        "data": {
          "type": "verification-template-version/document",
          "id": "vtmplv_ABC123"
        }
      }
    },
    "type": "verification/document"
  }
}
```

**SDK Code**

```python Success
import requests

url = "https://api.withpersona.com/api/v1/verification/documents/verification-id"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Success
const url = 'https://api.withpersona.com/api/v1/verification/documents/verification-id';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Success
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.withpersona.com/api/v1/verification/documents/verification-id"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Success
require 'uri'
require 'net/http'

url = URI("https://api.withpersona.com/api/v1/verification/documents/verification-id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Success
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.withpersona.com/api/v1/verification/documents/verification-id")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Success
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.withpersona.com/api/v1/verification/documents/verification-id', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Success
using RestSharp;

var client = new RestClient("https://api.withpersona.com/api/v1/verification/documents/verification-id");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Success
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.withpersona.com/api/v1/verification/documents/verification-id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```