Discover a site
POST/v1/sites/discover
For pre-approved program types. BYOD programs should not use this endpoint.
Given a system serial number and postal/zip code, find a site. You can then use the site ID and system ID(s) to call the Create an enrollment endpoint. If there are multiple systems at the site, the response will include all of them (not only the one matching the provided serial number).
For PWRcell 1 systems, the serial number is that of the inverter device.
For PWRcell 2 systems, the serial number is that of the gateway device.
The postal code check is an extra security factor. It must match the PWRfleet postal/zip code. For example, if the PWRfleet zip code is 90210, you must pass 90210 (90210-1111 won't match). Likewise, if the PWRfleet zip code is 90210-1111, passing 90210 won't match.
If you don't know whether the zip code in PWRfleet is 5 digits or ZIP+4, make two requests, first with the ZIP+4, then with the 5 digit zip.
Postal/zip code matching is lenient with regards to whitespace, symbols and case, so for example "902101234" will match "90210-1234" and "v6b1a6" will match "V6B 1A6".
If no matching site is found (e.g. the serial number is unknown or the postal/zip code doesn't match) the endpoint returns a 200 response with a null match.
Request
Responses
- 200
- 400
- 401
- 403
- 429
OK
Bad Request
Unauthorized
Forbidden
Too Many Requests