Check if value exists in list

Check if a specific value is present in a named list. Returns a boolean result indicating membership. Matching is case-sensitive and exact.

Path Parameters

ParameterTypeRequiredDescription
idUUIDYesNamed list identifier
valuestringYesValue to check for membership

Response Fields

FieldTypeDescription
existsbooleantrue if value is in the list, false otherwise
listNamestringName of the list checked
listTypestringType of the list
valuestringThe value that was checked

Matching Behavior

  • Exact match only (no partial or fuzzy matching)
  • Case-sensitive comparison
  • List must be ACTIVE for checks to succeed
  • Whitespace is significant

Use Cases

  • Pre-validate addresses against whitelists before transactions
  • Check if an asset is in an approved list
  • Verify user membership in approver groups
  • Pre-flight validation before policy evaluation
  • Build address verification UIs

Required Permission

lists:read