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.
View JSON Schema on GitHub

JSON Schema

arcadia-utility-credential.json Raw ↑
{
  "$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."
    }
  }
}