HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Utility Account Discovery Error

Webhook posted when there is an error discovering utility accounts.

Request Body Schema

Property nameData typeRequired?Description
typestringyesValue: "utility_accounts_discovery_error"
created_atstring yes
dataobject (UtilityCredential)yes

UtilityCredential

Property nameData typeRequired?Description
idintegeryes
client_user_idstringyes
utility_namestringyesThe list of supported Arc utilities can be found here.
utility_long_namestringyes Provides greater detail than utility_name. The list of supported Arc utilities can be found here.
usernamestringyes
verification_statusstringyesEnum:"pending" "verified" "rejected" "error"
The verification status of the Utility Credential.

- pending: Credential verification is pending
- verified: The credentials were found to be correct
- rejected: The credentials were found to be incorrect
- error: There was an error attempting to verify the credentials. This status may be transient, as Arc will continue to retry verification in the background.
accounts_load_in_progressbooleanyesIndicates if Arc is in the process of verifying a utility credential or loading associated utility accounts. The combination of verification_status: verified and account_load_in_progress: false will indicate that utility accounts are available in the API. Alternatively, the utility_accounts_discovered webhook will alert you when utility accounts are available in the API.
verification_updated_atnull or string <date-time>yes
created_atstring <date-time>yes
updated_atstring <date-time>yes
sandboxedbooleanyes
uses_test_scenariobooleanyesIndicates if the utility credential was created using a designated test username and password.

Request sample

Content type: application/json

{
  "type": "utility_accounts_discovery_error",
  "created_at": "2019-08-24T14:15:22Z",
  "data": {
    "id": 12345,
    "client_user_id": "fff57dc7-3a2b-4395-8a62-e3486d46dabe",
    "utility_name": "Pepco",
    "utility_long_name": "Pepco DC",
    "username": "great_customer",
    "verification_status": "pending",
    "accounts_load_in_progress": false,
    "verification_updated_at": null,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "sandboxed": false,
    "uses_test_scenario": false
  }
}