Webhooks

Arc can send webhooks for notable events. For example, this could include if a new statement is available or we notice a credential is now resulting in login failure.

To specify the webhook URL that you would like the events to be POSTed to, you can update it in the Dashboard from the Webhooks page on the Configuration dropdown or using this endpoint.

When sending a webhook, Arcadia looks for a 2xx response. If such a response is not received, Arcadia assumes that the webhook failed to deliver and the Arcadia platform will continue to attempting to send the webhook response three times every six hours for a total of one day (twelve automatic retries maximum). Each subsequent webhook attempt will have an identical message body.

There is an optional interactive boolean flag when creating new credentials. If this is set to true, a webhookUrl is required, and the system will emit Real-Time-Credential-Notification (RTCV) webhook notifications confirming REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS or REAL_TIME_CREDENTIAL_VALIDATION_FAILURE event types. This will also emit pending status notifications. These webhooks are only retried up to three times.

There are endpoints for viewing and resending the webhooks stored in the system here.

Webhook Payloads

The data object we return on the webhook response is the same data that is returned for that resource normally in the API. If your integration only needs that information, you can avoid making additional API calls to get the data.

For STATEMENT webhooks for both event type EXISTING_DATA_UPDATED and NEW_DATA_AVAILABLE webhooks, the data object in the webhook body will show the same values as what's returned from the summarized statement endpoint rather than the detailed statement endpoint.

Webhook Parameters

It is possible to optionally specify additional parameters that will be sent along with all webhooks. Namely, you can set the value of any custom headers or query parameters. This can be useful for authentication purposes to verify that a webhook is coming from Arcadia.

Currently, these values must be set by Arcadia internally and cannot be set via the API or Dashboard. To set up these values, please reach out to customer support via Zendesk and let them know what header name(s) and value(s) are required. The maximum length of the header name is 80 characters, and the maximum length of the header value is 255 characters. Both can only contain alphanumeric characters, as well as _ and - characters. The header value can additionally contain the special characters /, ., \, and ,. Spaces are not allowed.

See below for a complete list of webhook event types with example JSON payloads:

Webhooks Relevant for All Integrations

Event Type	Resource Types	Description
`STATUS_CHANGE`	`ACCOUNT` / `CREDENTIAL` / `FILE` / `DELETION` / `DOWNLOAD`	Arcadia will send this webhook for all status updatesAll status and status detail updates for Credentials, Accounts, Files, and Meters.
`EXISTING_DATA_UPDATED`	`STATEMENT`	Arcadia will send this webhook for any updates made to a statement that as already been discovered and stored. Generally, Arcadia updates existing statement data when there is a minor update to our data extraction logic. You can expect the statement ID and / or the uploaded bill ID for the statement to remain the same while the data will slightly change.
`NEW_DATA_AVAILABLE`	`STATEMENT`	Arcadia will send this webhook when a new statement has been discovered for the first time. You can expect to get the latest statement data after receiving this webhook. Arcadia considered adjustment statements to be new statements with their own new and unique statement ID.

Webhooks ONLY Relevant for Building Your Own "Connect"

Event Type	Resource Type	Description
`REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS`	`CREDENTIAL`	This webhook will only be sent for credentials that supports real time credential validation and `interactive` has been set to `true` in the POST Create Credential request. Arcadia has successfully logged into the utility account.
`REAL_TIME_CREDENTIAL_VALIDATION_FAILURE`	`CREDENTIAL`	This webhook will only be sent for credentials that supports real time credential validation and `interactive` has been set to `true` in the POST Create Credential request. Arcadia has failed to logged into the utility account.

Webhooks Exclusive to Interval Customers

Event Type	Resource Types	Description
`NEW_DATA_AVAILABLE`	`METER`	Arcadia will send this webhook when a new Meter has been discovered for the first time. Usually, the status will be `INTERVALS_NOT_REQUESTED` and interval extraction must be requested. In some circumstances, the status will be `INTERVALS_SUCCESS` and the `earliestIntervalAt` and `latestIntervalAt` fields will already be set.
`EXISTING_DATA_UPDATED`	`METER`	Arcadia will send this webhook when new interval data is available and the `earliestIntervalAt` or `latestIntervalAt` fields are updated.
`STATUS_CHANGE`	`METER`	Arcadia will send this webhook when the status field on a Meter changes. When changing to `INTERVALS_SUCCESS`, the `earliestIntervalAt` and `latestIntervalAt` fields will also be updated.

Webhook Notification Examples

👍
The resource embedded in the data field will be the same schema as the API response for an entity of the corresponding resource type in the resource field

STATUS_CHANGE

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_b2d4e1d1-3028-becd-1821-ff80aa8107f5",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_41428d0c-2804-ca52-e396-4ef9f30754cb",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_2929829f-375e-2133-492c-bc267d8f2cac",
  "resource" : "CREDENTIAL"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountNumber" : "8014539319811710193",
    "billingCycle" : "MONTHLY",
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "customData" : null,
    "firstExtractedAt" : "2024-02-21T00:00:00.000+00:00",
    "id" : "act_3463af21-32d8-786a-b2af-5028207bad7c",
    "isAccessible" : false,
    "isCustomerActionRequired" : false,
    "isHistoryFulfilled" : false,
    "isIntervalsThirdPartyPortalAccount" : false,
    "isStatementsProductActive" : true,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "lastSuccessfulStatementExtractionAt" : "2024-02-21T00:00:00.000+00:00",
    "latestNewStatementAt" : "2023-02-25T00:00:00.000+00:00",
    "latestStatementDate" : "2023-02-25",
    "nextExpectedPostDate" : "2023-03-27",
    "normalizedAccountNumber" : "8014539319811710193",
    "prepaid" : false,
    "provider" : {
      "country" : "USA",
      "id" : "prv_41428d0c-2804-ca52-e396-4ef9f30754cb",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "providerClassification" : "PUBLISHER",
    "serviceTypes" : [ ],
    "siteNames" : [ ],
    "status" : "NEW_ACCOUNT",
    "statusDetail" : "DATA_ACCESSIBLE",
    "summaryAccountId" : null,
    "summaryAccountNumber" : null,
    "type" : "NORMAL"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_31f611dc-9b20-a101-1278-9f6451e93e04",
  "resource" : "ACCOUNT"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountNumbers" : [ ],
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "fileName" : "example-file-name.pdf",
    "id" : "fil_53e41db0-a1a6-227d-dd28-573570cd1312",
    "isCustomerActionRequired" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : null,
    "statementDate" : null,
    "statementId" : null,
    "status" : "QUEUED",
    "statusDetails" : [ "READY_FOR_PROCESSING" ],
    "transferMethod" : "CLIENT"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_ac048490-6782-eb5d-a5f7-66752ea6fa4a",
  "resource" : "FILE"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountCount" : 5,
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "deletionTargetId" : "crd_7adde914-8db1-2209-4d35-0780c6395d15",
    "fileCount" : 0,
    "id" : "del_31706680-327f-9301-3a91-026940d08bb9",
    "meterCount" : 6,
    "siteCount" : 0,
    "statementCount" : 3,
    "status" : "SUCCESS"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_21cf258f-aa9c-aee1-09ac-5892aa330ae4",
  "resource" : "DELETION"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "downloadMethod" : "IN_BROWSER",
    "id" : "dwl_8ed41615-edd4-d81d-bf47-c4ef75edf0d8",
    "status" : "SUCCESS",
    "token" : "abcd"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_998729e3-6bb0-6c3c-32f1-8c9f71f7a3dd",
  "resource" : "DOWNLOAD"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accounts" : [ {
      "accountNumber" : "8014539319811710193",
      "id" : "act_3463af21-32d8-786a-b2af-5028207bad7c"
    } ],
    "bulbType" : null,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "currentTariff" : null,
    "customData" : null,
    "earliestIntervalAt" : "2024-01-22T00:00:00.000+00:00",
    "generalDescriptionAsPrinted" : null,
    "id" : "mtr_8d67f209-6a03-6ace-8662-406a4ea35c12",
    "isIntervalsProductActive" : true,
    "isIntervalsThirdPartyPortalMeter" : false,
    "isLocationRecommendationIgnored" : false,
    "isStandalone" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "latestIntervalAt" : "2024-02-20T00:00:00.000+00:00",
    "latestStatementDate" : null,
    "localTimezone" : "US/Eastern",
    "meterConstantMultiplier" : null,
    "meterNumber" : "4901758581957620031",
    "nextExpectedPostDate" : "2024-03-21",
    "normalizedMeterNumber" : "4901758581957620031",
    "normalizedPointOfDeliveryNumber" : "2",
    "pipeType" : null,
    "pointOfDeliveryNumber" : "2",
    "previousMeterConstantMultiplier" : null,
    "previousMeterNumber" : null,
    "provider" : null,
    "serviceAddress" : null,
    "serviceType" : "electric",
    "serviceTypeClassification" : "CORE",
    "site" : null,
    "status" : "INTERVALS_SUCCESS",
    "statusDetail" : "INTERVALS_AVAILABLE"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_83e52d15-b9a8-79ea-82d8-2c1b797119bd",
  "resource" : "METER"
}

NEW_DATA_AVAILABLE

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accounts" : [ {
      "accountNumber" : "7386149723027993238",
      "id" : "act_14604ba6-3cae-defb-98fe-da5e70071711"
    } ],
    "bulbType" : null,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "currentTariff" : null,
    "customData" : null,
    "earliestIntervalAt" : null,
    "generalDescriptionAsPrinted" : null,
    "id" : "mtr_e73c1d9c-4c6d-c46f-b638-88ae09f2d3bd",
    "isIntervalsProductActive" : false,
    "isIntervalsThirdPartyPortalMeter" : false,
    "isLocationRecommendationIgnored" : false,
    "isStandalone" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "latestIntervalAt" : null,
    "latestStatementDate" : null,
    "localTimezone" : null,
    "meterConstantMultiplier" : null,
    "meterNumber" : "7506082291392406726",
    "nextExpectedPostDate" : "2024-03-21",
    "normalizedMeterNumber" : "7506082291392406726",
    "normalizedPointOfDeliveryNumber" : "5",
    "pipeType" : null,
    "pointOfDeliveryNumber" : "5",
    "previousMeterConstantMultiplier" : null,
    "previousMeterNumber" : null,
    "provider" : null,
    "serviceAddress" : null,
    "serviceType" : "electric",
    "serviceTypeClassification" : "CORE",
    "site" : null,
    "status" : "INTERVALS_NOT_REQUESTED",
    "statusDetail" : "INTERVALS_EXTRACTION_NOT_REQUESTED"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_0fc5ded2-9f8c-8eaa-b228-b72ac9288d04",
  "resource" : "METER"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_14604ba6-3cae-defb-98fe-da5e70071711",
      "accountNumber" : "7386149723027993238",
      "amountDue" : 904.49,
      "dueDate" : "2023-08-16",
      "meterData" : [ {
        "amountDue" : 722.97,
        "currencyCode" : null,
        "meterId" : "mtr_77d93584-0323-5282-2764-29300da0aa49",
        "meterNumber" : "7136815129690974210",
        "meterReadDate" : "2023-08-02",
        "normalizedMeterNumber" : "7136815129690974210",
        "normalizedPointOfDeliveryNumber" : "19",
        "outstandingBalance" : 722.97,
        "pointOfDeliveryNumber" : "19",
        "previousReadDate" : "2023-07-03",
        "serviceType" : "electric",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 722.97,
        "totalUsage" : 616.09,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 181.52,
        "currencyCode" : null,
        "meterId" : "mtr_66c64339-7f20-4ea6-d4d0-83ad4c9b2f3e",
        "meterNumber" : "8655267574723884565",
        "meterReadDate" : "2023-08-02",
        "normalizedMeterNumber" : "8655267574723884565",
        "normalizedPointOfDeliveryNumber" : "17",
        "outstandingBalance" : 181.52,
        "pointOfDeliveryNumber" : "17",
        "previousReadDate" : "2023-07-03",
        "serviceType" : "natural_gas",
        "serviceTypeClassification" : "SUPPLEMENTAL",
        "totalCharges" : 181.52,
        "totalUsage" : 832.56,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "7386149723027993238",
      "outstandingBalance" : 904.49,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_2f574b92-e2e1-f016-d899-ae80dd274773",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_14604ba6-3cae-defb-98fe-da5e70071711"
      },
      "totalCharges" : 904.49
    } ],
    "amountDue" : 904.49,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-08-02T00:00:00.000+00:00",
    "dueDate" : "2023-08-16",
    "id" : "stm_ccab4b86-30e6-0eb2-08a0-5bb9b1dc1b2b",
    "invoiceNumber" : "433797395640647744",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 904.49,
    "periodEndDate" : "2023-08-02",
    "periodStartDate" : "2023-07-03",
    "provider" : {
      "country" : "USA",
      "id" : "prv_2f574b92-e2e1-f016-d899-ae80dd274773",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-08-02",
    "summaryAccountNumber" : null,
    "totalCharges" : 904.49,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_fccbd7af-551b-a386-2e6b-f32da2be2664",
  "resource" : "STATEMENT"
}

EXISTING_DATA_UPDATED

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_1ab5ca6f-0704-c97f-0e52-9bcca26ca335",
      "accountNumber" : "4793637900690404338",
      "amountDue" : 928.02,
      "dueDate" : "2023-04-27",
      "meterData" : [ {
        "amountDue" : 584.75,
        "currencyCode" : null,
        "meterId" : "mtr_77b63341-c922-aa37-1ad3-c2a91dea1965",
        "meterNumber" : "5719292822909213902",
        "meterReadDate" : "2023-04-13",
        "normalizedMeterNumber" : "5719292822909213902",
        "normalizedPointOfDeliveryNumber" : "3",
        "outstandingBalance" : 584.75,
        "pointOfDeliveryNumber" : "3",
        "previousReadDate" : "2023-03-14",
        "serviceType" : "lighting",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 584.75,
        "totalUsage" : 79.13,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 343.27,
        "currencyCode" : null,
        "meterId" : "mtr_997b48aa-c9b3-7563-e1fc-dcae21440cee",
        "meterNumber" : "8340561658891316534",
        "meterReadDate" : "2023-04-13",
        "normalizedMeterNumber" : "8340561658891316534",
        "normalizedPointOfDeliveryNumber" : "6",
        "outstandingBalance" : 343.27,
        "pointOfDeliveryNumber" : "6",
        "previousReadDate" : "2023-03-14",
        "serviceType" : "electric",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 343.27,
        "totalUsage" : 407.28,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "4793637900690404338",
      "outstandingBalance" : 928.02,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_2627a36a-1592-b76a-f996-cf5a68b7900c",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_1ab5ca6f-0704-c97f-0e52-9bcca26ca335"
      },
      "totalCharges" : 928.02
    } ],
    "amountDue" : 928.02,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-04-13T00:00:00.000+00:00",
    "dueDate" : "2023-04-27",
    "id" : "stm_73669928-4d0e-6fe1-41e7-eebc71c2299a",
    "invoiceNumber" : "6141747190362027993",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 928.02,
    "periodEndDate" : "2023-04-13",
    "periodStartDate" : "2023-03-14",
    "provider" : {
      "country" : "USA",
      "id" : "prv_2627a36a-1592-b76a-f996-cf5a68b7900c",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-04-13",
    "summaryAccountNumber" : null,
    "totalCharges" : 928.02,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "EXISTING_DATA_UPDATED",
  "id" : "whk_24bca8a2-1d58-e0c2-675e-521688c8d227",
  "resource" : "STATEMENT"
}

REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_c65e9551-3c73-5f5e-9e31-ebcb78999294",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_f0919a74-b84e-1388-3dce-23bce2f7db19",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS",
  "id" : "whk_53308bae-d9af-75af-b780-86d13c348d4d",
  "resource" : "CREDENTIAL"
}

REAL_TIME_CREDENTIAL_VALIDATION_FAILURE

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_a69fbae6-ce18-6527-58f1-71ceb933fffb",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_c829956e-40d3-675a-3636-53822907c00f",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "INVALID_CREDENTIALS",
    "totalAccounts" : 0,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_FAILURE",
  "id" : "whk_83d950f3-dcee-f62a-9688-aa0212c7650b",
  "resource" : "CREDENTIAL"
}

MFA_CHALLENGE_METHOD

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_bd967212-e4a7-a63a-4aa0-b7f5ac0608a6",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_995249bf-030e-21ca-2ac4-9565befa79c8",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 0,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "verificationMethods" : [ {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "text"
    }, {
      "identifier" : "2",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "email"
    } ]
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_METHOD",
  "id" : "whk_863a36ee-3e6e-296a-a9be-ad94dbc24831",
  "resource" : "MFA_METHOD_PROMPT"
}

MFA_CHALLENGE_CODE

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_5ab42908-c08f-260c-466c-49a3904a86eb",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_ba5b8226-3f62-723b-7eb7-f66e75b69f07",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 0,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_cd239080-2163-6767-8ad6-e808ded79978",
  "resource" : "MFA_CODE_PROMPT"
}

Example Scenarios

Successful RTCV Submission

Credentials submitted

Optionally, credential login event emitted:

📘
This is only emitted if the credential was submitted using "interactive": true,via this endpoint.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_7deecc71-d661-e518-25fe-100cc022ce54",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_5ce49928-4246-305b-6f4b-3b9c3922dda3",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS",
  "id" : "whk_343d5f9e-e67f-25ed-d5d6-48aa253e1af5",
  "resource" : "CREDENTIAL"
}

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_7deecc71-d661-e518-25fe-100cc022ce54",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_5ce49928-4246-305b-6f4b-3b9c3922dda3",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_3d5ee9ce-9b31-a965-0976-07c38b2ce3d1",
  "resource" : "CREDENTIAL"
}

Account(s) discovered

Account event(s) emitted (1 per account under the credential):

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountNumber" : "1895918663880278499",
    "billingCycle" : "MONTHLY",
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "customData" : null,
    "firstExtractedAt" : "2024-02-21T00:00:00.000+00:00",
    "id" : "act_c64bd4c2-d4af-6eac-3d12-9130456e92e8",
    "isAccessible" : true,
    "isCustomerActionRequired" : false,
    "isHistoryFulfilled" : false,
    "isIntervalsThirdPartyPortalAccount" : false,
    "isStatementsProductActive" : true,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "lastSuccessfulStatementExtractionAt" : "2024-02-21T00:00:00.000+00:00",
    "latestNewStatementAt" : "2023-01-12T00:00:00.000+00:00",
    "latestStatementDate" : "2023-01-12",
    "nextExpectedPostDate" : "2023-02-11",
    "normalizedAccountNumber" : "1895918663880278499",
    "prepaid" : false,
    "provider" : {
      "country" : "USA",
      "id" : "prv_5ce49928-4246-305b-6f4b-3b9c3922dda3",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "providerClassification" : "PUBLISHER",
    "serviceTypes" : [ {
      "serviceType" : "sewer",
      "serviceTypeClassification" : "CORE"
    } ],
    "siteNames" : [ ],
    "status" : "NEW_ACCOUNT",
    "statusDetail" : "DATA_ACCESSIBLE",
    "summaryAccountId" : null,
    "summaryAccountNumber" : null,
    "type" : "NORMAL"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_86cf8724-311c-28ad-c899-dfe3e9758365",
  "resource" : "ACCOUNT"
}

Statement(s) discovered

Statement event(s) emitted (1 per statement):

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_c64bd4c2-d4af-6eac-3d12-9130456e92e8",
      "accountNumber" : "1895918663880278499",
      "amountDue" : 94.99,
      "dueDate" : "2023-01-26",
      "meterData" : [ {
        "amountDue" : 94.99,
        "currencyCode" : null,
        "meterId" : "mtr_643a1f3d-3b4b-e5d8-125a-0d0772524b77",
        "meterNumber" : "7756787915682397831",
        "meterReadDate" : "2023-01-12",
        "normalizedMeterNumber" : "7756787915682397831",
        "normalizedPointOfDeliveryNumber" : "1",
        "outstandingBalance" : 94.99,
        "pointOfDeliveryNumber" : "1",
        "previousReadDate" : "2022-12-13",
        "serviceType" : "sewer",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 94.99,
        "totalUsage" : 619.85,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "1895918663880278499",
      "outstandingBalance" : 94.99,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_5ce49928-4246-305b-6f4b-3b9c3922dda3",
        "name" : "Example RTCV Provider",
        "publisherProviderAccountId" : "act_c64bd4c2-d4af-6eac-3d12-9130456e92e8"
      },
      "totalCharges" : 94.99
    } ],
    "amountDue" : 94.99,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-01-12T00:00:00.000+00:00",
    "dueDate" : "2023-01-26",
    "id" : "stm_7522f53b-4eeb-f549-b13f-1c79021835aa",
    "invoiceNumber" : "7898248729712635997",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 94.99,
    "periodEndDate" : "2023-01-12",
    "periodStartDate" : "2022-12-13",
    "provider" : {
      "country" : "USA",
      "id" : "prv_5ce49928-4246-305b-6f4b-3b9c3922dda3",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "statementDate" : "2023-01-12",
    "summaryAccountNumber" : null,
    "totalCharges" : 94.99,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_f3d43642-8506-84cc-ee7a-f98100c265e0",
  "resource" : "STATEMENT"
}

Unsuccessful RTCV Submission

Credentials submitted

Optionally, credential login event emitted:

📘
This is only emitted if the credential was submitted using "interactive": true,via this endpoint.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_03194ac2-aa4a-eec0-aa97-64521f067b8d",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_c8f5df44-8a06-4e7d-e308-d7b03374c9b6",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "INVALID_CREDENTIALS",
    "totalAccounts" : 0,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_FAILURE",
  "id" : "whk_3fba3873-1d17-65ce-d8a8-cb86df66a7bb",
  "resource" : "CREDENTIAL"
}

Credential failure or pending event emitted:

📘
A pending event indicates that the data extraction failed for a presumably temporary reason, such as the provider website being down.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_03194ac2-aa4a-eec0-aa97-64521f067b8d",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_c8f5df44-8a06-4e7d-e308-d7b03374c9b6",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "INVALID_CREDENTIALS",
    "totalAccounts" : 0,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_40275c3a-e5a5-67bb-c364-ec3cf350df50",
  "resource" : "CREDENTIAL"
}

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_03194ac2-aa4a-eec0-aa97-64521f067b8d",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_c8f5df44-8a06-4e7d-e308-d7b03374c9b6",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example RTCV Provider"
    },
    "status" : "CONNECTION_IN_PROGRESS",
    "statusDetail" : "PROVIDER_WEBSITE_INACCESSIBLE",
    "totalAccounts" : 0,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_862062e4-dafd-ec64-5d27-fd37be7658b2",
  "resource" : "CREDENTIAL"
}

Successful Non-RTCV Submission

Credentials submitted

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_f0dc4f28-c43e-8eb6-99a6-7d369b3ac933",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_3ac39cf2-fdcf-5efd-1d98-0840559258ab",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_2dbae494-c0e6-252d-52a8-75f722d856af",
  "resource" : "CREDENTIAL"
}

Account(s) discovered

Account event(s) emitted (1 per account under the credential):

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountNumber" : "7576455507737416278",
    "billingCycle" : "MONTHLY",
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "customData" : null,
    "firstExtractedAt" : "2024-02-21T00:00:00.000+00:00",
    "id" : "act_902dd85d-70df-b081-cf58-38688be32b72",
    "isAccessible" : true,
    "isCustomerActionRequired" : false,
    "isHistoryFulfilled" : false,
    "isIntervalsThirdPartyPortalAccount" : false,
    "isStatementsProductActive" : true,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "lastSuccessfulStatementExtractionAt" : "2024-02-21T00:00:00.000+00:00",
    "latestNewStatementAt" : "2023-03-25T00:00:00.000+00:00",
    "latestStatementDate" : "2023-03-25",
    "nextExpectedPostDate" : "2023-04-24",
    "normalizedAccountNumber" : "7576455507737416278",
    "prepaid" : false,
    "provider" : {
      "country" : "USA",
      "id" : "prv_3ac39cf2-fdcf-5efd-1d98-0840559258ab",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "providerClassification" : "PUBLISHER",
    "serviceTypes" : [ {
      "serviceType" : "natural_gas",
      "serviceTypeClassification" : "SUPPLEMENTAL"
    }, {
      "serviceType" : "sewer",
      "serviceTypeClassification" : "CORE"
    }, {
      "serviceType" : "water",
      "serviceTypeClassification" : "CORE"
    } ],
    "siteNames" : [ ],
    "status" : "NEW_ACCOUNT",
    "statusDetail" : "DATA_ACCESSIBLE",
    "summaryAccountId" : null,
    "summaryAccountNumber" : null,
    "type" : "NORMAL"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_2dc3cf84-8818-9d05-afbb-619fca4ad76b",
  "resource" : "ACCOUNT"
}

Statement(s) discovered

Statement event(s) emitted (1 per statement):

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_902dd85d-70df-b081-cf58-38688be32b72",
      "accountNumber" : "7576455507737416278",
      "amountDue" : 1497.94,
      "dueDate" : "2023-04-08",
      "meterData" : [ {
        "amountDue" : 968.16,
        "currencyCode" : null,
        "meterId" : "mtr_1f5386cb-9d30-6461-5369-07d661ad7cbc",
        "meterNumber" : "4664639014222704867",
        "meterReadDate" : "2023-03-25",
        "normalizedMeterNumber" : "4664639014222704867",
        "normalizedPointOfDeliveryNumber" : "11",
        "outstandingBalance" : 968.16,
        "pointOfDeliveryNumber" : "11",
        "previousReadDate" : "2023-02-23",
        "serviceType" : "water",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 968.16,
        "totalUsage" : 528.79,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 276.47,
        "currencyCode" : null,
        "meterId" : "mtr_28a2fba8-6edc-af3e-2f7e-16004b964d34",
        "meterNumber" : "1863179318419346427",
        "meterReadDate" : "2023-03-25",
        "normalizedMeterNumber" : "1863179318419346427",
        "normalizedPointOfDeliveryNumber" : "8",
        "outstandingBalance" : 276.47,
        "pointOfDeliveryNumber" : "8",
        "previousReadDate" : "2023-02-23",
        "serviceType" : "sewer",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 276.47,
        "totalUsage" : 248.46,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 253.31,
        "currencyCode" : null,
        "meterId" : "mtr_c6b47ca5-40e6-500b-199f-a171d729e2df",
        "meterNumber" : "4595038053400594296",
        "meterReadDate" : "2023-03-25",
        "normalizedMeterNumber" : "4595038053400594296",
        "normalizedPointOfDeliveryNumber" : "2",
        "outstandingBalance" : 253.31,
        "pointOfDeliveryNumber" : "2",
        "previousReadDate" : "2023-02-23",
        "serviceType" : "natural_gas",
        "serviceTypeClassification" : "SUPPLEMENTAL",
        "totalCharges" : 253.31,
        "totalUsage" : 366.47,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "7576455507737416278",
      "outstandingBalance" : 1497.94,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_3ac39cf2-fdcf-5efd-1d98-0840559258ab",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_902dd85d-70df-b081-cf58-38688be32b72"
      },
      "totalCharges" : 1497.94
    } ],
    "amountDue" : 1497.94,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-03-25T00:00:00.000+00:00",
    "dueDate" : "2023-04-08",
    "id" : "stm_ef833411-c92f-05bb-e0ee-68b92e6a176b",
    "invoiceNumber" : "2966062246545957826",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 1497.94,
    "periodEndDate" : "2023-03-25",
    "periodStartDate" : "2023-02-23",
    "provider" : {
      "country" : "USA",
      "id" : "prv_3ac39cf2-fdcf-5efd-1d98-0840559258ab",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-03-25",
    "summaryAccountNumber" : null,
    "totalCharges" : 1497.94,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_bafa28d3-6473-2be4-1b49-b17f0b5dbedd",
  "resource" : "STATEMENT"
}

Unsuccessful Non-RTCV Submission

Credentials submitted

Credential failure event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_e3cf8615-c199-27ca-e945-de73c2d4e859",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_e019cc24-8628-d363-1bce-6d0d5ee1687e",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "INVALID_CREDENTIALS",
    "totalAccounts" : 0,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_02743db5-7711-e955-d428-dea99ad7c135",
  "resource" : "CREDENTIAL"
}

Successful MFA Submission

Credentials submitted

📘
The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

MFA methods event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_4d6767b6-aebf-c867-fec8-80a934047735",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_a9a518b1-629c-f5e0-b6b6-5b74d0f5b28c",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "verificationMethods" : [ {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "text"
    }, {
      "identifier" : "2",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "email"
    } ]
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_METHOD",
  "id" : "whk_023245ff-46b6-5cc7-b820-ea53fe9e6473",
  "resource" : "MFA_METHOD_PROMPT"
}

Method is selected via this endpoint

One-time passcode event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_4d6767b6-aebf-c867-fec8-80a934047735",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_a9a518b1-629c-f5e0-b6b6-5b74d0f5b28c",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_a991106b-1df2-45ab-6e56-ebc8af9bf95a",
  "resource" : "MFA_CODE_PROMPT"
}

Correct one-time passcode is submitted via this endpoint

Credential login event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_4d6767b6-aebf-c867-fec8-80a934047735",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_a9a518b1-629c-f5e0-b6b6-5b74d0f5b28c",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS",
  "id" : "whk_33e6d992-6f96-ab28-a4b4-e8d5b039c333",
  "resource" : "CREDENTIAL"
}

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_4d6767b6-aebf-c867-fec8-80a934047735",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_a9a518b1-629c-f5e0-b6b6-5b74d0f5b28c",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_886a1611-d13e-e22f-5df3-890c869120d4",
  "resource" : "CREDENTIAL"
}

Normal data extraction proceeds

MFA submission with a reselected method

Credentials submitted

📘
The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

MFA methods event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_e27c29de-e8f2-cca4-2ccb-bd1dcf4af43f",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_3f3807b7-c8d6-2522-8024-98859aec0d2f",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "verificationMethods" : [ {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "text"
    }, {
      "identifier" : "2",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "email"
    } ]
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_METHOD",
  "id" : "whk_50aa6168-788a-dfc2-9f28-7c0fff142c54",
  "resource" : "MFA_METHOD_PROMPT"
}

Method is selected via this endpoint

One-time passcode event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_e27c29de-e8f2-cca4-2ccb-bd1dcf4af43f",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_3f3807b7-c8d6-2522-8024-98859aec0d2f",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_81b51875-1965-81ae-a7f7-5e3b39094e3c",
  "resource" : "MFA_CODE_PROMPT"
}

Method is reselected using "isResubmission": true via this endpoint

One-time passcode event is emitted with the newly selected method:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_e27c29de-e8f2-cca4-2ccb-bd1dcf4af43f",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_3f3807b7-c8d6-2522-8024-98859aec0d2f",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_e5b653bf-47a1-b09f-0f1d-b7df2a015d09",
  "resource" : "MFA_CODE_PROMPT"
}

Correct one-time passcode is submitted via this endpoint

Credential login event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_e27c29de-e8f2-cca4-2ccb-bd1dcf4af43f",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_3f3807b7-c8d6-2522-8024-98859aec0d2f",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS",
  "id" : "whk_8803b218-adc0-3ce2-695f-4eb58d48151d",
  "resource" : "CREDENTIAL"
}

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_e27c29de-e8f2-cca4-2ccb-bd1dcf4af43f",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_3f3807b7-c8d6-2522-8024-98859aec0d2f",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_7034d1ed-b4a5-319b-0d57-383ae2663678",
  "resource" : "CREDENTIAL"
}

Normal data extraction proceeds

MFA submission with an invalid one-time passcode

Credentials submitted

📘
The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

MFA methods event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_8f24d61a-e66c-5dd3-b817-52acbbb3838a",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_1fdddd7d-97a8-3806-5472-b348fb4b3ea5",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "verificationMethods" : [ {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "text"
    }, {
      "identifier" : "2",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "email"
    } ]
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_METHOD",
  "id" : "whk_31f35d15-e539-098d-02b4-a498a0515c55",
  "resource" : "MFA_METHOD_PROMPT"
}

Method is selected via this endpoint

One-time passcode event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_8f24d61a-e66c-5dd3-b817-52acbbb3838a",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_1fdddd7d-97a8-3806-5472-b348fb4b3ea5",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_83565ec0-0d29-b09d-3e41-0aae2eb54861",
  "resource" : "MFA_CODE_PROMPT"
}

Incorrect one-time passcode is submitted via this endpoint

One-time passcode event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_8f24d61a-e66c-5dd3-b817-52acbbb3838a",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_1fdddd7d-97a8-3806-5472-b348fb4b3ea5",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : true,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_e7d66d66-81b8-f73a-960b-6e7c4992b249",
  "resource" : "MFA_CODE_PROMPT"
}

Correct one-time passcode is submitted via this endpoint

Credential login event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_8f24d61a-e66c-5dd3-b817-52acbbb3838a",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_1fdddd7d-97a8-3806-5472-b348fb4b3ea5",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS",
  "id" : "whk_a8d93d1e-cb1e-09f2-f60c-797b0b1e76a2",
  "resource" : "CREDENTIAL"
}

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_8f24d61a-e66c-5dd3-b817-52acbbb3838a",
    "isAccessible" : true,
    "isActive" : true,
    "isCustomerActionRequired" : false,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_1fdddd7d-97a8-3806-5472-b348fb4b3ea5",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_SUCCESS",
    "statusDetail" : "LOGIN_AND_DATA_DISCOVERY_SUCCESS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_3e9fed31-cba5-0895-f3de-0ad3d7e4e3b2",
  "resource" : "CREDENTIAL"
}

Normal data extraction proceeds

MFA Failure

Credentials submitted

📘
The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

MFA methods event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_76a3a6af-f515-f683-a23c-764d6e9e917b",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_843b8007-785a-77f2-f14b-de2425e95c3a",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "verificationMethods" : [ {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "text"
    }, {
      "identifier" : "2",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "email"
    } ]
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_METHOD",
  "id" : "whk_ccdeaca5-0b38-6925-2f9e-d58b2c545ddc",
  "resource" : "MFA_METHOD_PROMPT"
}

Method is selected via this endpoint

One-time passcode event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_76a3a6af-f515-f683-a23c-764d6e9e917b",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_843b8007-785a-77f2-f14b-de2425e95c3a",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_e785c0a4-d2de-2b73-3b39-493272ddc378",
  "resource" : "MFA_CODE_PROMPT"
}

Incorrect one-time passcode is submitted via this endpoint

One-time passcode event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_76a3a6af-f515-f683-a23c-764d6e9e917b",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_843b8007-785a-77f2-f14b-de2425e95c3a",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : true,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_d1db178d-62c8-11d0-c17c-2ecfaf907a9a",
  "resource" : "MFA_CODE_PROMPT"
}

Terminal failure state is reached on the provider's website, such as through too many resubmissions

Credential login failure event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_76a3a6af-f515-f683-a23c-764d6e9e917b",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_843b8007-785a-77f2-f14b-de2425e95c3a",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "MULTI_FACTOR_AUTHENTICATION_FAILURE",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_FAILURE",
  "id" : "whk_a5a6d424-604d-9788-1427-f29b68d6df0e",
  "resource" : "CREDENTIAL"
}

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_76a3a6af-f515-f683-a23c-764d6e9e917b",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_843b8007-785a-77f2-f14b-de2425e95c3a",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "MULTI_FACTOR_AUTHENTICATION_FAILURE",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_2daa91c2-dbf0-7dd4-20fb-6145276f50ed",
  "resource" : "CREDENTIAL"
}

MFA Timeout

Credentials submitted

📘
The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

MFA methods event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_85254fa1-9cba-4b7b-4e20-e25d9b1c0fb8",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_509fe288-b16e-be82-9cc4-280f2776fddb",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "verificationMethods" : [ {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "text"
    }, {
      "identifier" : "2",
      "isResubmission" : false,
      "name" : "********@gmail.com",
      "type" : "email"
    } ]
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_METHOD",
  "id" : "whk_6d200e7d-769f-197b-9a8d-94a9bcafb8d1",
  "resource" : "MFA_METHOD_PROMPT"
}

Method is selected via this endpoint

One-time passcode event is emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "credential" : {
      "correlationId" : "example-correlation-id",
      "createdAt" : "2024-02-21T00:00:00.000+00:00",
      "createdBy" : "[email protected]",
      "id" : "crd_85254fa1-9cba-4b7b-4e20-e25d9b1c0fb8",
      "isAccessible" : true,
      "isActive" : true,
      "isCustomerActionRequired" : false,
      "isThirdPartyPortal" : false,
      "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
      "lastModifiedBy" : "[email protected]",
      "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
      "provider" : {
        "country" : "USA",
        "id" : "prv_509fe288-b16e-be82-9cc4-280f2776fddb",
        "isIntervalDataSupported" : true,
        "isRealTimeCredentialValidationSupported" : true,
        "name" : "Example MFA Provider"
      },
      "status" : "CONNECTION_IN_PROGRESS",
      "statusDetail" : "DATA_EXTRACTION_IN_PROGRESS",
      "totalAccounts" : 1,
      "username" : "example-username",
      "username2" : null,
      "username3" : null,
      "username4" : null,
      "website" : "https://example.provider.site"
    },
    "isResubmission" : false,
    "selectedVerificationMethod" : {
      "identifier" : "1",
      "isResubmission" : false,
      "name" : "***-***-1234",
      "type" : "other"
    }
  },
  "errors" : [ ],
  "eventType" : "MFA_CHALLENGE_CODE",
  "id" : "whk_9a464485-9dea-f5e6-e321-bc178b8b8e5e",
  "resource" : "MFA_CODE_PROMPT"
}

No code is submitted and the job times out

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_85254fa1-9cba-4b7b-4e20-e25d9b1c0fb8",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_509fe288-b16e-be82-9cc4-280f2776fddb",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "MULTI_FACTOR_AUTHENTICATION_TIMEOUT",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "REAL_TIME_CREDENTIAL_VALIDATION_FAILURE",
  "id" : "whk_49d1a38a-d7e7-b395-4e3b-32371e0c2eac",
  "resource" : "CREDENTIAL"
}

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

Credential event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_85254fa1-9cba-4b7b-4e20-e25d9b1c0fb8",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_509fe288-b16e-be82-9cc4-280f2776fddb",
      "isIntervalDataSupported" : true,
      "isRealTimeCredentialValidationSupported" : true,
      "name" : "Example MFA Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "MULTI_FACTOR_AUTHENTICATION_TIMEOUT",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_d633f191-bab5-70d8-4c47-476da2121025",
  "resource" : "CREDENTIAL"
}

Existing Credential Stops Working

Credential login fails

Credential failure event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "id" : "crd_46106989-b814-3372-f36a-fe386b7fa139",
    "isAccessible" : false,
    "isActive" : true,
    "isCustomerActionRequired" : true,
    "isThirdPartyPortal" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "[email protected]",
    "nextScheduledAccountRunAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : {
      "country" : "USA",
      "id" : "prv_cffcbe6a-f19c-8c00-9483-70228911897b",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "status" : "CONNECTION_FAILURE",
    "statusDetail" : "INVALID_CREDENTIALS",
    "totalAccounts" : 1,
    "username" : "example-username",
    "username2" : null,
    "username3" : null,
    "username4" : null,
    "website" : "https://example.provider.site"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_451ce74a-af62-2d6d-5232-24bbe9d45b30",
  "resource" : "CREDENTIAL"
}

New Statement Discovered Under Existing Credential

Statement discovered

Statement event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_12d33414-ce21-d956-7d20-4b562f364b12",
      "accountNumber" : "7215449184058699685",
      "amountDue" : 779.44,
      "dueDate" : "2023-08-09",
      "meterData" : [ {
        "amountDue" : 366.04,
        "currencyCode" : null,
        "meterId" : "mtr_ea158d3f-5fbd-70f6-983e-0a2c3f3eafe6",
        "meterNumber" : "7181943107793344407",
        "meterReadDate" : "2023-07-26",
        "normalizedMeterNumber" : "7181943107793344407",
        "normalizedPointOfDeliveryNumber" : "",
        "outstandingBalance" : 366.04,
        "pointOfDeliveryNumber" : "0",
        "previousReadDate" : "2023-06-26",
        "serviceType" : "sewer",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 366.04,
        "totalUsage" : 433.99,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 413.4,
        "currencyCode" : null,
        "meterId" : "mtr_b5dba23c-da3f-01b6-2944-96d2db8e578c",
        "meterNumber" : "3039948589331040444",
        "meterReadDate" : "2023-07-26",
        "normalizedMeterNumber" : "3039948589331040444",
        "normalizedPointOfDeliveryNumber" : "18",
        "outstandingBalance" : 413.4,
        "pointOfDeliveryNumber" : "18",
        "previousReadDate" : "2023-06-26",
        "serviceType" : "water",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 413.4,
        "totalUsage" : 739.61,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "7215449184058699685",
      "outstandingBalance" : 779.44,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_866c1681-7cb5-c5cc-6ae6-04c37af5faa7",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_12d33414-ce21-d956-7d20-4b562f364b12"
      },
      "totalCharges" : 779.44
    } ],
    "amountDue" : 779.44,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-07-26T00:00:00.000+00:00",
    "dueDate" : "2023-08-09",
    "id" : "stm_e1671504-66b7-6704-62fd-719d6adbdefb",
    "invoiceNumber" : "7404192942646079470",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 779.44,
    "periodEndDate" : "2023-07-26",
    "periodStartDate" : "2023-06-26",
    "provider" : {
      "country" : "USA",
      "id" : "prv_866c1681-7cb5-c5cc-6ae6-04c37af5faa7",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-07-26",
    "summaryAccountNumber" : null,
    "totalCharges" : 779.44,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_3a6311ce-0129-5b03-f9e0-990f51a969ee",
  "resource" : "STATEMENT"
}

Statement Data Changed

Statement discovered

Statement event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_0e0a37df-22f8-c274-fa14-fb460ff80328",
      "accountNumber" : "7076361810871725721",
      "amountDue" : 1831.85,
      "dueDate" : "2023-06-26",
      "meterData" : [ {
        "amountDue" : 676.98,
        "currencyCode" : null,
        "meterId" : "mtr_f778d9b9-e7d6-1233-5c72-8b52673a8ecf",
        "meterNumber" : "5165279498334801692",
        "meterReadDate" : "2023-06-12",
        "normalizedMeterNumber" : "5165279498334801692",
        "normalizedPointOfDeliveryNumber" : "9",
        "outstandingBalance" : 676.98,
        "pointOfDeliveryNumber" : "9",
        "previousReadDate" : "2023-05-13",
        "serviceType" : "electric",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 676.98,
        "totalUsage" : 500.86,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 169.54,
        "currencyCode" : null,
        "meterId" : "mtr_a32a7089-784d-25fd-9aff-b9348e535588",
        "meterNumber" : "2894974284730264849",
        "meterReadDate" : "2023-06-12",
        "normalizedMeterNumber" : "2894974284730264849",
        "normalizedPointOfDeliveryNumber" : "11",
        "outstandingBalance" : 169.54,
        "pointOfDeliveryNumber" : "11",
        "previousReadDate" : "2023-05-13",
        "serviceType" : "water",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 169.54,
        "totalUsage" : 613.42,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 985.33,
        "currencyCode" : null,
        "meterId" : "mtr_083816ba-5445-9f3f-f3c4-97dd58ada8c5",
        "meterNumber" : "4376309375376958595",
        "meterReadDate" : "2023-06-12",
        "normalizedMeterNumber" : "4376309375376958595",
        "normalizedPointOfDeliveryNumber" : "",
        "outstandingBalance" : 985.33,
        "pointOfDeliveryNumber" : "0",
        "previousReadDate" : "2023-05-13",
        "serviceType" : "sewer",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 985.33,
        "totalUsage" : 963.94,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "7076361810871725721",
      "outstandingBalance" : 1831.85,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_2f22b8fd-2c45-2ddb-5f9e-d7296f4b4aeb",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_0e0a37df-22f8-c274-fa14-fb460ff80328"
      },
      "totalCharges" : 1831.85
    } ],
    "amountDue" : 1831.85,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-06-12T00:00:00.000+00:00",
    "dueDate" : "2023-06-26",
    "id" : "stm_b2c8687e-6168-85b2-ded9-bf811d71632a",
    "invoiceNumber" : "5697331843487400042",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 1831.85,
    "periodEndDate" : "2023-06-12",
    "periodStartDate" : "2023-05-13",
    "provider" : {
      "country" : "USA",
      "id" : "prv_2f22b8fd-2c45-2ddb-5f9e-d7296f4b4aeb",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-06-12",
    "summaryAccountNumber" : null,
    "totalCharges" : 1831.85,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_d37a5e16-b4fe-8a8d-292c-82461796ae78",
  "resource" : "STATEMENT"
}

Much later, Arcadia's data extraction for the provider is updated
Extracted statement data changes

Modified statement event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_0e0a37df-22f8-c274-fa14-fb460ff80328",
      "accountNumber" : "7076361810871725721",
      "amountDue" : 1831.85,
      "dueDate" : "2023-06-26",
      "meterData" : [ {
        "amountDue" : 676.98,
        "currencyCode" : null,
        "meterId" : "mtr_f778d9b9-e7d6-1233-5c72-8b52673a8ecf",
        "meterNumber" : "5165279498334801692",
        "meterReadDate" : "2023-06-12",
        "normalizedMeterNumber" : "5165279498334801692",
        "normalizedPointOfDeliveryNumber" : "9",
        "outstandingBalance" : 676.98,
        "pointOfDeliveryNumber" : "9",
        "previousReadDate" : "2023-05-13",
        "serviceType" : "electric",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 676.98,
        "totalUsage" : 500.86,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 169.54,
        "currencyCode" : null,
        "meterId" : "mtr_a32a7089-784d-25fd-9aff-b9348e535588",
        "meterNumber" : "2894974284730264849",
        "meterReadDate" : "2023-06-12",
        "normalizedMeterNumber" : "2894974284730264849",
        "normalizedPointOfDeliveryNumber" : "11",
        "outstandingBalance" : 169.54,
        "pointOfDeliveryNumber" : "11",
        "previousReadDate" : "2023-05-13",
        "serviceType" : "water",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 169.54,
        "totalUsage" : 613.42,
        "totalUsageUnit" : "kWh"
      }, {
        "amountDue" : 985.33,
        "currencyCode" : null,
        "meterId" : "mtr_083816ba-5445-9f3f-f3c4-97dd58ada8c5",
        "meterNumber" : "4376309375376958595",
        "meterReadDate" : "2023-06-12",
        "normalizedMeterNumber" : "4376309375376958595",
        "normalizedPointOfDeliveryNumber" : "",
        "outstandingBalance" : 985.33,
        "pointOfDeliveryNumber" : "0",
        "previousReadDate" : "2023-05-13",
        "serviceType" : "sewer",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 985.33,
        "totalUsage" : 963.94,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "7076361810871725721",
      "outstandingBalance" : 1831.85,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_2f22b8fd-2c45-2ddb-5f9e-d7296f4b4aeb",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_0e0a37df-22f8-c274-fa14-fb460ff80328"
      },
      "totalCharges" : 1831.85
    } ],
    "amountDue" : 1831.85,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "UTILITY_WEBSITE_ACCESS",
    "discoveredAt" : "2023-06-12T00:00:00.000+00:00",
    "dueDate" : "2023-07-03",
    "id" : "stm_b2c8687e-6168-85b2-ded9-bf811d71632a",
    "invoiceNumber" : "5697331843487400042",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 1831.85,
    "periodEndDate" : "2023-06-12",
    "periodStartDate" : "2023-05-13",
    "provider" : {
      "country" : "USA",
      "id" : "prv_2f22b8fd-2c45-2ddb-5f9e-d7296f4b4aeb",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-06-12",
    "summaryAccountNumber" : null,
    "totalCharges" : 1831.85,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "EXISTING_DATA_UPDATED",
  "id" : "whk_ee80e4d1-8456-c3ec-2fd2-c4bd502a821c",
  "resource" : "STATEMENT"
}

Account Created Via File Upload

Account discovered

Account event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountNumber" : "7133186537817515231",
    "billingCycle" : "MONTHLY",
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "customData" : null,
    "firstExtractedAt" : "2024-02-21T00:00:00.000+00:00",
    "id" : "act_7855fd0f-3107-54d5-47db-8740344d9cde",
    "isAccessible" : false,
    "isCustomerActionRequired" : false,
    "isHistoryFulfilled" : false,
    "isIntervalsThirdPartyPortalAccount" : false,
    "isStatementsProductActive" : true,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "lastSuccessfulStatementExtractionAt" : "2024-02-21T00:00:00.000+00:00",
    "latestNewStatementAt" : "2023-10-03T00:00:00.000+00:00",
    "latestStatementDate" : "2023-10-03",
    "nextExpectedPostDate" : "2023-11-02",
    "normalizedAccountNumber" : "7133186537817515231",
    "prepaid" : false,
    "provider" : {
      "country" : "USA",
      "id" : "prv_746a3349-3c5c-4020-23a9-39db1d094027",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "providerClassification" : "PUBLISHER",
    "serviceTypes" : [ {
      "serviceType" : "irrigation",
      "serviceTypeClassification" : "CORE"
    } ],
    "siteNames" : [ ],
    "status" : "NEW_ACCOUNT",
    "statusDetail" : "DATA_ACCESSIBLE",
    "summaryAccountId" : null,
    "summaryAccountNumber" : null,
    "type" : "NORMAL"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_9b9ee649-f4c7-e4a2-49c0-5553016e4d53",
  "resource" : "ACCOUNT"
}

Statement discovered

Statement event emitted (1 per file uploaded):

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountData" : [ {
      "accountId" : "act_7855fd0f-3107-54d5-47db-8740344d9cde",
      "accountNumber" : "7133186537817515231",
      "amountDue" : 848.27,
      "dueDate" : "2023-10-17",
      "meterData" : [ {
        "amountDue" : 848.27,
        "currencyCode" : null,
        "meterId" : "mtr_df36f04c-f3d9-1b9d-1685-df0a97dd1382",
        "meterNumber" : "7480247849593930039",
        "meterReadDate" : "2023-10-03",
        "normalizedMeterNumber" : "7480247849593930039",
        "normalizedPointOfDeliveryNumber" : "15",
        "outstandingBalance" : 848.27,
        "pointOfDeliveryNumber" : "15",
        "previousReadDate" : "2023-09-03",
        "serviceType" : "irrigation",
        "serviceTypeClassification" : "CORE",
        "totalCharges" : 848.27,
        "totalUsage" : 139.22,
        "totalUsageUnit" : "kWh"
      } ],
      "normalizedAccountNumber" : "7133186537817515231",
      "outstandingBalance" : 848.27,
      "provider" : {
        "classification" : "PUBLISHER",
        "id" : "prv_746a3349-3c5c-4020-23a9-39db1d094027",
        "name" : "Example Non-RTCV Provider",
        "publisherProviderAccountId" : "act_7855fd0f-3107-54d5-47db-8740344d9cde"
      },
      "totalCharges" : 848.27
    } ],
    "amountDue" : 848.27,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "currencyCode" : null,
    "dataIngestionMethod" : "BILL_UPLOAD",
    "discoveredAt" : "2023-10-03T00:00:00.000+00:00",
    "dueDate" : "2023-10-17",
    "id" : "stm_9eeba4c4-72af-fd35-c9d2-633ab75a91c1",
    "invoiceNumber" : "2286532497450430865",
    "normalizedSummaryAccountNumber" : null,
    "outstandingBalance" : 848.27,
    "periodEndDate" : "2023-10-03",
    "periodStartDate" : "2023-09-03",
    "provider" : {
      "country" : "USA",
      "id" : "prv_746a3349-3c5c-4020-23a9-39db1d094027",
      "isIntervalDataSupported" : false,
      "isRealTimeCredentialValidationSupported" : false,
      "name" : "Example Non-RTCV Provider"
    },
    "statementDate" : "2023-10-03",
    "summaryAccountNumber" : null,
    "totalCharges" : 848.27,
    "type" : "BILL"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_34714db9-9e5b-0d1c-cc35-086d7e9a3956",
  "resource" : "STATEMENT"
}

File Data Extraction Fails

File is uploaded
File reviewed and unable to extract data

File failure event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountNumbers" : [ ],
    "correlationId" : "example-correlation-id",
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "fileName" : "example-file-name.pdf",
    "id" : "fil_7cf801a5-b023-36a6-6aad-7dcd0d195c5e",
    "isCustomerActionRequired" : true,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "provider" : null,
    "statementDate" : null,
    "statementId" : null,
    "status" : "FAILURE",
    "statusDetails" : [ "TIMED_OUT" ],
    "transferMethod" : "CLIENT"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_bc295e82-1fc7-f33a-aec3-ab6741adfffc",
  "resource" : "FILE"
}

Deletion Successful

Deletion is scheduled via deletion log
Deletion is performed

Deletion successful event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accountCount" : 4,
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "[email protected]",
    "deletionTargetId" : "crd_76ff6af4-6228-5be7-ac97-a3cbd0b7c43d",
    "fileCount" : 0,
    "id" : "del_24a64cfd-a75c-a8b0-5e7c-1c99699306c9",
    "meterCount" : 3,
    "siteCount" : 0,
    "statementCount" : 6,
    "status" : "SUCCESS"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_d25254e0-189e-5f1b-e5a5-da9f045a246c",
  "resource" : "DELETION"
}

Download Ready

Download is requested
Download is prepared

Download status change event emitted:

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "downloadMethod" : "IN_BROWSER",
    "id" : "dwl_26539b9e-6cd9-b5a3-6c73-3e93ae2c9024",
    "status" : "SUCCESS",
    "token" : "abcd"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_99645bca-33be-130a-eee0-ef251422e78b",
  "resource" : "DOWNLOAD"
}

Interval Data Extraction

Credentials are submitted and a Meter is discovered.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accounts" : [ {
      "accountNumber" : "9207594868129984194",
      "id" : "act_6f3a89ac-baa1-9f90-8be2-5dcc738538d2"
    } ],
    "bulbType" : null,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "currentTariff" : null,
    "customData" : null,
    "earliestIntervalAt" : null,
    "generalDescriptionAsPrinted" : null,
    "id" : "mtr_8f5cb53a-7567-586f-8f31-5d288ed4648f",
    "isIntervalsProductActive" : false,
    "isIntervalsThirdPartyPortalMeter" : false,
    "isLocationRecommendationIgnored" : false,
    "isStandalone" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "latestIntervalAt" : null,
    "latestStatementDate" : null,
    "localTimezone" : null,
    "meterConstantMultiplier" : null,
    "meterNumber" : "4824865146641708423",
    "nextExpectedPostDate" : "2024-03-21",
    "normalizedMeterNumber" : "4824865146641708423",
    "normalizedPointOfDeliveryNumber" : "4",
    "pipeType" : null,
    "pointOfDeliveryNumber" : "4",
    "previousMeterConstantMultiplier" : null,
    "previousMeterNumber" : null,
    "provider" : null,
    "serviceAddress" : null,
    "serviceType" : "electric",
    "serviceTypeClassification" : "CORE",
    "site" : null,
    "status" : "INTERVALS_NOT_REQUESTED",
    "statusDetail" : "INTERVALS_EXTRACTION_NOT_REQUESTED"
  },
  "errors" : [ ],
  "eventType" : "NEW_DATA_AVAILABLE",
  "id" : "whk_399e0929-3452-496c-ae2c-301017a5b0f4",
  "resource" : "METER"
}

Customer uses the Dashboard or API to request interval extraction for the Meter.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accounts" : [ {
      "accountNumber" : "9207594868129984194",
      "id" : "act_6f3a89ac-baa1-9f90-8be2-5dcc738538d2"
    } ],
    "bulbType" : null,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "currentTariff" : null,
    "customData" : null,
    "earliestIntervalAt" : null,
    "generalDescriptionAsPrinted" : null,
    "id" : "mtr_8f5cb53a-7567-586f-8f31-5d288ed4648f",
    "isIntervalsProductActive" : false,
    "isIntervalsThirdPartyPortalMeter" : false,
    "isLocationRecommendationIgnored" : false,
    "isStandalone" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "latestIntervalAt" : null,
    "latestStatementDate" : null,
    "localTimezone" : null,
    "meterConstantMultiplier" : null,
    "meterNumber" : "4824865146641708423",
    "nextExpectedPostDate" : "2024-03-21",
    "normalizedMeterNumber" : "4824865146641708423",
    "normalizedPointOfDeliveryNumber" : "4",
    "pipeType" : null,
    "pointOfDeliveryNumber" : "4",
    "previousMeterConstantMultiplier" : null,
    "previousMeterNumber" : null,
    "provider" : null,
    "serviceAddress" : null,
    "serviceType" : "electric",
    "serviceTypeClassification" : "CORE",
    "site" : null,
    "status" : "INTERVALS_IN_PROGRESS",
    "statusDetail" : "INTERVALS_EXTRACTION_IN_PROGRESS"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_dcc9fcab-7f2f-dba9-7b3d-5adc72891343",
  "resource" : "METER"
}

The first interval extraction finishes and the data is available.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accounts" : [ {
      "accountNumber" : "9207594868129984194",
      "id" : "act_6f3a89ac-baa1-9f90-8be2-5dcc738538d2"
    } ],
    "bulbType" : null,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "currentTariff" : null,
    "customData" : null,
    "earliestIntervalAt" : "2024-01-22T00:00:00.000+00:00",
    "generalDescriptionAsPrinted" : null,
    "id" : "mtr_8f5cb53a-7567-586f-8f31-5d288ed4648f",
    "isIntervalsProductActive" : true,
    "isIntervalsThirdPartyPortalMeter" : false,
    "isLocationRecommendationIgnored" : false,
    "isStandalone" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "latestIntervalAt" : "2024-02-20T00:00:00.000+00:00",
    "latestStatementDate" : null,
    "localTimezone" : "US/Eastern",
    "meterConstantMultiplier" : null,
    "meterNumber" : "4824865146641708423",
    "nextExpectedPostDate" : "2024-03-21",
    "normalizedMeterNumber" : "4824865146641708423",
    "normalizedPointOfDeliveryNumber" : "4",
    "pipeType" : null,
    "pointOfDeliveryNumber" : "4",
    "previousMeterConstantMultiplier" : null,
    "previousMeterNumber" : null,
    "provider" : null,
    "serviceAddress" : null,
    "serviceType" : "electric",
    "serviceTypeClassification" : "CORE",
    "site" : null,
    "status" : "INTERVALS_SUCCESS",
    "statusDetail" : "INTERVALS_AVAILABLE"
  },
  "errors" : [ ],
  "eventType" : "STATUS_CHANGE",
  "id" : "whk_c483662c-f525-4277-a579-70c2554d46f4",
  "resource" : "METER"
}

Time passes and a scheduled interval extraction occurs. The status does not change, but existing data is updated.

{
  "createdAt" : "2024-02-21T00:00:00.000+00:00",
  "data" : {
    "accounts" : [ {
      "accountNumber" : "9207594868129984194",
      "id" : "act_6f3a89ac-baa1-9f90-8be2-5dcc738538d2"
    } ],
    "bulbType" : null,
    "correlationIds" : [ "example-correlation-id" ],
    "createdAt" : "2024-02-21T00:00:00.000+00:00",
    "createdBy" : "system",
    "currentTariff" : null,
    "customData" : null,
    "earliestIntervalAt" : "2024-01-22T00:00:00.000+00:00",
    "generalDescriptionAsPrinted" : null,
    "id" : "mtr_8f5cb53a-7567-586f-8f31-5d288ed4648f",
    "isIntervalsProductActive" : true,
    "isIntervalsThirdPartyPortalMeter" : false,
    "isLocationRecommendationIgnored" : false,
    "isStandalone" : false,
    "lastModifiedAt" : "2024-02-21T00:00:00.000+00:00",
    "lastModifiedBy" : "system",
    "latestIntervalAt" : "2024-03-21T00:00:00.000+00:00",
    "latestStatementDate" : null,
    "localTimezone" : "US/Eastern",
    "meterConstantMultiplier" : null,
    "meterNumber" : "4824865146641708423",
    "nextExpectedPostDate" : "2024-03-21",
    "normalizedMeterNumber" : "4824865146641708423",
    "normalizedPointOfDeliveryNumber" : "4",
    "pipeType" : null,
    "pointOfDeliveryNumber" : "4",
    "previousMeterConstantMultiplier" : null,
    "previousMeterNumber" : null,
    "provider" : null,
    "serviceAddress" : null,
    "serviceType" : "electric",
    "serviceTypeClassification" : "CORE",
    "site" : null,
    "status" : "INTERVALS_SUCCESS",
    "statusDetail" : "INTERVALS_AVAILABLE"
  },
  "errors" : [ ],
  "eventType" : "EXISTING_DATA_UPDATED",
  "id" : "whk_c553e611-8ede-2c8d-a3eb-94b967d96d11",
  "resource" : "METER"
}

Webhook Payloads

Webhook Parameters

Webhooks Relevant for All Integrations

Webhooks ONLY Relevant for Building Your Own "Connect"

Webhooks Exclusive to Interval Customers

Webhook Notification Examples

👍The resource embedded in the data field will be the same schema as the API response for an entity of the corresponding resource type in the resource field

STATUS_CHANGE

NEW_DATA_AVAILABLE

EXISTING_DATA_UPDATED

REAL_TIME_CREDENTIAL_VALIDATION_SUCCESS

REAL_TIME_CREDENTIAL_VALIDATION_FAILURE

MFA_CHALLENGE_METHOD

MFA_CHALLENGE_CODE

Example Scenarios

Successful RTCV Submission

📘This is only emitted if the credential was submitted using "interactive": true,via this endpoint.

Unsuccessful RTCV Submission

📘This is only emitted if the credential was submitted using "interactive": true,via this endpoint.

📘A pending event indicates that the data extraction failed for a presumably temporary reason, such as the provider website being down.

Successful Non-RTCV Submission

Unsuccessful Non-RTCV Submission

Successful MFA Submission

📘The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

📘The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

MFA submission with a reselected method

📘The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

📘The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

MFA submission with an invalid one-time passcode

📘The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

📘The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

MFA Failure

📘The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

📘The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

MFA Timeout

📘The following events are only emitted if the credential was submitted using "interactive": true for a credential or provider that requires MFA, via the create credential endpoint

📘The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

Existing Credential Stops Working

New Statement Discovered Under Existing Credential

Statement Data Changed

Account Created Via File Upload

File Data Extraction Fails

Deletion Successful

Download Ready

Interval Data Extraction

👍
The resource embedded in the `data` field will be the same schema as the API response for an entity of the corresponding resource type in the `resource` field

📘
This is only emitted if the credential was submitted using `"interactive": true,`via this endpoint.

📘
This is only emitted if the credential was submitted using `"interactive": true,`via this endpoint.

📘
A pending event indicates that the data extraction failed for a presumably temporary reason, such as the provider website being down.

📘
The following events are only emitted if the credential was submitted using `"interactive": true` for a credential or provider that requires MFA, via the create credential endpoint

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

📘
The following events are only emitted if the credential was submitted using `"interactive": true` for a credential or provider that requires MFA, via the create credential endpoint

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

📘
The following events are only emitted if the credential was submitted using `"interactive": true` for a credential or provider that requires MFA, via the create credential endpoint

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

📘
The following events are only emitted if the credential was submitted using `"interactive": true` for a credential or provider that requires MFA, via the create credential endpoint

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization

📘
The following events are only emitted if the credential was submitted using `"interactive": true` for a credential or provider that requires MFA, via the create credential endpoint

📘
The remaining webhooks in this section are always emitted as long as webhooks are configured for your organization