Orders

In Aurora, an order represents a customer’s interest in buying solar from a given installer for a specific site. The same customer can have multiple orders for different installers or sites. After a customer has received an Aurora quick quote and selected an installer, the order is validated and then released to the installer's Aurora account. The installer can then convert an order to a project in Aurora, or decline the order. An installer can only retrieve an order that has been released to their tenant.

Origin and Attribution

The Retrieve Order endpoint includes origin and attribution:

  • origin indicates the product that created the order—for example, marketplace or embedded. It is null when not available.
  • attribution contains marketing attribution for the order when available—UTM parameters (e.g. utm_source, utm_medium, utm_campaign) and click IDs (e.g. gclid, fbclid, msclkid). Only keys with values are included. It is null when no attribution data is available.

Utility Bill

The Retrieve Order endpoint returns a utility_bill_url field. When a utility bill has been attached to the order, this field contains a temporary download URL for the file. The URL is valid for 12 hours from the time of the API response. If no utility bill is attached, the field will be null.