Get the primary solar system design for a project

Retrieves the primary (active) solar system design for a project.

Business Context: Each project has one primary design that serves as the official system specification for financing, installation, and customer documentation. The primary design is the "source of truth" for all project calculations.

Primary Design Purpose:

  • Financing Calculations: Used for loan sizing and payment calculations
  • Customer Proposals: Appears in all customer-facing documents
  • Installation Planning: Equipment procurement and installation specs
  • Performance Monitoring: Baseline for system performance tracking
  • Utility Applications: Submitted for interconnection approvals

Primary Design Rules:

  • Only one design per project can be primary at any time
  • If no primary design exists, returns 404
  • Primary status is automatically managed when designs are created/updated
  • Primary design changes may trigger financial recalculations

When Primary Design Changes:

  • New design created with isPrimary=true
  • Existing design updated with isPrimary=true
  • Previous primary automatically becomes secondary

Response Information:

  • Complete design specifications and performance data
  • All equipment details (modules, inverters, racking, storage)
  • System sizing and energy production estimates
  • Design source and creation metadata

Common Use Cases:

  • Generate customer proposals and contracts
  • Calculate financing terms and payments
  • Prepare equipment procurement orders
  • Submit utility interconnection applications
  • Set up performance monitoring systems
  • Validate system specifications before installation

Integration Patterns:

  • Proposal Generation: Fetch primary design for customer documents
  • Financial Calculations: Use primary design for loan calculations
  • Equipment Ordering: Source procurement specs from primary design
  • Monitoring Setup: Configure performance tracking from primary specs
Language
Credentials
URL
Click Try It! to start a request and see the response here!