Envestnet · Schema

UpdatedProviderAccount

FinancialWealth ManagementOpen BankingAccount Aggregation

Properties

Name Type Description
lastUpdated string Indicate when the providerAccount is last updated successfully.

Account Type: Aggregated
Endpoints:
  • GET dataExtracts/userData
loginForm array This entity gets returned in the response for only MFA based provider accounts during the add/update account polling process. This indicates that the MFA information is expected from the user to compl
createdDate string The date on when the provider account is created in the system.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
  • PUT providerAccounts/{providerAccountId}
aggregationSource string The source through which the providerAccount is added in the system.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
  • PUT providerAccounts/{providerAccountId}
oauthMigrationStatus string Indicates the migration status of the provider account from screen-scraping provider to the Open Banking provider.

Endpoints:
  • GET providerAccounts
  • GET providerAccounts/{p
providerId integer Unique identifier for the provider resource. This denotes the provider for which the provider account id is generated by the user.

Endpoints:
  • GET providerAccounts
  • POST pro
requestId string Unique id generated to indicate the request.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
  • PUT providerAccounts/{providerAccountId}
  • GET providerAcc
isManual boolean Indicates whether account is a manual or aggregated provider account.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
  • PUT providerAccounts/{providerAccountId
id integer Unique identifier for the provider account resource. This is created during account addition.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
  • PUT providerAcc
authType string The authentication type enabled at the provider site.

Endpoints:
  • GET providers/{providerId}
  • GET providers
Applicable Values
dataset array Logical grouping of dataset attributes into datasets such as Basic Aggregation Data, Account Profile and Documents.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
status string The status of last update attempted for the account.

Endpoints:
  • GET providerAccounts
  • POST providerAccounts
  • PUT providerAccounts/{providerAccountId}
  • GET pr
View JSON Schema on GitHub

JSON Schema

envestnet-updatedprovideraccount-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/UpdatedProviderAccount",
  "title": "UpdatedProviderAccount",
  "type": "object",
  "properties": {
    "lastUpdated": {
      "type": "string",
      "description": "Indicate when the providerAccount is last updated successfully.<br><br><b>Account Type</b>: Aggregated<br><b>Endpoints</b>:<ul><li>GET dataExtracts/userData</li></ul>",
      "readOnly": true
    },
    "loginForm": {
      "type": "array",
      "description": "This entity gets returned in the response for only MFA based provider accounts during the add/update account polling process. This indicates that the MFA information is expected from the user to complete the process. This represents the structure of MFA form that is displayed to the user in the provider site.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li></ul>",
      "readOnly": true,
      "items": {
        "$ref": "#/components/schemas/LoginForm"
      }
    },
    "createdDate": {
      "type": "string",
      "description": "The date on when the provider account is created in the system.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul>",
      "readOnly": true
    },
    "aggregationSource": {
      "type": "string",
      "description": "The source through which the providerAccount is added in the system.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul><b>Applicable Values</b><br>",
      "readOnly": true,
      "enum": [
        "SYSTEM",
        "USER"
      ]
    },
    "oauthMigrationStatus": {
      "type": "string",
      "description": "Indicates the migration status of the provider account from screen-scraping provider to the Open Banking provider. <br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>GET providerAccounts/{providerAccountId}</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul>",
      "readOnly": true,
      "enum": [
        "IN_PROGRESS",
        "TO_BE_MIGRATED",
        "COMPLETED",
        "MIGRATED"
      ]
    },
    "providerId": {
      "type": "integer",
      "description": "Unique identifier for the provider resource. This denotes the provider for which the provider account id is generated by the user.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul>",
      "format": "int64",
      "readOnly": true
    },
    "requestId": {
      "type": "string",
      "description": "Unique id generated to indicate the request.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li></ul>",
      "readOnly": true
    },
    "isManual": {
      "type": "boolean",
      "description": "Indicates whether account is a manual or aggregated provider account.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul>",
      "readOnly": true
    },
    "id": {
      "type": "integer",
      "description": "Unique identifier for the provider account resource. This is created during account addition.<br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul>",
      "format": "int64",
      "readOnly": true
    },
    "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"
      ]
    },
    "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 providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul>",
      "readOnly": true,
      "items": {
        "$ref": "#/components/schemas/AccountDataset"
      }
    },
    "status": {
      "type": "string",
      "description": "The status of last update attempted for the account. <br><br><b>Endpoints</b>:<ul><li>GET providerAccounts</li><li>POST providerAccounts</li><li>PUT providerAccounts/{providerAccountId}</li><li>GET providerAccounts/{providerAccountId}</li><li>GET dataExtracts/userData</li></ul><b>Applicable Values</b><br>",
      "readOnly": true,
      "enum": [
        "LOGIN_IN_PROGRESS",
        "USER_INPUT_REQUIRED",
        "IN_PROGRESS",
        "PARTIAL_SUCCESS",
        "SUCCESS",
        "FAILED",
        "MIGRATION_IN_PROGRESS",
        "DATA_RETRIEVAL_FAILED"
      ]
    }
  }
}