# FAQ

## Getting Started

### Is Xpansiv Managed Solutions the correct API to use for SREC facility registration integrations?

Yes. XMS is the correct API for this use case. See [Getting Started](/developer-portal/xpansiv-managed-solutions/getting-started) for how to begin.

### Does our organization already have an Xpansiv Managed Solutions account and API key?

Not necessarily by default; but Xpansiv can help generate an account and API key for you if you don't already have one. See [Authentication](/developer-portal/xpansiv-managed-solutions/authorization) for how to generate a key once you have access.

### We're implementing this for multiple installers, not just one. Do all installers have access to the Xpansiv Managed Solutions platform?

Each installer has its own account and can generate its own API key; this is how the platform is set up today. There is no shared or platform-wide key across installers.

### How do we request a sandbox/UAT environment to start testing?

Provide the email address(es) and IP address(es) that need access, and the Xpansiv team will provision the sandbox environment for you. A lead developer will also be assigned as your point of contact for API questions during testing.

Step-by-step information is available on [Getting Started](/developer-portal/xpansiv-managed-solutions/getting-started).

## Registration Flow

### What does the SREC registration flow look like end-to-end?

1. Register a facility via `POST /facilities`.
2. Get eligibility and required documents via `GET /facilities/{facility_id}/state_eligibilities`.
3. Upload required documents via `POST /facilities/{facility_id}/documents`.
4. Complete the facility application via `POST /facilities/{facility_id}/complete`.


## Facility Creation & Fields

### The API documentation only mentions "Photo of Solar Meter" as a required document; are there others?

Yes, required documents vary by state. The State Eligibilities endpoint (`GET /facilities/{facility_id}/state_eligibilities`) returns the authoritative, state-specific list of required documents; don't rely on the single example in the general docs.

### Meter and Panels are marked optional, but require extra fields (tracking, tilt, azimuth) if supplied; are they truly optional?

They're marked optional specifically so a facility can be created first, with users able to come back and upload meter/panel information afterward. Whether they're ultimately required depends on the specific state application, so treat "optional" as "can be deferred," not "not needed."

### What does "referrer_company" refer to, and how is it different from "installer.company"?

A referrer is a partner organization, while the installer is not necessarily a partner. These can be the same company or different companies depending on the deal; they are not interchangeable.

### Are all "not required" fields truly optional?

Not always; some fields become required depending on other values or facility conditions, even though they're marked optional by default. For example, `hostname` is only required if `system_leased` is true and the facility is located in DC or MD. Don't assume a field marked "not required" is safe to omit in every case — check whether its requirement depends on other fields or the facility's state.

### System Cost, Utility Name, and Utility Account Number are required — where should these come from if we don't already capture them?

If your system doesn't already capture these, you'll need to source them yourself, for example, by pulling them from a third-party design tool such as Solargraf, and pass them through explicitly when creating the facility.

## Terms & Conditions

### Does the homeowner need to register and agree to terms and conditions, and where does that happen?

Yes. This happens on the homeowner-facing side of the integrating partner's application experience, not within the Xpansiv API call itself. The T&Cs are a condensed agreement confirming the information provided is correct and that the applicant has been granted the right to act on the homeowner's behalf to submit the SREC application, with Xpansiv Managed Solutions acting as aggregator.

## Completing Applications

### The Complete Facility Application endpoint says only "zero-fee or fee-waived states" can be completed via the API. Can we get the current list, and what if we operate in other states?

Confirm the current list of zero-fee/fee-waived states directly with the Xpansiv team, as this affects which facilities can be completed programmatically versus needing manual handling. Note: some states involve extra handling, which may require additional steps outside the standard completion flow. Partners operating mostly outside zero-fee/fee-waived states should plan for a manual or semi-automated fallback.