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

# Advanced Search Endpoint

`POST /api/v1/identities/advanced-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/advanced-search`
- Auth: none declared

Search identities with complex filter operators.

Supports fields: status, country, external_ref, document_type, tags, created_at,
document_number, ssn. Operators: eq, neq, contains, starts_with, between, gt, lt,
gte, lte, in_list. PII fields (document_number, ssn) only support eq operator.

## Request body

- AdvancedSearchRequest: Request body for advanced identity search. mode: 'all' (AND) or 'any' (OR) to combine filters.
  - `mode` string
  - `filters` SearchFilter[], required
    - `field` string, required
    - `operator` string
    - `value` union
      - string
      - unknown[]
        - unknown
  - `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)