Pattern Detection

Detect risk patterns and anomalies for a specific company using BR-ACC’s community intelligence patterns. This endpoint analyzes the company’s graph relationships to identify potential compliance issues, conflicts of interest, and suspicious activity patterns.

Pattern detection is powered by heuristic analysis and may include false positives. Always verify findings with source documents and expert review. Patterns are for investigative leads, not conclusive evidence.

Pattern detection may be temporarily unavailable. When disabled, this endpoint returns a 503 status with an appropriate message.

Path Parameters

cnpj_or_id

string

required

Company identifier. Can be:

CNPJ with formatting: 12.345.678/0001-90
CNPJ without formatting: 12345678000190
Internal entity ID: 4:a1b2c3d4:123

Query Parameters

lang

string

default:"pt"

Language for pattern names and descriptions.

pt: Portuguese
en: English

curl "https://api.bracc.app/api/v1/public/patterns/company/12345678000190?lang=pt"

{
  "entity_id": "4:abc123:456",
  "patterns": [
    {
      "pattern_id": "sanctioned_still_receiving",
      "pattern_name": "Coocorrência: sanção e contrato",
      "description": "Contrato com data dentro da janela registrada de sanção da empresa (CEIS/CNEP/TCU)",
      "data": {
        "sanction_type": "CEIS",
        "sanction_date": "2022-03-15",
        "contract_date": "2022-06-20",
        "contract_value": 250000.0,
        "contracting_agency": "MINISTERIO DA SAUDE"
      },
      "entity_ids": [
        "4:abc123:456",
        "4:sanction789:123",
        "4:contract456:789"
      ],
      "sources": [
        {
          "database": "ceis",
          "record_id": "CEIS-2022-12345",
          "extracted_at": "2024-01-10T08:30:00Z"
        },
        {
          "database": "comprasnet",
          "record_id": "2022/001234",
          "extracted_at": "2024-01-12T14:20:00Z"
        }
      ],
      "exposure_tier": "public_safe",
      "intelligence_tier": "community"
    },
    {
      "pattern_id": "debtor_contracts",
      "pattern_name": "Coocorrência: dívida ativa e contratos",
      "description": "Empresa com registro de dívida ativa na PGFN e recorrência de contratos públicos",
      "data": {
        "debt_amount": 1500000.0,
        "debt_status": "ATIVA",
        "contract_count": 8,
        "total_contract_value": 3200000.0,
        "date_range": "2021-2023"
      },
      "entity_ids": [
        "4:abc123:456",
        "4:debt123:456"
      ],
      "sources": [
        {
          "database": "pgfn_divida_ativa",
          "record_id": null,
          "extracted_at": null
        },
        {
          "database": "comprasnet",
          "record_id": null,
          "extracted_at": null
        }
      ],
      "exposure_tier": "public_safe",
      "intelligence_tier": "community"
    }
  ],
  "total": 2
}

Response Fields

entity_id

string | null

Internal ID of the company entity being analyzed.

patterns

array

Array of detected patterns. Empty if no patterns found.

Show patterns[]

pattern_id

string

Unique identifier for the pattern type (e.g., “sanctioned_still_receiving”, “debtor_contracts”).

pattern_name

string

Human-readable name in the requested language.

description

string

Detailed explanation of what the pattern detects, in the requested language.

data

object

Pattern-specific data with details about the detected issue. Structure varies by pattern type. May include dates, amounts, counts, entity names, and other contextual information.

entity_ids

array

Array of entity IDs involved in the pattern detection.

sources

array

Array of source attributions for the evidence supporting the pattern.

exposure_tier

string

Data exposure tier, always “public_safe” for this endpoint.

intelligence_tier

string

Intelligence tier, always “community” for public patterns.

total

integer

Total number of patterns detected.

Available Patterns

The pattern engine detects the following community-tier patterns:

Sanction & Contract Co-occurrence

Pattern ID: sanctioned_still_receiving
Contracts with dates within a company’s recorded sanction window (CEIS/CNEP/TCU).

Active Debt & Contracts

Pattern ID: debtor_contracts
Company with recorded PGFN active debt and recurring public contracts.

Environmental Embargo & Public Funds

Pattern ID: embargoed_receiving
IBAMA environmental embargo with temporal overlap of public contract or loan.

Self-Dealing Amendment

Pattern ID: self_dealing_amendment
Legislator authored amendment where family company won the contract.

Patrimony Incompatibility

Pattern ID: patrimony_incompatibility
Family company capital inconsistent with declared patrimony.

Donation-Contract Loop

Pattern ID: donation_contract_loop
Company donated to campaign then won contracts from the same politician.

Contract Concentration

Pattern ID: contract_concentration
Supplier share above configured threshold in an agency’s contract spend.

Loan Recipient with Debt

Pattern ID: loan_debtor
Company received BNDES loan while having active PGFN tax debt.

Donation-Amendment-Benefit Loop

Pattern ID: donation_amendment_loop
Company donated to politician who authored amendment benefiting the same company.

Amendment & Contracts Co-occurrence

Pattern ID: amendment_beneficiary_contracts
Company benefited by amendment/grant that also holds recorded public contracts.

Tax Debtor Operating SUS Facility

Pattern ID: debtor_health_operator
Company with active PGFN tax debt operating SUS health facilities.

Sanctioned Operating SUS Facility

Pattern ID: sanctioned_health_operator
Sanctioned company (CEIS/CNEP/TCU) operating SUS health facilities.

Low-Employee Company with Many Contracts

Pattern ID: shell_company_contracts
Company winning multiple contracts in sector with few RAIS-registered employees.

Offshore Connection with Public Contracts

Pattern ID: offshore_connection
Person or company linked to offshore entity that also holds public contracts or loans.

Deputy-Supplier Loop

Pattern ID: deputy_supplier_loop
Deputy paid CEAP expense to company that also donated to their election campaign.

CVM-Sanctioned Receiving Funds

Pattern ID: cvm_sanctioned_receiving
Entity with CVM enforcement proceeding that received public contracts or loans.

Global PEP with Contracts

Pattern ID: global_pep_contracts
Internationally listed PEP with partner company winning public contracts.

Legislator as Own Supplier Partner

Pattern ID: legislator_supplier_loop
Legislator who is partner in company that supplied goods/services to the same legislator.

Recurring Contracts Below Threshold

Pattern ID: split_contracts_below_threshold
Multiple contracts with same agency and object, in the same month, below configured threshold.

SRP Record with Multi-Agency Adoption

Pattern ID: srp_multi_org_hitchhiking
Same SRP bid record linked to contracts from multiple public agencies.

Recurring Inexigibility

Pattern ID: inexigibility_recurrence
Recurring supplier in inexigibility for the same agency and object.

Use Cases

Compliance Screening: Automated detection of potential violations
Due Diligence: Risk assessment for business relationships
Investigative Research: Generate leads for deeper investigation
Monitoring: Track pattern emergence over time
Reporting: Include pattern summaries in risk reports

Use the /graph/company endpoint to retrieve the full relationship context for entities identified in pattern results. This helps you understand and verify the evidence.

Overview

Public Endpoints

Graph Operations

Pattern Detection

Path Parameters

Query Parameters

Response Fields

Available Patterns

Sanction & Contract Co-occurrence

Active Debt & Contracts

Environmental Embargo & Public Funds

Self-Dealing Amendment

Patrimony Incompatibility

Donation-Contract Loop

Contract Concentration

Loan Recipient with Debt

Donation-Amendment-Benefit Loop

Amendment & Contracts Co-occurrence

Tax Debtor Operating SUS Facility

Sanctioned Operating SUS Facility

Low-Employee Company with Many Contracts

Offshore Connection with Public Contracts

Deputy-Supplier Loop

CVM-Sanctioned Receiving Funds

Global PEP with Contracts

Legislator as Own Supplier Partner

Recurring Contracts Below Threshold

SRP Record with Multi-Agency Adoption

Recurring Inexigibility

Use Cases

Build docs developers (and LLMs) love

Overview

Public Endpoints

Graph Operations

​Path Parameters

​Query Parameters

​Response Fields

​Available Patterns

​Sanction & Contract Co-occurrence

​Active Debt & Contracts

​Environmental Embargo & Public Funds

​Self-Dealing Amendment

​Patrimony Incompatibility

​Donation-Contract Loop

​Contract Concentration

​Loan Recipient with Debt

​Donation-Amendment-Benefit Loop

​Amendment & Contracts Co-occurrence

​Tax Debtor Operating SUS Facility

​Sanctioned Operating SUS Facility

​Low-Employee Company with Many Contracts

​Offshore Connection with Public Contracts

​Deputy-Supplier Loop

​CVM-Sanctioned Receiving Funds

​Global PEP with Contracts

​Legislator as Own Supplier Partner

​Recurring Contracts Below Threshold

​SRP Record with Multi-Agency Adoption

​Recurring Inexigibility

​Use Cases

Build docs developers (and LLMs) love

Path Parameters

Query Parameters

Response Fields

Available Patterns

Sanction & Contract Co-occurrence

Active Debt & Contracts

Environmental Embargo & Public Funds

Self-Dealing Amendment

Patrimony Incompatibility

Donation-Contract Loop

Contract Concentration

Loan Recipient with Debt

Donation-Amendment-Benefit Loop

Amendment & Contracts Co-occurrence

Tax Debtor Operating SUS Facility

Sanctioned Operating SUS Facility

Low-Employee Company with Many Contracts

Offshore Connection with Public Contracts

Deputy-Supplier Loop

CVM-Sanctioned Receiving Funds

Global PEP with Contracts

Legislator as Own Supplier Partner

Recurring Contracts Below Threshold

SRP Record with Multi-Agency Adoption

Recurring Inexigibility

Use Cases