# Verato Person API

This OpenAPI 3.0 document serves as an **enterprise-level template** for REST APIs  published on the Developer Experience Portal and documented with Redocly Realm.


Version: 1.0.0
License: Example API License

## Servers

Sandbox environment for development and testing.
```
https://sandbox.example.com/{basePath}
```

Variables:
- `basePath`: Base path for all API endpoints.
Default: "api"

Production environment for live integrations.
```
https://api.example.com/{basePath}
```

Variables:
- `basePath`: Base path for all API endpoints.
Default: "api"

## Security

### basicAuth

HTTP Basic authentication

Type: http
Scheme: basic

### bearerAuth

HTTP Bearer token authentication (JWT)

Type: http
Scheme: bearer
Bearer Format: JWT

### clientCertificateAuth

Client certificate-based authentication (mutual TLS)

Type: apiKey
In: header
Name: X-Client-Cert-Thumbprint

## Download OpenAPI description

[Verato Person API](https://developer.verato.com/_bundle/apis/person.openapi.yaml)

## Other

### Add an Identity to the link stack

 - [POST /v2/postIdentity](https://developer.verato.com/apis/person.openapi/other/postidentity.md): Used to add a new identity to the link stack

### Search Using Demographic Information

 - [POST /v2/demographicsSearch](https://developer.verato.com/apis/person.openapi/other/demographicssearch.md): Search link database using provided demographic information, return multiple matches ordered by match score

### Query Using Demographic Information

 - [POST /v2/demographicsQuery](https://developer.verato.com/apis/person.openapi/other/demographicsquery.md): Search link database using provided demographic information to find matching identities

### Query Using an Id

 - [POST /v2/identityIdQuery](https://developer.verato.com/apis/person.openapi/other/queryidentitybyid.md): Search link database for Identity with supplied ID (linkId or external entity ID)