---
title: "Search Identities Endpoint"
method: POST
path: "/api/v1/identities/search"
tags: ["identities"]
---

# Search Identities Endpoint

`POST /api/v1/identities/search`

## Request

- Base URL: `https://api.withverifa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.withverifa.com/api/v1/identities/search`
- Auth: none declared

Search identities by field-match filters.

PII fields (name, DOB, document_number, SSN) are matched via HMAC hashes —
the plaintext values are never stored. All three of first_name, last_name,
and date_of_birth must be provided together for name+DOB search.

## Request body

- SearchIdentitiesRequest
  - `external_ref` string, nullable
  - `status` string, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `date_of_birth` string, nullable
  - `document_number` string, nullable
  - `ssn` string, nullable
  - `country` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zip_code` string, nullable
  - `limit` integer
  - `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/withverifa/apis/verifa.md) · [All operations](https://skmtc.dev/withverifa/apis/verifa/llms.txt) · [OpenAPI document](https://skmtc.dev/withverifa/apis/verifa/revisions/7288c82c9e33?raw)