Arcadia · Schema
UtilityCredential
EnergyUtilitiesClean EnergyBilling DataInterval DataCarbonSolarTariff
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | |
| client_user_id | string | |
| utility_name | string | The list of supported Arcadia utilities can be found [here](https://arc.arcadia.com/coverage?first=25&page=1). |
| utility_long_name | string | Provides greater detail than `utility_name`. The list of supported Arcadia utilities can be found [here](https://arc.arcadia.com/coverage?first=25&page=1). |
| username | string | |
| verification_status | string | 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 |
| accounts_load_in_progress | boolean | Indicates if Arcadia 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 |
| verification_updated_at | string | |
| created_at | string | |
| updated_at | string | |
| sandboxed | boolean | |
| uses_test_scenario | boolean | Indicates if the utility credential was created using a designated test username and password. |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://api.arcadia.com/schemas/UtilityCredential",
"title": "UtilityCredential",
"required": [
"created_at",
"id",
"updated_at",
"client_user_id",
"username",
"utility_name",
"utility_long_name",
"verification_status",
"accounts_load_in_progress",
"verification_updated_at",
"sandboxed",
"uses_test_scenario"
],
"properties": {
"id": {
"type": "integer",
"example": 12345
},
"client_user_id": {
"type": "string",
"example": "fff57dc7-3a2b-4395-8a62-e3486d46dabe"
},
"utility_name": {
"type": "string",
"example": "AEP SWEPCO",
"description": "The list of supported Arcadia utilities can be found [here](https://arc.arcadia.com/coverage?first=25&page=1)."
},
"utility_long_name": {
"type": "string",
"example": "AEP SWEPCO AR",
"description": "Provides greater detail than `utility_name`. The list of supported Arcadia utilities can be found [here](https://arc.arcadia.com/coverage?first=25&page=1)."
},
"username": {
"type": "string",
"nullable": true,
"example": "great_customer"
},
"verification_status": {
"type": "string",
"enum": [
"pending",
"verified",
"rejected",
"error"
],
"description": "The verification status of the Utility Credential.\n\n* `pending`: Credential verification is pending\n* `verified`: The credentials were found to be correct\n* `rejected`: The credentials were found to be incorrect\n* `error`: There was an error attempting to verify the credentials. This status _may_ be transient, as Arcadia will continue to retry verification in the background.\n"
},
"accounts_load_in_progress": {
"type": "boolean",
"example": false,
"description": "Indicates if Arcadia 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_at": {
"format": "date-time",
"type": "string",
"nullable": true
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"sandboxed": {
"type": "boolean",
"example": false
},
"uses_test_scenario": {
"type": "boolean",
"example": false,
"description": "Indicates if the utility credential was created using a designated test username and password."
}
}
}