{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/envestnet/json-schema/envestnet-provider-response-schema.json",
  "title": "ProviderResponse",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/envestnet-providers-api-openapi.yml#/components/schemas/ProviderResponse",
  "type": "object",
  "properties": {
    "provider": {
      "type": "array",
      "readOnly": true,
      "items": {
        "$ref": "#/$defs/Providers"
      }
    }
  },
  "$defs": {
    "Attribute": {
      "title": "Attribute",
      "type": "object",
      "properties": {
        "container": {
          "type": "array",
          "description": "Containers for which the attributes are supported.<br><br><b>Endpoints</b>:<ul><li>GET providers</li><li>GET providers/{providerId}</li></ul>",
          "items": {
            "type": "string",
            "enum": [
              "bank",
              "creditCard",
              "investment",
              "insurance",
              "loan",
              "reward",
              "bill",
              "realEstate",
              "otherAssets",
              "otherLiabilities"
            ]
          }
        },
        "fromDate": {
          "type": "string",
          "description": "Applicable only to EBILLS and STATEMENTS attributes of DOCUMENT dataset.<br><br><b>Endpoints</b>:<ul><li>POST providerAccounts</li><li>PUT providerAccounts</li></ul>",
          "readOnly": true
        },
        "toFinYear": {
          "type": "string",
          "description": "Applicable only to TAX attribute of DOCUMENT dataset.<br><br><b>Endpoints</b>:<ul><li>POST providerAccounts</li><li>PUT providerAccounts</li></ul>",
          "readOnly": true
        },
        "fromFinYear": {
          "type": "string",
          "description": "Applicable only to TAX attribute of DOCUMENT dataset.<br><br><b>Endpoints</b>:<ul><li>POST providerAccounts</li><li>PUT providerAccounts</li></ul>",
          "readOnly": true
        },
        "containerAttributes": {
          "$ref": "#/$defs/ContainerAttributes"
        },
        "toDate": {
          "type": "string",
          "description": "Applicable only to EBILLS and STATEMENTS attributes of DOCUMENT dataset.<br><br><b>Endpoints</b>:<ul><li>POST providerAccounts</li><li>PUT providerAccounts</li></ul>",
          "readOnly": true
        },
        "name": {
          "type": "string",
          "description": "Attributes that are supported for a dataset.<br><br><b>Endpoints</b>:<ul><li>GET providers</li><li>GET providers/{providerId}</li></ul>",
          "enum": [
            "BASIC_ACCOUNT_INFO",
            "TRANSACTIONS",
            "STATEMENTS",
            "HOLDINGS",
            "ACCOUNT_DETAILS",
            "TAX",
            "EBILLS",
            "FULL_ACCT_NUMBER",
            "BANK_TRANSFER_CODE",
            "HOLDER_NAME",
            "HOLDER_DETAILS",
            "PAYMENT_PROFILE",
            "PAYMENT_DETAILS",
            "INTEREST_DETAILS",
            "COVERAGE"
          ]
        }
      }
    },
    "Capability": {
      "title": "Capability",
      "type": "object",
      "properties": {
        "container": {
          "type": "array",
          "readOnly": true,
          "items": {
            "type": "string",
            "enum": [
              "bank",
              "creditCard",
              "investment",
              "insurance",
              "loan",
              "reward",
              "bill",
              "realEstate",
              "otherAssets",
              "otherLiabilities"
            ]
          }
        },
        "name": {
          "type": "string",
          "readOnly": true
        }
      }
    },
    "ContainerAttributes": {
      "title": "ContainerAttributes",
      "type": "object",
      "properties": {
        "BANK": {
          "$ref": "#/$defs/TransactionDays"
        },
        "LOAN": {
          "$ref": "#/$defs/TransactionDays"
        },
        "CREDITCARD": {
          "$ref": "#/$defs/TransactionDays"
        },
        "INVESTMENT": {
          "$ref": "#/$defs/TransactionDays"
        },
        "INSURANCE": {
          "$ref": "#/$defs/TransactionDays"
        }
      }
    },
    "Providers": {
      "title": "Providers",
      "type": "object",
      "properties": {
        "languageISOCode": {
          "type": "string",
          "description": "The language in which the provider details are provided. For example, a site supports two languages English and French. English being the primary language, the provider response will be provided in French depending on the user's locale. The language follows the two letter ISO code.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "forgetPasswordUrl": {
          "type": "string",
          "description": "The forget password URL of the provider site.<br><br><b>Endpoints</b>:<ul><li>GET providers</li></ul>",
          "readOnly": true
        },
        "PRIORITY": {
          "type": "string",
          "description": "Indicates the priority for which the service is invoked.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul><b>Applicable Values</b><br>",
          "readOnly": true,
          "enum": [
            "POPULAR",
            "SUGGESTED",
            "COBRAND",
            "SEARCH",
            "ALL"
          ]
        },
        "associatedProviderIds": {
          "type": "array",
          "description": "The screen-scraping providers that are associated to the Open Banking provider ID.<br><br><b>Applicable containers</b>: All Containers<br><b>Endpoints</b>:<ul><li>GET providers</li><li>GET providers/{providerId}</li></ul>",
          "readOnly": true,
          "items": {
            "type": "integer",
            "format": "int64"
          }
        },
        "loginHelp": {
          "type": "string",
          "description": "Help text to guide the user to choose the correct provider site.<br><br><b>Endpoints</b>:<ul><li>GET providers</li></ul>",
          "readOnly": true
        },
        "capability": {
          "type": "array",
          "description": "Capability of the site<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul><br><b>Note : </b> capability has been deprecated",
          "readOnly": true,
          "items": {
            "$ref": "#/$defs/Capability"
          }
        },
        "isConsentRequired": {
          "type": "boolean",
          "description": "Indicates if a provider site requires consent.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "loginUrl": {
          "type": "string",
          "description": "The login URL of the provider's site.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "isAutoRefreshEnabled": {
          "type": "boolean",
          "description": "Indicates if a provider site is auto-refreshed.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "logo": {
          "type": "string",
          "description": "The logo link of the provider institution. The link will return the logo in the PNG format.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "betaContainers": {
          "type": "array",
          "description": "This attribute will show the list of containers which are presently under development for the provider site and their link attempt may be unsuccessful<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true,
          "items": {
            "type": "string"
          }
        },
        "id": {
          "type": "integer",
          "description": "Unique identifier for the provider site(e.g., financial institution sites, biller sites, lender sites, etc.).<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "format": "int64",
          "readOnly": true
        },
        "authParameter": {
          "type": "array",
          "description": "AuthParameter appears in the response only in case of token-based aggregation sites.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true,
          "items": {
            "type": "string",
            "enum": [
              "authorizationCode",
              "idToken",
              "authResponse",
              "state"
            ]
          }
        },
        "authType": {
          "type": "string",
          "description": "The authentication type enabled at the provider site. <br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul><b>Applicable Values</b><br>",
          "readOnly": true,
          "enum": [
            "OAUTH",
            "CREDENTIALS",
            "MFA_CREDENTIALS"
          ]
        },
        "favicon": {
          "type": "string",
          "description": "Favicon link of the provider.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "accountType": {
          "type": "array",
          "description": "AccountType supported by the provider, eg: Brokerage Cash, Current<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true,
          "items": {
            "type": "string",
            "enum": [
              "CURRENT",
              "BROKERAGE_CASH"
            ]
          }
        },
        "countryISOCode": {
          "type": "string",
          "description": "Country to which the provider belongs.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "isAddedByUser": {
          "type": "string",
          "description": "Indicates that the site has been added by the user at least once.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "primaryLanguageISOCode": {
          "type": "string",
          "description": "The primary language of the site.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "help": {
          "type": "string",
          "description": "Text to guide user through linking an account that belongs to the site<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "baseUrl": {
          "type": "string",
          "description": "The base URL of the provider's site.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "name": {
          "type": "string",
          "description": "The name of a provider site.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "lastModified": {
          "type": "string",
          "description": "Determines when the provider information was updated by Yodlee. If the customer caches the data, the cache is recommended to be refreshed based on this field.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true
        },
        "dataset": {
          "type": "array",
          "description": "Logical grouping of dataset attributes into datasets such as Basic Aggregation Data, Account Profile and Documents<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true,
          "items": {
            "$ref": "#/$defs/ProvidersDataset"
          }
        },
        "status": {
          "type": "string",
          "description": "Determines if the provider is supported for the cobrand (customer), is in the beta stage, etc. <br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "readOnly": true,
          "enum": [
            "Supported",
            "Beta",
            "Unsupported"
          ]
        }
      }
    },
    "ProvidersDataset": {
      "title": "ProvidersDataset",
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "The name of the dataset requested from the provider site<br><br><b>Account Type</b>: Manual<br><b>Endpoints</b>:<ul><li>GET accounts</li><li>GET accounts/{accountId}</li><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET providers/{providerId}</li><li>GET providers</li></ul><b>Applicable Values</b><br>",
          "enum": [
            "BASIC_AGG_DATA",
            "ADVANCE_AGG_DATA",
            "ACCT_PROFILE",
            "DOCUMENT"
          ]
        },
        "attribute": {
          "type": "array",
          "description": "The name of the dataset attribute suported by the provider.<br><br><b>Endpoints</b>:<ul><li>GET providers/{providerId}</li><li>GET providers</li></ul>",
          "items": {
            "$ref": "#/$defs/Attribute"
          }
        }
      }
    },
    "TransactionDays": {
      "title": "TransactionDays",
      "type": "object",
      "properties": {
        "fullAccountNumberFields": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "paymentAccountNumber",
              "unmaskedAccountNumber"
            ]
          }
        },
        "numberOfTransactionDays": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}