> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payvessel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blacklist Query

> Use blacklist queries to screen customers before high-risk actions

Blacklist queries help you determine whether a customer appears in a screened list before you allow higher-risk actions.

## Best For

* Pre-onboarding screening
* Transfer or withdrawal controls
* Escalated review before limit upgrades

## What You Submit

You can query with identifiers such as:

* Phone number
* BVN
* NIN

## What You Get Back

The response returns fields such as:

* `result`
* `hit_time`
* `request_id`

## How To Use It

* Block immediately on confirmed blacklist hits
* Step up verification for borderline or ambiguous cases
* Store the `request_id` for investigation and support workflows