Skip to main content
Finora Business
Finora Business
Sign InStart Free Trial

Reference

Account Officers

Enterprise only

Relationship manager portal — portfolio, aggregate summary, alerts, cross-sell pipeline, and officer scorecards.

The account officer module powers the relationship manager portal for bank partners. Each officer is assigned a portfolio of businesses; these endpoints surface per-officer views, aggregated alerts, cross-sell opportunities, and performance scorecards.

Officer profile

GET/v1/officers/{officerId}/profile

Returns the officer's identity, branch/region, role, and headline stats.

Response — 200

{
  "success": true,
  "data": {
    "officerId": "off_001",
    "name": "Adebayo Ogundimu",
    "email": "adebayo@bank.example",
    "branch": "Victoria Island",
    "branchCode": "VI-001",
    "role": "senior_relationship_manager",
    "portfolioSize": 32,
    "engagementScore": 0.91,
    "performanceStatus": "green"
  }
}

Portfolio

GET/v1/officers/{officerId}/portfolio

Full list of businesses assigned to the officer with RAG health indicators and key financial metrics.

Query parameters

FieldTypeRequiredNotes
limitintegernoDefault 50, max 100.
offsetintegerno
healthStatusstringnoFilter green / amber / red.
sortBystringnoname, healthStatus, monthlyRevenue, cashPosition, lastActivityDays.
sortOrderstringnoasc or desc.
searchstringnoSubstring on business name.

Each entry includes monthly revenue, cash position, outstanding receivables with aging buckets, active loan balance, a 3-month P&L summary, and a balance-sheet snapshot.

Portfolio summary

GET/v1/officers/{officerId}/portfolio-summary

Aggregate stats across the officer's entire portfolio.

Response — 200

{
  "success": true,
  "data": {
    "officerId": "off_001",
    "totalBusinesses": 32,
    "activeThisMonth": 28,
    "portfolioHealth": { "green": 20, "amber": 8, "red": 4 },
    "totalRevenueUnderManagementKobo": 14500000000,
    "totalOutstandingLoansKobo": 3200000000,
    "loanPenetrationRate": 0.41,
    "platformAdoptionRate": 0.88,
    "averageDaysReceivable": 34
  }
}

Alerts

GET/v1/officers/{officerId}/alerts

Active alerts across the officer's portfolio (declining revenue, negative cash flow, covenant breaches, etc.) sorted by severity.

Query parameters

FieldTypeRequiredNotes
limitintegernoDefault 50, max 100.
offsetintegerno
severitystringnocritical or warning.

Each alert carries type, severity, a human message, businessId, and timestamp. Officer alert streams are what powers the daily action list in the portal.

Cross-sell pipeline

GET/v1/officers/{officerId}/cross-sell-pipeline

Cross-sell opportunities across the officer's portfolio, grouped by product with funnel metrics.

Each opportunity is tagged with a productCategory, a dated evidence trail, and a confidence score. The pipeline is refreshed from the intelligence engine on every request.

Officer scorecard

GET/v1/officers/{officerId}/scorecard

Performance metrics used for internal officer scoring — health distribution, loan conversions, response times, engagement.

Response — 200

Includes:

  • Portfolio size and health breakdown
  • Total revenue under management
  • Loan penetration rate and loan conversions
  • Average alert response time (hours)
  • Engagement score (0–1)
  • 6-month performance trend

403 response for retail keys

{
  "success": false,
  "error": {
    "code": "ENTERPRISE_ONLY",
    "message": "This endpoint requires an enterprise subscription. Contact sales at https://finorabusiness.com/contact",
    "requestId": "req_..."
  }
}

Deploying a relationship manager portal?

The officer module is designed for bank and fintech partners running a branch network. Contact sales to discuss onboarding and SSO.

Related endpoints

Reference index

Back to all modules