Setting up your API Account

In order to establish an API connection with iEdison, an organization must: 

1. Procure a Certificate
2.  Sign an Interconnection Security Agreement (ISA)
3. Create an iEdison System Account
4. Maintain a valid Certificate

1. Procure a Certificate 

The user intending to access use the iEdison API is responsible for contacting a certificate provider and procuring a certificate or reusing an existing certificate they may already have. 

NOTE: iEdison supports certificates from multiple certificate providers. A complete list of iEdison supported certificate providers is listed in the API Technical Document available here.

2.  Sign an Interconnection Security Agreement (ISA)

An ISA document is required when creating a system account. When creating an account, the applicant must download a copy of the ISA document, sign it, and then upload the signed copy during the registration process.

The ISA document can be found here or on the Manage System Account page in the iEdison application.

3. Create an iEdison System Account

An agency or organization is required to have a System Account User role to access the iEdison API. Before creating a system account, ensure you have the following prepared to upload and add during the account creation: a valid certificate, an executed ISA document, and a contact person.

Complete the following steps to create your iEdison System Account:

1. Inside the iEdison application, click "Manage System Account" under "Manage Profiles" on the sidebar menu 

   

2. Click the "Add System Account" button  

   
3. Select your agency or Organization from the dropdown menu and provide the Client Name for the system account.
4. Upload the Certificate and signed ISA document for the account. 
   • Note:  The system will auto-populate the Certificate Information section if the certificate has been successfully uploaded and validated by iEdison.  
5. Complete the Contact Person section of the registration. Use the radio button to select between the options:
   • Existing Contact: Person designated as Contact Person for your agency or organization.
   • New Contact: New contact person for the system account.
   • My Profile: Designated yourself as the Contact Person for the system account.
6. Click on the Submit button.

An iEdison Approver user will review your registration and Approve or Deny your System Account registration.

4. Maintain a Valid Certificate

Once a System Account registration has been approved by an iEdison Approver, agencies or contractor organizations will be able to Create or Update an iEdison report using the iEdison API. Institution administrators will be responsible for maintaining a valid certificate.

To update an expired certificate of a System Account, follow the steps below:

1. Navigate to the Manage System Account page

2. Locate the Vendor Name on the System Account table and click on the View Profile link under the Action Items column  

   

    

3. Click on the Upload button for the PKI Certificate to replace the expired certificate
   • The system will validate the certificate and pre-populate the Certificate Information section using the new certificate
4. Click Save