Company Graph

GET /api/v1/public/graph/company/{cnpj_or_id}

cURL

curl "https://api.bracc.app/api/v1/public/graph/company/12345678000190?depth=2"

200 OK

{
  "nodes": [
    {
      "id": "4:abc123:456",
      "label": "ACME COMERCIO LTDA",
      "type": "company",
      "document_id": "12.345.678/0001-90",
      "properties": {
        "razao_social": "ACME COMERCIO LTDA",
        "cnpj": "12.345.678/0001-90",
        "situacao_cadastral": "ATIVA",
        "capital_social": 100000.0,
        "data_abertura": "2010-01-15",
        "uf": "SP",
        "municipio": "SAO PAULO"
      },
      "sources": [
        {
          "database": "rfb_cnpj",
          "record_id": null,
          "extracted_at": null
        }
      ],
      "is_pep": false,
      "exposure_tier": "public_safe"
    },
    {
      "id": "4:def789:123",
      "label": "CONTRACT-2023-001",
      "type": "contract",
      "document_id": null,
      "properties": {
        "contract_number": "2023-001",
        "contract_value": 150000.0,
        "start_date": "2023-01-01",
        "end_date": "2023-12-31",
        "object": "Prestacao de servicos de consultoria",
        "contracting_agency": "MINISTERIO DA ECONOMIA"
      },
      "sources": [
        {
          "database": "comprasnet",
          "record_id": "2023001",
          "extracted_at": "2024-01-15"
        }
      ],
      "is_pep": false,
      "exposure_tier": "public_safe"
    }
  ],
  "edges": [
    {
      "id": "5:rel123:789",
      "source": "4:abc123:456",
      "target": "4:def789:123",
      "type": "HAS_CONTRACT",
      "properties": {
        "role": "supplier",
        "year": 2023
      },
      "confidence": 1.0,
      "sources": [
        {
          "database": "comprasnet",
          "record_id": null,
          "extracted_at": null
        }
      ],
      "exposure_tier": "public_safe"
    }
  ],
  "center_id": "4:abc123:456"
}

Retrieve the relationship graph for a specific company, including connected entities and their relationships. This endpoint supports lookup by CNPJ (formatted or unformatted) or internal entity ID.

This endpoint enforces public access policies. Person entities are automatically filtered out, and only public-safe information is returned.

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

depth · integer · default: "2"

Graph traversal depth. Controls how many relationship hops to include.

• Minimum: 1
• Maximum: 3
• Default: 2

cURL

curl "https://api.bracc.app/api/v1/public/graph/company/12345678000190?depth=2"

200 OK

{
  "nodes": [
    {
      "id": "4:abc123:456",
      "label": "ACME COMERCIO LTDA",
      "type": "company",
      "document_id": "12.345.678/0001-90",
      "properties": {
        "razao_social": "ACME COMERCIO LTDA",
        "cnpj": "12.345.678/0001-90",
        "situacao_cadastral": "ATIVA",
        "capital_social": 100000.0,
        "data_abertura": "2010-01-15",
        "uf": "SP",
        "municipio": "SAO PAULO"
      },
      "sources": [
        {
          "database": "rfb_cnpj",
          "record_id": null,
          "extracted_at": null
        }
      ],
      "is_pep": false,
      "exposure_tier": "public_safe"
    },
    {
      "id": "4:def789:123",
      "label": "CONTRACT-2023-001",
      "type": "contract",
      "document_id": null,
      "properties": {
        "contract_number": "2023-001",
        "contract_value": 150000.0,
        "start_date": "2023-01-01",
        "end_date": "2023-12-31",
        "object": "Prestacao de servicos de consultoria",
        "contracting_agency": "MINISTERIO DA ECONOMIA"
      },
      "sources": [
        {
          "database": "comprasnet",
          "record_id": "2023001",
          "extracted_at": "2024-01-15"
        }
      ],
      "is_pep": false,
      "exposure_tier": "public_safe"
    }
  ],
  "edges": [
    {
      "id": "5:rel123:789",
      "source": "4:abc123:456",
      "target": "4:def789:123",
      "type": "HAS_CONTRACT",
      "properties": {
        "role": "supplier",
        "year": 2023
      },
      "confidence": 1.0,
      "sources": [
        {
          "database": "comprasnet",
          "record_id": null,
          "extracted_at": null
        }
      ],
      "exposure_tier": "public_safe"
    }
  ],
  "center_id": "4:abc123:456"
}

Response Fields

nodes · array

Array of graph nodes (entities) in the company’s network.

Show nodes[]

id · string

Unique internal entity identifier.

label · string

Display label for the entity (usually company name or entity description).

type · string

Entity type: company, contract, sanction, finance, bid, embargo, etc.

document_id · string | null

CNPJ or other document identifier for the entity, if available.

properties · object

Entity-specific properties. Varies by entity type. Common fields include names, dates, values, and descriptive information.

sources · array

Array of source attributions indicating where the data originated.

is_pep · boolean

Whether the entity is a Politically Exposed Person (always false in public mode).

exposure_tier · string

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

edges · array

Array of relationships (edges) connecting the nodes.

Show edges[]

id · string

Unique relationship identifier.

source · string

ID of the source node (matches a node’s id field).

target · string

ID of the target node (matches a node’s id field).

type · string

Relationship type: HAS_CONTRACT, HAS_SANCTION, PARTNER_OF, DONATED_TO, etc.

properties · object

Relationship-specific properties such as roles, dates, amounts, or other metadata.

confidence · number

Confidence score for the relationship (0.0 to 1.0). Higher values indicate stronger evidence.

sources · array

Array of source attributions for the relationship.

exposure_tier · string

Data exposure tier for the relationship, always “public_safe”.

center_id · string

ID of the center/focus node (the company being queried).

Show sources[]

database · string

Source database identifier (e.g., “rfb_cnpj”, “comprasnet”, “ceis”).

record_id · string | null

Original record ID in the source database, if available.

extracted_at · string | null

ISO timestamp of when the data was extracted from the source.

Common Entity Types

• company: Brazilian companies (identified by CNPJ)
• contract: Public contracts
• sanction: Administrative sanctions (CEIS/CNEP/TCU)
• finance: Financial transactions (loans, grants)
• bid: Public bidding processes
• embargo: Environmental embargoes (IBAMA)
• amendment: Congressional budget amendments
• election: Electoral data
• health: Healthcare facility operations

Common Relationship Types

• HAS_CONTRACT: Company has a public contract
• HAS_SANCTION: Entity has a sanction record
• PARTNER_OF: Ownership/partnership relationship
• DONATED_TO: Electoral campaign donation
• RECEIVED_AMENDMENT: Received budget amendment funds
• HAS_EMBARGO: Environmental embargo record
• OPERATES: Operates a facility or service

Use Cases

• Due Diligence: Investigate company relationships and risk factors
• Network Analysis: Visualize business networks and connections
• Compliance Screening: Check for sanctions, embargoes, or adverse records
• Investigative Journalism: Discover connections between entities
• Risk Assessment: Analyze relationship patterns and red flags