Baley API Overview

The Baley API facilitates managing compliance investigations for individuals and businesses, with a focus on screening against sanctions, PEP lists, adverse media, and enforcement actions.

Authentication

Use API key in header: X-API-Key

Core Endpoints

Investigations

Create Investigations

  • /api/v1/investigations/individual/vendor-search - Create individual investigations from vendor alerts
  • /api/v1/investigations/business/vendor-search - Create business investigations from vendor alerts
  • /api/v1/investigations/individual/upload-alert - Create individual investigation from JSON alert
  • /api/v1/investigations/business/upload-alert - Create business investigation from JSON alert

Manage Investigations

  • /api/v1/investigations/{investigation_id} - Get investigation details
  • /api/v1/investigations/override-match-status - Override entity match statuses

Batches

  • /api/v1/batches/ - List all batches
  • /api/v1/batches/{batch_id} - Get batch details

Reports

  • /api/v1/reports/{investigation_id}/report - Generate or retrieve investigation report

Data Models

Key Entities

  • Investigations - Cases evaluating risk factors for individuals or businesses
  • Batches - Groups of investigations
  • Matches - Potential risk entities matched to customer
  • Entity statuses - CLEAR/MATCH designations

Risk Categories

  • Sanctions
  • Politically Exposed Persons (PEP)
  • Adverse Media
  • Enforcement Actions
  • Unclassified

Workflow

  1. Create investigations via vendor search or direct JSON upload
  2. Review investigation details and matches
  3. Override match statuses as needed
  4. Generate PDF reports for completed investigations
  5. Manage investigations in batches