# Utility API

## Match Result

 - [POST /api/v1/verification/match](https://apidocs.idramp.com/apis/idramp-idv/utility-api/paths/~1api~1v1~1verification~1match/post.md): Evaluates a ruleset against two records (e.g., “source” vs “target”) and returns a boolean match along with detailed rule outcomes.

Request
- Provide a JSON body with:
  - data: arbitrary objects such as sourceRecord and targetRecord holding fields to compare.
  - rule: a tree of evaluation rules (e.g., and, or, equal, lev-ratio) referencing fields via simple expressions.
- See the example for composing nested rules and thresholds (e.g., Levenshtein ratio with threshold).

Successful response (200)
- Returns EvaluateResultModel:
  - isMatch: overall boolean result of the ruleset.
  - fullResult: hierarchical RuleResult tree with match outcomes and causes.
  - namedResults: flattened list of RuleResult items for named rules.

Use cases
- Name normalization and fuzzy matching (e.g., lev-ratio across concatenated name parts).
- Combining exact comparisons (equal) with fallback logic (or) inside higher-level and conditions.

Errors
- 401/403: authentication/authorization failure.
- 422: invalid body or rule specification (see ErrorResponse).

Auth
- Requires x-api-key with the ApiKeyPolicy.