API REFERENCE

Authentication

All API requests require JWT-based authentication issued to approved pilot partners.

Endpoints

  • POST /verify – Submits an economic summary and returns a verification signal.
  • GET /health – Returns service health status.
  • GET /status – Returns environment availability and uptime information.

Request Schema (Example)

{
  "monthly_income_avg": 3200,
  "payment_stability_score": 0.87,
  "expense_ratio": 0.42
}

Response Schema (Example)

{
  "verification_status": "VERIFIED",
  "confidence": 0.91,
  "signal_version": "v1.0"
}

Important Notice

BECREDI accepts only pre-aggregated economic summaries. Raw financial data, transaction histories, or personally identifiable financial records are not accepted or stored.