Skip to main content
POST
/
data-lists
/
{type}
/
check
Check value in lists by type
curl --request POST \
  --url http://api.gu1.ai/data-lists/{type}/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "searchValue": "<any>",
  "options": {}
}
'

​
Overview

Runs the isInDataList lookup for the given list type (e.g. custom, company_blocklist). Useful for runtime screening without referencing a specific list UUID.

​
Endpoint

POST https://api.gu1.ai/data-lists/{type}/check

​
Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Request Body

​
searchValue
any
required
Value to match (string, number, or structured object depending on type).
​
options
object
  • includeMetadata (boolean): include match metadata in the response.
  • useCache (boolean): defaults to true; set false to bypass cache.

​
Response

found, listType, searchValue (redacted when non-string), matches, matchCount, plus performance timing and optional cacheHit.