Energea: Invest in Solar — API integration & OpenFinance services

Deliverables checklist

• OpenAPI / Swagger specification for the full Energea integration surface
• Protocol & auth flow report (login, OTP, session refresh, request signing)
• Runnable source code for portfolio, dividend, and impact endpoints (Python / Node.js / Go)
• Excel/CSV/JSON export adapters for accountants and family-office stacks
• Automated regression tests, Postman collection, and developer documentation
• Compliance brief covering SEC Reg A/D, accredited-investor handling, and PII retention

Engagement workflow

1. Scope confirmation: which data flows (holdings, dividends, kWh, impact, subscriptions)
2. Protocol analysis & API design — typically 2–5 business days
3. Build, sandbox validation, and dry-run against an investor account — 3–8 business days
4. Documentation, sample requests, and acceptance test cases — 1–2 business days
5. First usable delivery in 5–15 business days; complex Reg A document mirrors may extend

1. Multi-platform portfolio aggregator

A wealth-management dashboard already pulls brokerage and 401(k) data, but Reg A solar holdings on Energea remain in a silo. We mirror /v1/holdings and /v1/distributions into the aggregator's normalized schema, so a client's Energea fractional shares appear next to their public-market positions with consistent cost-basis and yield fields. This is OpenFinance for alternatives — bringing private-market solar into the same household balance sheet.

2. Monthly dividend reconciliation for accountants

CPA firms supporting impact-investor clients receive Energea dividend confirmations in PDF or in-app only. We deliver a scheduled export job that polls the dividend API on a configurable cadence, normalises gross/fee/net amounts and project IDs, and pushes Excel into the firm's QuickBooks Online or Xero workspace. Each row carries the source distribution ID, so audit trails stay clean.

3. ESG & carbon-accounting feed

Corporate ESG teams investing through Energea need the actual kWh output and CO₂-offset numbers, not estimates. We surface the impact API as a streaming feed (impact.kwh.actual, impact.co2.offset) into Snowflake or BigQuery, partitioned by project and month, ready for the company's annual sustainability report.

4. Family-office tax-package builder

Solar investments under Reg A often produce K-1 forms and depreciation schedules. We integrate the document vault with a family-office tax engine: each new K-1 triggers a webhook, the engine downloads the document, parses cost-basis adjustments, and queues review for the family-office tax lead. No more chasing PDFs in February.

5. Investor CRM sync for advisors

Independent RIAs who steer clients into Energea's renewable strategies want subscription state inside Salesforce or HubSpot. The CRM sync writes back commitment amount, allocation status, and dividend-paid-to-date per client, so advisors can see which clients have idle capital and which are receiving stable monthly cash flow.

Auth: investor login & OTP

POST /api/v1/energea/auth/login
Content-Type: application/json

{
  "email": "investor@example.com",
  "password": "<APP_PASSWORD>",
  "otp_channel": "sms"
}

200 OK
{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "rt_8c2...",
  "expires_in": 3600,
  "account_class": "non_accredited_individual",
  "two_factor_required": true
}

Portfolio holdings query

GET /api/v1/energea/holdings?account_id=acc_123
Authorization: Bearer <ACCESS_TOKEN>

200 OK
{
  "account_id": "acc_123",
  "as_of": "2026-04-30",
  "positions": [
    {
      "project_id": "p4_usa",
      "project_name": "Energea Portfolio 4 USA LP",
      "shares": 12.50,
      "cost_basis_usd": 1250.00,
      "nav_per_share": 102.40,
      "current_value_usd": 1280.00,
      "irr_to_date": 0.123
    }
  ]
}

Dividend distribution export

POST /api/v1/energea/distributions/export
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "account_id": "acc_123",
  "from_date": "2025-01-01",
  "to_date":   "2025-12-31",
  "format":    "xlsx"
}

202 Accepted
{ "job_id": "exp_9a1...", "status": "queued" }

# Webhook callback when ready:
POST <your-callback>
{
  "job_id": "exp_9a1...",
  "status": "ready",
  "download_url": "https://...signed-url..."
}

Regulatory alignment

Energea offerings are qualified with the U.S. Securities and Exchange Commission under Regulation A and Regulation D. Our integrations operate strictly on top of customer-authorized or documented public endpoints; we do not bypass any consent layer. Where the issuer's offering circular or investor agreements impose sharing restrictions, those restrictions are propagated into the API's scope tokens.

Privacy & data handling

Personally identifiable data (SSN, address, banking instructions) is treated as a high-sensitivity class: we apply field-level encryption at rest, redact in logs, and prefer reference IDs over raw values when piping data to downstream warehouses. Retention windows match the lower of the issuer's policy and the consuming system's regulatory minimum, with documented purge jobs.

About OpenFinance Lab

We are an independent technical studio specialising in mobile-app interface integration and authorized API integration. Our team has shipped fintech, payments, and brokerage projects for clients across the U.S., EU, MENA, and Asia, and we built our own toolchain for protocol analysis, traffic capture, and OpenFinance-style adapter generation. Energea sits squarely in our sweet spot: a regulated, account-driven app with rich structured data and a clear OpenFinance use case.

• Engineers from banks, payment gateways, and renewable-asset platforms
• Familiar with U.S. SEC Regulation A / Regulation D, GDPR, and PSD2 frameworks
• Custom Python / Node.js / Go SDKs, OpenAPI specs, and Postman collections
• End-to-end pipeline: protocol analysis → build → validation → compliance review
• Source code delivery from $300 — runnable API source plus full documentation; pay after delivery upon satisfaction
• Pay-per-call API billing — access our hosted endpoints and pay only for the calls you make, no upfront cost

Contact

For quotes or to submit your target app and requirements, open our contact page:

Contact page

Quick turnaround on scoping calls — most engagements move from first email to signed scope within 48 hours.