Skip to main content

Descripción General

Esta referencia lista todos los campos disponibles que se pueden usar en condiciones de reglas. Los campos están organizados por tipo de entidad (Persona, Empresa, Transacción, KYC) y país (BR, AR, Global).
Esta documentación se genera automáticamente desde el código base. Última actualización: 2025-12-23

Cómo Usar Esta Referencia

  1. Encuentre su tipo de entidad: Person, Company, Transaction, or KYC
  2. Verifique campos específicos del país: BR (Brazil), AR (Argentina), or GLOBAL
  3. Copie la ruta del campo: Use la ruta exacta del campo en sus condiciones de regla
  4. Elija un operador: Vea la sección Operadores Disponibles
  5. Establezca el valor: Proporcione el valor con el que comparar

Campos de Persona

Campos disponibles para evaluar entidades de persona (clientes individuales).

BR - Country-Specific Fields

AR - Country-Specific Fields

Global Fields

Estructuras de Campos Anidados

Algunos campos contienen estructuras anidadas (arrays u objetos) con múltiples subcampos:

enrichmentData.normalized.documentsSummary - Resumo de Documentos

Tipo: Object Descripción: Estatísticas agregadas sobre documentos Subcampos Disponibles:

enrichmentData.normalized.documents - Documentos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os documentos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.addressesSummary - Resumo de Endereços

Tipo: Object Descripción: Estatísticas agregadas sobre endereços Subcampos Disponibles:

enrichmentData.normalized.addresses - Endereços

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os endereços Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.emailsSummary - Resumo de E-mails

Tipo: Object Descripción: Estatísticas agregadas sobre e-mails Subcampos Disponibles:

enrichmentData.normalized.emails - E-mails

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os e-mails Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.phonesSummary - Resumo de Telefones

Tipo: Object Descripción: Estatísticas agregadas sobre telefones Subcampos Disponibles:

enrichmentData.normalized.phones - Telefones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os telefones Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.sanctionsSummary - Resumo de Sanções

Tipo: Object Descripción: Estatísticas agregadas sobre sanções Subcampos Disponibles:

enrichmentData.normalized.legalProceedingsSummary - Resumo de Processos Legais

Tipo: Object Descripción: Estatísticas agregadas sobre processos legais Subcampos Disponibles:

enrichmentData.normalized.legalProceedings - Processos Judiciais

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os processos judiciais Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.riskFlags - Bandeiras de Risco

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as bandeiras de risco Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.riskFlagsSummary - Resumo de Bandeiras de Risco

Tipo: Object Descripción: Estatísticas agregadas sobre bandeiras de risco Subcampos Disponibles:

enrichmentData.normalized.violations - Violações Consolidadas

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as violações consolidadas (ESG + crimes) Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.violationsSummary - Resumo de Violações

Tipo: Object Descripción: Estatísticas agregadas sobre violações Subcampos Disponibles:

enrichmentData.normalized.mediaMentions - Menções em Mídia

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as menções em mídia consolidadas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.mediaSummary - Resumo de Mídia

Tipo: Object Descripción: Estatísticas agregadas sobre menções na mídia Subcampos Disponibles:

enrichmentData.normalized.sanctions - Sanções Consolidadas

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as sanções consolidadas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.demographics - Demografia

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os dados demográficos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.demographicsSummary - Resumo Demográfico

Tipo: Object Descripción: Estatísticas agregadas sobre dados demográficos Subcampos Disponibles:

enrichmentData.normalized.occupations - Ocupações

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os dados de ocupação Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.occupationsSummary - Resumo de Ocupações

Tipo: Object Descripción: Estatísticas agregadas sobre ocupações profissionais Subcampos Disponibles:

enrichmentData.normalized.electoralActivitySummary - Resumo de Atividade Eleitoral

Tipo: Object Descripción: Estatísticas agregadas sobre doações eleitorais Subcampos Disponibles:

enrichmentData.normalized.electoralActivity - Doações Eleitorais por Ano

Tipo: Array of objects Descripción: Buscar doações eleitorais específicas por ano Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.taxReturnsSummary - Resumo de Declarações de IR

Tipo: Object Descripción: Estatísticas agregadas sobre declarações de imposto de renda Subcampos Disponibles:

enrichmentData.normalized.taxReturns - Declarações de Imposto

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as declarações de imposto Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.relationships - Relacionamentos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os relacionamentos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.relationshipsSummary - Resumo de Relacionamentos

Tipo: Object Descripción: Estatísticas agregadas sobre relacionamentos Subcampos Disponibles:

enrichmentData.normalized.aliases - Nomes Alternativos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os nomes alternativos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.biometricResult - Resultado Biométrico

Tipo: Object Descripción: Resultados de face match e liveness (KYC provider) Subcampos Disponibles:

kyc.documentsVerified - Documentos Verificados

Tipo: Array of objects Descripción: Lista de documentos verificados no KYC Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.riskAssessment - Avaliação de Risco KYC

Tipo: Object Descripción: Avaliação de risco realizada pelo KYC Subcampos Disponibles:

kyc.extractedData - Dados Extraídos do Documento

Tipo: Object Descripción: Dados extraídos do documento de identidade Subcampos Disponibles:

enrichmentData.normalized.documents - Documentos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los documentos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.riskFlags - Banderas de Riesgo

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las banderas de riesgo Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.demographics - Demografía

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los datos demográficos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.occupations - Ocupaciones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los datos de ocupación Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.addresses - Direcciones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las direcciones Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.aliases - Alias/Nombres Alternativos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los nombres alternativos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.aliasesSummary - Resumen de Aliases

Tipo: Object Descripción: Estadísticas agregadas sobre nombres alternativos Subcampos Disponibles:

enrichmentData.normalized.emails - Emails

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los emails Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.phones - Teléfonos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los teléfonos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.sanctions - Sanciones Consolidadas

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las sanciones consolidadas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.sanctionsSummary - Resumen de Sanciones

Tipo: Object Descripción: Estadísticas agregadas sobre listas de sanciones Subcampos Disponibles:

enrichmentData.normalized.legalProceedings - Procesos Judiciales

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los procesos judiciales Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.biometricResult - Resultado Biométrico

Tipo: Object Descripción: Resultados de face match e liveness (KYC provider) Subcampos Disponibles:

kyc.documentsVerified - Documentos Verificados

Tipo: Array of objects Descripción: Lista de documentos verificados no KYC Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.riskAssessment - Avaliação de Risco KYC

Tipo: Object Descripción: Avaliação de risco realizada pelo KYC Subcampos Disponibles:

kyc.extractedData - Dados Extraídos do Documento

Tipo: Object Descripción: Dados extraídos do documento de identidade Subcampos Disponibles:

enrichmentData.normalized.riskFlags - Banderas de Riesgo

Tipo: Array of objects Descripción: Banderas de riesgo consolidadas (PEP, Sanciones). Solo se consolidan automáticamente si hay 1 hit relevante. Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.sanctions - Sanciones

Tipo: Array of objects Descripción: Listas de sanciones donde aparece la persona Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.mediaMentions - Menciones en Medios

Tipo: Array of objects Descripción: Menciones en medios adversos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.demographics - Demografía

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los datos demográficos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.occupations - Ocupaciones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los datos de ocupación Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.biometricResult - Resultado Biométrico

Tipo: Object Descripción: Resultados de face match e liveness (KYC provider) Subcampos Disponibles:

kyc.documentsVerified - Documentos Verificados

Tipo: Array of objects Descripción: Lista de documentos verificados no KYC Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.riskAssessment - Avaliação de Risco KYC

Tipo: Object Descripción: Avaliação de risco realizada pelo KYC Subcampos Disponibles:

kyc.extractedData - Dados Extraídos do Documento

Tipo: Object Descripción: Dados extraídos do documento de identidade Subcampos Disponibles:

Campos de Empresa

Campos disponibles para evaluar entidades de empresa (negocios).

BR - Country-Specific Fields

AR - Country-Specific Fields

Global Fields

Estructuras de Campos Anidados

Algunos campos contienen estructuras anidadas (arrays u objetos) con múltiples subcampos:

enrichmentData.normalized.documents - Documentos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os documentos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.documentsSummary - Resumo de Documentos

Tipo: Object Descripción: Campos agregados sobre documentos Subcampos Disponibles:

enrichmentData.normalized.aliases - Nomes Alternativos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os nomes alternativos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.aliasesSummary - Resumo de Aliases

Tipo: Object Descripción: Estatísticas agregadas sobre nomes alternativos Subcampos Disponibles:

enrichmentData.normalized.cnaes - CNAEs (Atividades Econômicas)

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as atividades econômicas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.cnaesSummary - Resumo de CNAEs

Tipo: Object Descripción: Estatísticas agregadas sobre atividades econômicas Subcampos Disponibles:

enrichmentData.normalized.addresses - Endereços

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os endereços Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.addressesSummary - Resumo de Endereços

Tipo: Object Descripción: Estatísticas agregadas sobre endereços Subcampos Disponibles:

enrichmentData.normalized.emails - E-mails

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os e-mails Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.emailsSummary - Resumo de E-mails

Tipo: Object Descripción: Estatísticas agregadas sobre e-mails Subcampos Disponibles:

enrichmentData.normalized.phones - Telefones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os telefones Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.phonesSummary - Resumo de Telefones

Tipo: Object Descripción: Estatísticas agregadas sobre telefones Subcampos Disponibles:

enrichmentData.normalized.legalProceedings - Processos Judiciais

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os processos judiciais Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.legalProceedingsSummary - Resumo de Processos Judiciais

Tipo: Object Descripción: Estatísticas agregadas sobre processos judiciais Subcampos Disponibles:

enrichmentData.normalized.riskFlags - Bandeiras de Risco

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as bandeiras de risco Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.riskFlagsSummary - Resumo de Bandeiras de Risco

Tipo: Object Descripción: Estatísticas agregadas sobre bandeiras de risco Subcampos Disponibles:

enrichmentData.normalized.sanctionsSummary - Resumo de Sanções

Tipo: Object Descripción: Estatísticas agregadas sobre listas de sanções Subcampos Disponibles:

enrichmentData.normalized.shareholdersSummary - Resumo de Sócios/Acionistas

Tipo: Object Descripción: Estatísticas agregadas sobre estrutura societária Subcampos Disponibles:

enrichmentData.normalized.shareholders - Sócios/Acionistas Consolidados

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos os sócios consolidados (QSA + outras fontes) Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.violations - Violações Consolidadas

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as violações consolidadas (ESG + crimes) Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.violationsSummary - Resumo de Violações

Tipo: Object Descripción: Estatísticas agregadas sobre violações Subcampos Disponibles:

enrichmentData.normalized.mediaMentions - Menções em Mídia

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as menções em mídia consolidadas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.mediaSummary - Resumo de Mídia

Tipo: Object Descripción: Estatísticas agregadas sobre menções na mídia Subcampos Disponibles:

enrichmentData.normalized.sanctions - Sanções Consolidadas

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas as sanções consolidadas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.riskFlags - Banderas de Riesgo

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las banderas de riesgo Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.sanctions - Sanciones Consolidadas

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las sanciones consolidadas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.sanctionsSummary - Resumen de Sanciones

Tipo: Object Descripción: Estadísticas agregadas sobre listas de sanciones Subcampos Disponibles:

enrichmentData.normalized.occupations - Actividades/Ocupaciones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las actividades económicas Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.occupationsSummary - Resumen de Actividades

Tipo: Object Descripción: Estadísticas agregadas sobre actividades económicas Subcampos Disponibles:

enrichmentData.normalized.aliases - Alias/Nombres Alternativos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los nombres alternativos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.aliasesSummary - Resumen de Aliases

Tipo: Object Descripción: Estadísticas agregadas sobre nombres alternativos Subcampos Disponibles:

enrichmentData.normalized.documents - Documentos

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todos los documentos Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.documentsSummary - Resumen de Documentos

Tipo: Object Descripción: Estadísticas agregadas sobre documentos Subcampos Disponibles:

enrichmentData.normalized.addresses - Direcciones

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las direcciones Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

enrichmentData.normalized.addressesSummary - Resumen de Direcciones

Tipo: Object Descripción: Estadísticas agregadas sobre direcciones Subcampos Disponibles:

enrichmentData.normalized.riskFlags - Banderas de Riesgo

Tipo: Array of objects Descripción: Buscar campos específicos dentro de todas las banderas de riesgo Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

Transaction Fields

Fields available for evaluating transaction data.

Global Fields


KYC Fields

Fields available for evaluating KYC verification data.

Global Fields

Estructuras de Campos Anidados

Algunos campos contienen estructuras anidadas (arrays u objetos) con múltiples subcampos:

kyc.biometricResult - Resultado Biométrico

Tipo: Object Descripción: Resultados de face match e liveness (KYC provider) Subcampos Disponibles:

kyc.documentsVerified - Documentos Verificados

Tipo: Array of objects Descripción: Lista de documentos verificados no KYC Subcampos Disponibles: Ejemplo de Uso (Campo de Array):

kyc.riskAssessment - Avaliação de Risco KYC

Tipo: Object Descripción: Avaliação de risco realizada pelo KYC Subcampos Disponibles:

kyc.extractedData - Dados Extraídos do Documento

Tipo: Object Descripción: Dados extraídos do documento de identidade Subcampos Disponibles:

Shareholders Fields

Fields available for evaluating company shareholders and directors.
Shareholder fields use a special notation: shareholders.(person|company).fieldPathExamples:
  • shareholders.person.enrichmentData.normalized.taxId
  • shareholders.company.enrichmentData.normalized.revenue
  • shareholders.person.enrichmentData.normalized.isPep
Shareholder conditions allow you to create rules that evaluate the characteristics of a company’s shareholders and directors. These are relationship-based conditions that check if ANY shareholder matches the specified criteria.The fields listed below show what’s available for person and company shareholders. To use them in conditions, prefix with shareholders.person. or shareholders.company. as shown in the examples.

BR - Country-Specific Fields

AR - Country-Specific Fields


Available Operators

Comparison Operators

  • eq - Equals
  • ne - Not equals
  • gt - Greater than
  • gte - Greater than or equal
  • lt - Less than
  • lte - Less than or equal
  • in - Value is in array
  • not_in - Value is not in array
  • between - Value is between two numbers (inclusive)
  • not_between - Value is not between two numbers
  • is_null - Field is null or undefined
  • is_not_null - Field exists and is not null

String Operators

  • contains - Contains substring
  • not_contains - Does not contain substring
  • starts_with - Starts with substring
  • ends_with - Ends with substring
  • regex - Matches regular expression pattern
  • not_regex - Does not match regular expression pattern

Boolean Operators

  • eq:true - Boolean field is true
  • eq:false - Boolean field is false

Data List Operators

  • in_datalist - Value exists in a data list (blocklists, allowlists)
  • not_in_datalist - Value does not exist in a data list
  • matches_datalist_pattern - Value matches a pattern in data list

Custom List Operators

  • in_custom_list - Value exists in a custom list
  • not_in_custom_list - Value does not exist in a custom list

Date & Time Operators

  • date_between - Date is between two dates
  • date_not_between - Date is not between two dates

Temporal Operators

  • within_last - Event occurred within last N days/hours/minutes
  • between_dates - Date is between two specific dates
  • before - Date is before a specific date
  • after - Date is after a specific date
  • age_in_days - Calculate age in days
  • age_in_hours - Calculate age in hours
  • age_in_minutes - Calculate age in minutes

Mathematical Operators

  • add - Addition
  • subtract - Subtraction
  • multiply - Multiplication
  • divide - Division
  • modulo - Modulo (remainder)
  • power - Exponentiation
  • sum - Sum of values
  • avg - Average of values
  • count - Count of items
  • min - Minimum value
  • max - Maximum value
  • abs - Absolute value
  • round - Round to nearest integer
  • ceil - Round up to nearest integer
  • floor - Round down to nearest integer

Geographical Operators

  • distance_from - Calculate distance from coordinates
  • in_region - Check if location is in region
  • country_risk_level - Check country risk level

Aggregation Operators

  • count_in_period - Count occurrences in time period
  • sum_in_period - Sum values in time period
  • velocity_change - Calculate rate of change over time
  • frequency_pattern - Detect frequency patterns

Logical Operators (for combining conditions)

  • AND - All conditions must be true
  • OR - At least one condition must be true
  • NOT - Inverts the condition result
  • XOR - Exactly one condition must be true

Usage Examples

Simple Condition - Text Field

Check if a company’s legal name equals a specific value:

Number Field with Comparison

Check if company revenue is greater than 1 million:

Boolean Field

Check if a company is sanctioned:

Date Comparison

Check if incorporation date is after a specific date:

Data List Checking

Check if tax ID is in a blocklist:

Working with Arrays - The .$. Notation

When working with array fields, you must use the special .$. notation to traverse array elements and access their properties.

Array Traversal Syntax

The .$. notation tells the rules engine to:
  1. Iterate through each element in the array
  2. Access the specified property within each element
  3. Apply the condition to matching elements (optionally filtered)
Format: arrayField.$.propertyName

Example 1: Array Field with Filters

Check if a company has active legal proceedings with amount > 100,000:
Explanation:
  • legalProceedings is an array of objects
  • .$. traverses each legal proceeding in the array
  • amount accesses the amount property of each proceeding
  • filters ensures we only check proceedings where status === "active"

Example 2: Check Sanction Types

Check if a person has any sanction of type “TERRORIST”:
Explanation:
  • sanctions is an array containing all sanctions records
  • .$. iterates through each sanction
  • type accesses the type field of each sanction
  • The condition matches if ANY sanction has type “TERRORIST”

Example 3: Array with Multiple Filters

Check if a person has any sanction from a specific country and program:
Common Array Fields:
  • enrichmentData.normalized.sanctions.$.type - Sanction types
  • enrichmentData.normalized.sanctions.$.origin - Sanction origins
  • enrichmentData.normalized.sanctions.$.program - Sanction programs
  • enrichmentData.normalized.legalProceedings.$.amount - Legal proceeding amounts
  • enrichmentData.normalized.legalProceedings.$.status - Legal proceeding status
  • enrichmentData.normalized.pepLevels.$.level - PEP level values

Working with Shareholders

Shareholder fields use a special structure: shareholders.(person|company).fieldPath

Shareholder Field Structure

Shareholders can be either person or company entities. To access shareholder properties, use: Format: shareholders.(person|company).fieldPath Where:
  • person - For individual shareholders (uses person entity fields)
  • company - For corporate shareholders (uses company entity fields)
  • fieldPath - Any valid field path from the respective entity type

Example 1: Check Shareholder Tax ID

Check if any shareholder (person) has a specific tax ID:
Explanation:
  • shareholders.person - Look at person-type shareholders
  • enrichmentData.normalized.taxId - Access their normalized tax ID
  • This checks ALL person shareholders for a match

Example 2: Check if Shareholder is PEP

Check if any shareholder (person) is a Politically Exposed Person:

Example 3: Check if Shareholder is Sanctioned

Check if any shareholder (person) is sanctioned:

Example 4: Corporate Shareholder Revenue

Check if any corporate shareholder has revenue greater than 10 million:

Example 5: Shareholder Array Fields

Check if any shareholder (person) has sanctions of a specific type:
Explanation:
  • shareholders.person - Look at person shareholders
  • enrichmentData.normalized.sanctions - Access their sanctions array
  • .$. - Traverse each sanction in the array
  • type - Check the type of each sanction

Common Shareholder Patterns

Person Shareholders:
  • shareholders.person.enrichmentData.normalized.taxId - Tax ID
  • shareholders.person.enrichmentData.normalized.isPep - PEP status
  • shareholders.person.enrichmentData.normalized.sanctioned - Sanction status
  • shareholders.person.enrichmentData.normalized.isDeceased - Death status
  • shareholders.person.entityData.person.firstName - First name
  • shareholders.person.entityData.person.lastName - Last name
Company Shareholders:
  • shareholders.company.enrichmentData.normalized.taxId - Company tax ID
  • shareholders.company.enrichmentData.normalized.revenue - Revenue
  • shareholders.company.enrichmentData.normalized.sanctioned - Sanction status
  • shareholders.company.entityData.company.legalName - Legal name

Complex Condition with Multiple Checks

Check if a person is a PEP OR has sanctions OR has criminal records:

Notes

Country Metadata

Each condition can include country metadata to provide context about where the field comes from:

Array Field Syntax

When working with array fields, use the $ symbol to indicate you’re evaluating items within the array:
  • enrichmentData.normalized.sanctions.$.type - Checks the type field of ANY item in the sanctions array
  • enrichmentData.normalized.legalProceedings.$.amount - Checks the amount field of ANY item in the legalProceedings array

Filters

Filters allow you to pre-filter array items before applying the main condition. They work with AND logic:
This checks if there’s any active terrorism sanction with high severity.

See Also