Validate an individual entity. | Finic API Documentation

1 curl -X POST https://api.finic.ai/validate-individual-entity \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "request_id": "610fe28e-0cd8-406c-9113-f45bb4c5fc87", 6 "entity": { 7 "first_name": "John", 8 "last_name": "Smith", 9 "full_name": "John Smith" 10 }, 11 "fuzzy_match": false 12 }'

1 { 2 "request_id": "610fe28e-0cd8-406c-9113-f45bb4c5fc87", 3 "entity_risk_score": 0.88, 4 "pep_matches": [ 5 { 6 "match_type": "EXACT", 7 "pep_type": "POLITICIAN", 8 "matching_aliases": [ 9 "John Smith", 10 "Jonathan Smith" 11 ] 12 } 13 ], 14 "watchlist_matches": [ 15 { 16 "match_type": "FUZZY", 17 "watchlist_id": "us_department_of_treasury_sdn", 18 "watchlist_name": "OFAC - Department of Treasury - Specially Designated Nationals", 19 "matching_aliases": [ 20 "John Smith", 21 "Jonathan Smith", 22 "Jon Smith", 23 "John Smit" 24 ] 25 } 26 ] 27 }

Returns whether the individual is a Politically Exposed Person (PEP) and any watchlist matches.

Request

This endpoint expects an object.

request_idstringRequired

Unique request ID for tracking the request. Used to re-try requests that timed out or failed to avoid duplicate processing.

entityobjectRequired

fuzzy_matchbooleanOptional

Defaults to false. If true, the API will return results for entities with minor spelling differences in the name.

Response

request_idstring

Unique request ID for tracking the request.

entity_risk_scoredouble

Risk score for the requested individual entity.

pep_matcheslist of objects

List of matches to Politically Exposed Persons (PEPs).

watchlist_matcheslist of objects

List of matches to entities on enabled watchlists.

Headers

Request

Response