Skip to main content
GET
/
bank_statements
/
{id}
/
enrich
Enrich bank statement
curl --request GET \
  --url https://api.ledgerbeam.com/v1/bank_statements/{id}/enrich \
  --header 'API-KEY: <api-key>'
{
  "id": "bs_123456789",
  "enriched_transactions": [
    {
      "id": "ee02c3be-3825-449c-a35f-7b7cc47675e8",
      "entity": {
        "id": "6890b942-df95-43f5-8f38-a5dcee46d24a",
        "name": "Apple",
        "type": "merchant",
        "website": "https://www.apple.com",
        "logo": "https://logos.ledgerbeam.com/www.apple.com",
        "description": "Apple is a multinational technology company...",
        "intermediaries": []
      },
      "category": {
        "primary": "Entertainment",
        "secondary": [
          "Streaming Service",
          "Digital Content"
        ],
        "accounting_category": "Subscriptions",
        "tags": [
          "streaming",
          "digital-content"
        ]
      },
      "location": {
        "address": "1 Infinite Loop, Cupertino, CA 95014, USA",
        "street": "1 Infinite Loop",
        "city": "Cupertino",
        "state": "California",
        "country": "United States",
        "country_code": "US",
        "postal_code": "95014",
        "latitude": 37.33182,
        "longitude": -122.03118,
        "maps": {
          "google_maps_url": "https://www.google.com/maps/search/?api=1&query=1+Infinite+Loop,+Cupertino,+CA+95014+USA",
          "apple_maps_url": "https://maps.apple.com/?q=1+Infinite+Loop,+Cupertino,+CA+95014+USA",
          "waze_url": "https://waze.com/ul?q=1+Infinite+Loop,+Cupertino,+CA+95014+USA"
        }
      },
      "recurrence": {
        "is_recurring": true,
        "frequency": "monthly",
        "next_occurrence": "2025-07-24",
        "confidence_score": 0.95
      },
      "confidence_score": 0.95
    }
  ],
  "enrichment_summary": {
    "total_enriched": 45,
    "entities_identified": 38,
    "categories_assigned": 42,
    "recurring_patterns_found": 5
  }
}

Overview

Enrich transactions extracted from a bank statement with entity identification, categorization, and recurrence detection.
  • Transaction Enrichment: Add intelligence to extracted transactions
  • Data Analysis: Get enriched data for business intelligence
  • Automation: Automatically categorize and identify entities
  • Reporting: Generate detailed reports with enriched transaction data

Authorizations

API-KEY
string
header
required

API key for authentication

Path Parameters

id
string
required

Bank statement ID

Response

Bank statement enriched successfully

id
string

Bank statement ID

Example:

"bs_123456789"

enriched_transactions
object[]

Enriched transactions

enrichment_summary
object