> 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 TIN Database Verification

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

Retrieve a TIN database verification

Reference: https://docs.withpersona.com/api-reference/verifications/tin-database-verifications/retrieve-a-tin-database-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) — ID of Verification to retrieve

### 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 TIN Database Verification object and (optionally) its related objects in `included`.

- `data` (TIN Database Verification, required) — A TIN Database Verification

## Errors

### 400 Bad Request Error

The request was unacceptable, often due to invalid parameters.

- `errors` (list of VerificationDatabaseTinsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 401 Unauthorized Error

An invalid API key was provided.

- `errors` (list of VerificationDatabaseTinsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, 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 VerificationDatabaseTinsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 404 Not Found Error

The requested resource doesn’t exist.

- `errors` (list of VerificationDatabaseTinsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

### 429 Too Many Requests Error

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

- `errors` (list of VerificationDatabaseTinsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems, optional)

## Types

### TIN Database Verification

A TIN Database Verification

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

### VerificationDatabaseTinsVerificationIdGetResponsesContentApplicationJsonSchemaErrorsItems

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

### VerificationDiscriminatorMappingVerificationDatabaseTinAttributes

- `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
- `name-business` (string, optional, nullable)
- `name-first` (string, optional, nullable)
- `name-last` (string, optional, nullable)
- `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
- `tin` (string, optional)
- `tin-type` (string, optional, nullable)

### verification-shared-relationships

- `inquiry` (VerificationSharedRelationshipsInquiry, optional) — The inquiry linked to the verification
- `template` (VerificationSharedRelationshipsTemplate, optional)
- `inquiry-template-version` (VerificationSharedRelationshipsInquiryTemplateVersion, optional)
- `inquiry-template` (VerificationSharedRelationshipsInquiryTemplate, optional)
- `transaction` (VerificationSharedRelationshipsTransaction, optional)
- `verification-template` (VerificationSharedRelationshipsVerificationTemplate, optional)
- `verification-template-version` (VerificationSharedRelationshipsVerificationTemplateVersion, optional)
- `accounts` (VerificationSharedRelationshipsAccounts, 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.

### VerificationSharedRelationshipsInquiry

The inquiry linked to the verification

- `data` (VerificationSharedRelationshipsInquiryData, optional, nullable)

### VerificationSharedRelationshipsTemplate

- `data` (VerificationSharedRelationshipsTemplateData, optional, nullable)

### VerificationSharedRelationshipsInquiryTemplateVersion

- `data` (VerificationSharedRelationshipsInquiryTemplateVersionData, optional, nullable)

### VerificationSharedRelationshipsInquiryTemplate

- `data` (VerificationSharedRelationshipsInquiryTemplateData, optional, nullable)

### VerificationSharedRelationshipsTransaction

- `data` (VerificationSharedRelationshipsTransactionData, optional, nullable)

### VerificationSharedRelationshipsVerificationTemplate

- `data` (VerificationSharedRelationshipsVerificationTemplateData, optional, nullable)

### VerificationSharedRelationshipsVerificationTemplateVersion

- `data` (VerificationSharedRelationshipsVerificationTemplateVersionData, optional, nullable)

### VerificationSharedRelationshipsAccounts

- `data` (list of VerificationSharedRelationshipsAccountsDataItems, optional)

### VerificationSharedRelationshipsInquiryData

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

### VerificationSharedRelationshipsTemplateData

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

### VerificationSharedRelationshipsInquiryTemplateVersionData

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

### VerificationSharedRelationshipsInquiryTemplateData

- `type` ("inquiry-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)

### VerificationSharedRelationshipsAccountsDataItems

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

## Examples

**Response**

```json
{
  "data": {
    "id": "ver_2wpqiEtejRcTA1hMJEXmbrJ6",
    "attributes": {
      "checks": [],
      "completed-at": "2022-08-03T04:13:06.000Z",
      "completed-at-ts": 1659499986,
      "country-code": "US",
      "created-at": "2022-08-03T04:11:32.000Z",
      "created-at-ts": 1659499892,
      "name-business": null,
      "name-first": "JANE",
      "name-last": "DOE",
      "status": "passed",
      "submitted-at": "2022-08-03T04:13:00.000Z",
      "submitted-at-ts": 1659499980,
      "tin": "123456789",
      "tin-type": "itin"
    },
    "relationships": {
      "inquiry": {
        "data": null
      },
      "template": {
        "data": null
      },
      "inquiry-template-version": {
        "data": null
      },
      "inquiry-template": {
        "data": null
      },
      "transaction": {
        "data": null
      },
      "verification-template": {
        "data": {
          "type": "verification-template/database-tin",
          "id": "vtmpl_ABC123"
        }
      },
      "verification-template-version": {
        "data": {
          "type": "verification-template-version/database-tin",
          "id": "vtmplv_ABC123"
        }
      }
    },
    "type": "verification/database-tin"
  }
}
```

**SDK Code**

```python Success
import requests

url = "https://api.withpersona.com/api/v1/verification/database-tins/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/database-tins/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/database-tins/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/database-tins/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/database-tins/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/database-tins/verification-id', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

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

```csharp Success
using RestSharp;

var client = new RestClient("https://api.withpersona.com/api/v1/verification/database-tins/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/database-tins/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()
```