About this endpoint
What it does
Verifies any mix of signals — BIN, IP, email, phone, IBAN, address, company/VAT, and person name (sanctions) — passed as query parameters, and returns each module's individual result plus a fused, explainable risk assessment. Only the modules for submitted fields are evaluated; correlation fields are null when there isn't enough overlapping data (e.g. no BIN/IP/address given) to compute them.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| bin | String | No | BIN value to verify. |
| ip | String | No | IP value to verify. |
| String | No | Email value to verify. | |
| phone | String | No | Phone value to verify. |
| iban | String | No | IBAN value to verify. |
| address | String | No | Free-text address (Ultra+). |
| street | String | No | Structured address part — alternative to free-text address. |
| city | String | No | City value to verify. |
| state | String | No | State value to verify. |
| postcode | String | No | Postcode value to verify (alias: zip). |
| company | String | No | Company name to verify. |
| vat | String | No | VAT number to verify. |
| name | String | No | Person name (sanctions). |
| dob | String | No | Date of birth (YYYY-MM-DD). |
| country | String | No | Country value to verify. |
Response
Returns a JSON object with one result block per verification module -- present only for modules that had a field submitted -- plus an assessment object fusing them into a single risk score and recommendation.
| Attribute | Type | Description |
|---|---|---|
| success | Boolean | Whether the request succeeded. |
| code | Integer | Numeric response code. |
| BIN / IP / EMAIL / PHONE / SANCTIONS / IBAN / COMPANY / ADDRESS | Object | Per-signal result, present only for modules with a submitted field. |
| assessment | Object | Fused risk score, recommendation, cross-signal correlations (null where insufficient overlapping signals), and contributing signals. |
| plan | Object | Caller's current plan and which features were evaluated. |



