Multi-validation API

What it checks

You send one request containing an object for each check you want to run, with the inputs that check needs. Provero runs those checks and returns a result block for each one.

Only the blocks you supply are processed, and only the matching result blocks are returned. Each block takes the inputs documented for that service, so a record with a mobile number and a name can be checked for SIM changes and against mobile-network data in the same call. The request supports these 12 blocks:

• age: Age verification
• email: Email verification
• phone: HLR phone verification, with the standard or detailed HLR route
• address: UK address lookup (PAF), a postcode lookup
• uk_address: UK address validation (PAF)
• tps: TPS/CTPS screening
• kyc: Mobile network KYC
• sim_swap: SIM swap check
• ip: IP fraud detection
• breach: Breach detection
• name: Name validation
• geoip: IP geolocation

What it returns

• One block per check

  Each check you include returns its own result block under the same name as the request block, for example kyc and sim_swap.

• Only what you requested

  A check you do not include is not run and has no block in the response.

• Individual outcomes, not a verdict

  The response does not combine the blocks into an overall trust score or pass or fail decision. You weigh each result in your own rules or review.

• Errors by block

  A validation error names the block and field it relates to, such as email.email or ip.ip, so you can see which input needs correcting.

When to use it

• Several checks on one record

  Check the email address, phone number and connection details captured on a form in one request, rather than calling each service separately.

• A simpler integration

  Maintain one request and one response in your code, with each service's result in its own block.

• Your own scoring or rules

  Feed the individual results into your own scoring, routing or manual review, keeping each outcome visible.

• When one check is enough

  If you only need one service, call its own endpoint. Multi-validation is an API endpoint: for files, use the bulk upload on each service where it is offered.

How to read the response

Read each block on its own terms

Interpret the kyc block using the Mobile network KYC guidance, the sim_swap block using the SIM swap check guidance, and so on. Each service page explains its result values.

Check the field reference

Each block follows the response of the corresponding service. Use the Multi-validation API reference for the fields returned in each block when you build against it.

Missing blocks

A block is returned only for a check you requested. If a block you expected is missing, check that it was included in the request.

Combine the results yourself

A pass in one block does not offset a concern in another. Decide how each result affects your rules or review.

API usage

Send a POST request to https://api.provero.io/api/validate/multiple with an object for each supported check you want to run. The inputs you supply for supported checks determine which checks are requested.

• Each block takes the inputs documented for that service. For example, sim_swap takes phone and an optional period_days.
• The response returns a block for each check requested, under the same name.
• Multi-validation is available through the API only.

Example request and response

POST https://api.provero.io/api/validate/multiple

{
  "kyc": {
    "mobile_number": "+447700900123",
    "full_name": "Jane Example",
    "date_of_birth": "1985-04-12"
  },
  "sim_swap": {
    "phone": "+447700900123",
    "period_days": 30
  }
}

{
  "kyc": {
    "status": "success",
    "verification_id": "kyc_example",
    "mobile_number": "+447700900123",
    "mobile_network_code": "23410",
    "results": {
      "full_name": { "result": "match" },
      "date_of_birth": { "result": "match" }
    }
  },
  "sim_swap": {
    "phone": "+447700900123",
    "phone_valid": true,
    "period_days": 30,
    "sim_swapped": false,
    "status": "not_swapped"
  }
}

Illustrative example using a reserved drama number and example identity details. The values are not a real result. The API reference shows a request with all 12 blocks and the fields each block returns.

Pricing

Pricing follows the checks included in each request.

Rates for the individual checks are listed on the pricing page. View all Provero pricing

Need volume pricing? Email pricing@provero.io.

Related checks

Each supported check has its own page explaining its inputs and results.

• HLR phone verification Find dead mobile numbers by API or in bulk, with network status, serving carrier and porting information.
• Email verification Recheck existing email lists or check new addresses for mailbox deliverability and disposable, catch-all or role-based flags.
• Mobile network KYC Compare supplied identity details with mobile-network subscriber data, field by field.
• IP fraud detection Assess IP risk with a fraud score and available VPN, proxy, Tor and abuse indicators.