Developer Programs

Learn

Docs

110010 Event Samples

Event Examples > Banno Event Samples > 110010 Event Samples
Information
The schema found on this page references only the Banno JSON payload that is embedded within the Banno EES event notifications. To see a full XML sample of the payload delivered by EES along with other elements provided within the EESEventInfoArray, please reference the EES FAQ.

Two-factor Authentication Required

A two factor authentication challenge was presented.

JSON
{
  "eventId": "f86b14ba-1cae-4473-a821-892e4ce2308c",
  "date": "1992-02-29T19:51:57.549Z",
  "institutionId": "cd4867f4-7adc-4af8-8b29-95c28d91543a",
  "change": {
    "affectedPerson": {
      "personId": "54421bdb-ff67-48b6-be38-921c3223830b",
      "fullName": "Benjamin Smith",
      "personIp": "68.43.226.1",
      "deviceInfo": {
        "browser": "Firefox",
        "os": "Android",
        "browserVersion": "51.0.1",
        "osVersion": "9.3.2",
        "deviceId": "bf2c71c6-ebba-4c02-b1ae-663bcd5d7a6b"
      }
    },
    "activity": "enrollment",
    "name": "TwoFAAuthenticationRequired",
    "application": "apps-authentication",
    "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
    "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
    "userName": "WilliamW",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)",
    "challengeReason": "Nothing",
    "duration": "Other",
    "systemName": "Android"
  }
}

Two-factor Authentication Code Verification

A two factor authentication code was submitted by the user.

JSON
{
  "eventId": "57193f53-1659-460a-b951-a5b7458c1709",
  "date": "2005-09-01T14:37:51.171Z",
  "institutionId": "da2aaa18-945c-49b2-b696-236272c28161",
  "change": {
    "application": "apps-authentication",
    "name": "Oob2FACodeVerified",
    "success": false,
    "failureReason": "WrongAnswer",
    "affectedPerson": {
      "personId": "59b2221b-12bf-4aef-a004-05a260880731",
      "fullName": "Mason Williams"
    },
    "activity": "login",
    "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
    "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
    "userName": "WilliamW",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)",
    "challengeReason": "Nothing",
    "duration": "Other",
    "systemName": "Android",
    "timeTaken": "0 millis",
    "state": "Success"
  }
}

Two-factor Authentication Enrollment

A user enrolled in two factor authentication.

JSON
{
  "eventId": "57193f53-1659-460a-b951-a5b7458c1709",
  "date": "2005-09-01T14:37:51.171Z",
  "institutionId": "da2aaa18-945c-49b2-b696-236272c28161",
  "change": {
    "application": "apps-authentication",
    "name": "OobTwo-factor AuthenticationEnrolled",
    "affectedPerson": {
      "personId": "a5edcb65-03cf-4762-ab6a-d5dbf3b5e31a",
      "fullName": "William Wilson",
      "personIp": "255.168.24.4"
    },
    "phoneNumber": {
      "value": "123-456-7890"
    },
    "email": {
      "value": ""
    },
    "countryCode": {
      "value": 10
    },
    "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
    "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
    "userName": "WilliamW",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
  }
}

Primary Credentials Submitted

User entered a username and password.

JSON
{
  "username": "ddhyWKPogfsh1z5z9qppzWit2skjFFpeliybbdvrKucozlcpyusvcbwijPlo",
  "affectedPerson": {
    "personId": "a6a6eecd-cd6c-4ce5-840d-b6aec68936f1",
    "personIp": "136.157.255.161",
    "deviceInfo": {
      "browser": "Chrome",
      "appVersion": "2.1.244",
      "os": "iPhone OS",
      "browserVersion": "51.0.1",
      "osVersion": "9.3.1",
      "deviceId": "6465da02-1029-46f5-a545-661a2004e552",
      "browserEngineVersion": "1"
    }
  },
  "name": "EnrolledInDigitalBanking",
  "application": "apps-authentication",
  "loginStatus": "Failed",
  "statusReason": "Wrong Password",
  "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
  "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
  "userName": "tmqouwEahp",
  "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
}

User Account Recovered

A user used the account recovery feature to reset their password, unlock their account or remember their username.

JSON
{
  "eventId": "a0678870-abb4-4307-9190-a61d154f3e19",
  "date": "1988-11-07T04:22:37.847Z",
  "institutionId": "001ec9a7-2d67-4fc0-a365-60f31fe7486b",
  "change": {
    "affectedPerson": {
      "personId": "5aa9662f-ff39-4aa6-afec-622d8346367b",
      "fullName": "Ethan Garcia",
      "personIp": "1.252.176.255",
      "deviceInfo": {
        "model": "SM-G900V",
        "browser": "Firefox",
        "appVersion": "2.0.37",
        "deviceId": "de35b152-cc0f-4997-b3ca-76b57ca797fe",
        "browserEngineVersion": "1"
      }
    },
    "name": "AccountRecovered",
    "recoveryMethod": "Username",
    "application": "apps-authentication",
    "loginStatus": "Failed",
    "statusReason": "Wrong Password",
    "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
    "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
    "userName": "tmqouwEahp",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
  }
}

Two-factor Authentication Unenrollment

A user removed their two-factor authentication.

JSON
{
  "eventId": "57193f53-1659-460a-b951-a5b7458c1709",
  "date": "2005-09-01T14:37:51.171Z",
  "institutionId": "da2aaa18-945c-49b2-b696-236272c28161",
  "change": {
    "application": "apps-authentication",
    "name": "Oob2FAEnrollmentRemoved",
    "affectedPerson": {
      "personId": "4ab29f74-84e4-4939-9946-3ded71f751b6",
      "fullName": "Mason Rodriguez"
    },
    "mfaType": "Channel",
    "newMfaType": "Channel",
    "priorMfaType": "Channel",
    "nettellerId": "0adf48bb-ab61-4454-95c3-8826a5b7c40b",
    "cmId": "f05d7527-f750-4aab-9f8f-aa82781363a4",
    "userName": "Mason",
    "oobaChannelTypeData": "Unknown",
    "newChannelType": "Unknown",
    "priorChannelType":  "Unknown"
  }
}

Password Changed

A user changed their password.

JSON
{
  "eventId": "b93d7cb3-ab5f-40c8-924d-cf50ade27edf",
  "date": "1980-01-05T09:35:37.206Z",
  "institutionId": "40923d78-a9c1-458a-8f3d-c5010830a58a",
  "change": {
    "affectedPerson": {
      "personId": "e819ae8f-5fb0-4819-80ab-1aad73e36561",
      "fullName": "Charlotte Davis",
      "personIp": "1.44.189.255"
    },
    "name": "AppPasswordChanged",
    "application": "apps-authentication",
    "passwordChangeReason": "Forgotten",
    "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
    "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
    "userName": "tmqouwEahp",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
  }
}

User Locked Out

A user entered their username and password but login was not permitted as the account is currently locked.

JSON
{
  "eventId": "e3c89ba2-55c3-45a7-abed-fa2e590e792f",
  "date": "1977-09-16T11:18:17.120Z",
  "institutionId": "33a6da07-f57a-48c8-b790-eab2166cba6b",
  "change": {
    "person": {
      "personId": "09c9945b-6e08-4136-8c00-f8479a35e311",
      "fullName": "Sophia Davis",
      "deviceInfo": {
        "deviceId": "71296668-ac8a-4eee-8bcc-b9c0b060f002",
        "osVersion": "9.2.1",
        "browser": "Firefox",
        "browserEngineVersion": "1"
      }
    },
    "name": "PersonLockedOut",
    "application": "apps-authentication"
  }
}

Password Must Be Changed

A user entered their username and password successfully but is required to change their password.

JSON
{
  "eventId": "c48a7139-53c4-413d-88d8-01af14525bb2",
  "date": "2015-06-18T06:11:22.853Z",
  "institutionId": "dc5b9ad4-776e-4ac5-a399-a7c1c8b9c324",
  "change": {
    "person": {
      "personId": "36d6bd0a-7d76-4bcf-bbfc-c0ccc16d1dcf",
      "fullName": "Mia Davis",
      "personIp": "255.1.1.17",
      "deviceInfo": {
        "model": "SM-G900V",
        "browser": "Firefox",
        "os": "iPhone OS",
        "browserVersion": "59.0.3071.115",
        "deviceId": "09c1622f-0c86-4f71-9d07-1c47972c516d",
        "browserEngineVersion": "1"
      }
    },
    "name": "PersonPasswordNeedsReset",
    "application": "apps-authentication",
    "passwordChangeReason": "AdminReset",
    "nettellerId": "f869015a-719f-11e9-a923-1681be663d3e",
    "cmId": "4c8818d0-19fc-428a-aa4e-c613d5996689",
    "userName": "tmqouwEahp",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
  }
}

User Account Dormant

Banks only

A user entered their username and password but login was not permitted as the account is currently flagged as dormant.

JSON
{
  "eventId": "66a608c8-d664-4827-adac-c20af1e3057c",
  "date": "2000-05-25T16:10:36.680Z",
  "institutionId": "331db572-5944-41f8-baab-202f808b52c5",
  "change": {
    "person": {
      "personId": "4ff22f39-ff0c-4e4c-a69c-eeb97d338ce3",
      "fullName": "Alexander Davis",
      "personIp": "1.255.1.1",
      "deviceInfo": {
        "deviceId": "d8b83f99-8000-406a-8d01-88c86c22d933",
        "browserEngine": "WebKit"
      }
    },
    "name": "PersonAccountDormant",
    "application": "apps-authentication"
  }
}

Changed Email Address

A user entered changed their registered email address.

JSON
{
   "application":"person-profile",
   "name":"ChangedEmail",
   "newEmail":"brand.new.bob@example.com",
   "oldEmail":"old.bob@example.com",
   "affectedPerson":{
      "personId":"9a2fb9a1-37a0-4f79-9ead-793563c6ec08",
      "fullName":"Bob Loblaw",
      "personIp":"176.198.1.151",
      "deviceInfo":{
         "model":"SM-G920V",
         "browser":"Chrome",
         "appVersion":"2.0.33",
         "browserEngine":"Gecko",
         "osVersion":"5.1.1",
         "deviceId":"9a4eb273-0c38-471f-bb41-cc15e563b1a3"
      }
   },
  "displayInformation" : "Email changed",
  "attributeQualifier" :  "Mobile",
  "nettellerId" : "111bef7f-f643-40c3-91e9-05c32ecdcf6b",
  "cmId" :  "332bef7f-f346-40c3-91e9-05c32ecdcf6b",
  "userName" : "JohnDoe",
  "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
}

Changed Email Address V2

A user entered changed their registered email address.

JSON
{
  "eventId" : "0d82791f-0835-46db-89ef-d8fb6b71c9d3",
  "institutionId" : "3ddad8b4-2d9d-4e96-83f6-5e6e637f114c",
  "date" : "2024-11-14T17:31:32.269173Z",
  "name" : "EmailChangedV2",
  "application" : "person-profile",
  "organization" : {
    "organizationId" : "2817c62b-0c87-4e95-8c6f-cf72e66dd43c",
    "organizationName" : "orgnization name"
  },
  "affectedConsumerUser" : {
    "personId" : "f6425983-9e9a-4f89-aa90-b80178a6d8b6",
    "fullName" : "optional full name"
  },
  "performedByConsumerUser" : {
    "personId" : "f6425983-9e9a-4f89-aa90-b80178a6d8b6",
    "fullName" : "optional full name",
    "personIp" : "10.10.10.2",
    "deviceInformation" : {
      "deviceId" : "8f888c71-d6e9-44d1-ab4b-5611c6b16e90",
      "model" : "optional",
      "brand" : "optional",
      "os" : "optional",
      "osVersion" : "optional",
      "appVersion" : "optional",
      "browser" : "optional",
      "browserVersion" : "optional",
      "browserEngine" : "optional",
      "browserEngineVersion" : "optional"
    }
  },
  "change" : {
    "oldEmail" : "old@email.com",
    "newEmail" : "new@email.com",
    "userName" : "userName"
  }
}

Changed Phone Numbers

A user entered changed their registered phone numbers.

JSON
{
  "application":"person-profile",
  "name":"PhoneNumbersChanged",
  "affectedPerson": {
    "personId":"866147fd-f0b1-469f-a8f8-f7d9eaef45ea",
    "fullName":"Sophia Jones",
    "personIp":"255.255.1.255",
    "deviceInfo":{
       "model":"SM-G920V",
       "appVersion":"2.1.0",
       "os":"Android",
       "browserVersion":"59.0.3071.115",
       "brand":"Samsung",
       "osVersion":"6.0.1",
       "deviceId":"f08ac206-6f38-4772-ae06-3563f6b24746",
       "browserEngineVersion":"1"
    }
  },
  "titleText": "Home and Work numbers updated",
  "changeTexts": ["Home number changed from 1234567890 to 0987654321", "Work number changed from 3214567890 to 8887541111"],
  "actionList": [
    {
      "action": "Change",
      "affectedValue": "0987654321",
      "changedValue": "1234567890",
      "attributeQualifier": "Home"
    },
    {
      "action": "Change",
      "affectedValue": "8887541111",
      "changedValue": "3214567890",
      "attributeQualifier": "Work"
    }
  ],
  "nettellerId" : "111bef7f-f643-40c3-91e9-05c32ecdcf6b",
  "cmId" :  "332bef7f-f346-40c3-91e9-05c32ecdcf6b",
  "userName" : "JohnDoe",
  "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
}

Changed Phone Numbers V2

A user entered changed their phone numbers.

JSON
{
  "eventId" : "0d82791f-0835-46db-89ef-d8fb6b71c9d3",
  "institutionId" : "3ddad8b4-2d9d-4e96-83f6-5e6e637f114c",
  "date" : "2024-11-14T17:31:32.269173Z",
  "name" : "PhoneNumbersChangedV2",
  "application" : "person-profile",
  "organization" : {
    "organizationId" : "2817c62b-0c87-4e95-8c6f-cf72e66dd43c",
    "organizationName" : "orgnization name"
  },
  "affectedConsumerUser" : {
    "personId" : "f6425983-9e9a-4f89-aa90-b80178a6d8b6",
    "fullName" : "optional full name"
  },
  "performedByConsumerUser" : {
    "personId" : "f6425983-9e9a-4f89-aa90-b80178a6d8b6",
    "fullName" : "optional full name",
    "personIp" : "10.10.10.2",
    "deviceInformation" : {
      "deviceId" : "8f888c71-d6e9-44d1-ab4b-5611c6b16e90",
      "model" : "optional",
      "brand" : "optional",
      "os" : "optional",
      "osVersion" : "optional",
      "appVersion" : "optional",
      "browser" : "optional",
      "browserVersion" : "optional",
      "browserEngine" : "optional",
      "browserEngineVersion" : "optional"
    }
  },
  "change" : {
    "actionList" : [
      {
        "action" : "Change",
        "affectedValue" : "(555) 555-5555",
        "changedValue" : "(111) 111-1111",
        "attributeQualifier" : "Home"
      },
      {
        "action" : "Deletion",
        "affectedValue" : "(123) 456-7890",
        "changedValue" : null,
        "attributeQualifier" : "Mobile"
      },
      {
        "action" : "Change",
        "affectedValue" : "(876) 555-4321",
        "changedValue" : "(111) 222-3333",
        "attributeQualifier" : "Work"
      },
      {
        "action" : "Addition",
        "affectedValue" : "(888) 777-6666",
        "changedValue" : null,
        "attributeQualifier" : "Work mobile"
      }
    ],
    "changeTexts" : [ 
      "Home number changed from (111) 111-1111 to (555) 555-5555",
      "Removed mobile number (123) 456-7890",
      "Work number changed from (111) 222-3333 to (876) 555-4321",
      "Added new work mobile number (888) 777-6666"
    ],
    "titleText" : "Home, mobile, work, and work mobile numbers updated",
    "userName" : "userName"
  }
}

Changed Username

A user changed their username.

JSON
{
  "eventId": "159dcd7d-44db-4478-ab30-bf8e0c86e5c5",
  "date": "1980-12-30T09:43:13.501Z",
  "institutionId": "ed332b61-aed1-44c4-b402-4213e02b56b0",
  "change": {
    "affectedPerson": {
      "personId": "ca91b419-3a8a-431b-904b-07be504f4107",
      "fullName": "Charlotte Davis",
      "deviceInfo": {
        "model": "iPhone",
        "os": "iPhone OS",
        "browserVersion": "59.0.3071.115",
        "browserEngine": "WebKit",
        "osVersion": "9.3.2",
        "deviceId": "221bef7f-f643-40c3-91e9-05c32ecdcf6b",
        "browserEngineVersion": "1"
      }
    },
    "name": "ChangedUsername",
    "oldUsername": "foo1234",
    "newUsername": "bar1234",
    "userName" : "cltdv04",
    "displayInformation" : "Username changed",
    "attributeQualifier" :  "Mobile",
    "nettellerId" : "111bef7f-f643-40c3-91e9-05c32ecdcf6b",
    "cmId" :  "332bef7f-f346-40c3-91e9-05c32ecdcf6b",
    "userAgent" : "CSBHiawathaKS/2.13.0 (iPhone; iOS 12.4.1; Scale/2.00)"
  }
}

Device Registered

A user logged in from a new device.

JSON
{
  "eventId": "a9eef6eb-f717-414c-9145-eb894ac1d00d",
  "date": "1979-09-30T21:08:48.426Z",
  "institutionId": "edf692e7-fe0b-40de-ba39-e040cc318b4c",
  "change": {
    "application": "devices",
    "name": "DeviceRegistered",
    "affectedPerson": {
      "personId": "b6e1b00c-b86d-4630-a06e-456a3cae7ec1",
      "fullName": "Benjamin Garcia",
      "personIp": "116.123.1.255"
    },
    "deviceId": "1852a68b-1815-4150-917f-80d0d43ccdf7"
  }
}

Device De-authorized

A user de-authorized a previously registered device.

JSON
{
  "eventId": "a907866c-6be9-4fd4-8809-8abf3d18cf3b",
  "date": "1993-03-22T17:42:22.501Z",
  "institutionId": "f64b104d-0601-46b1-a4d4-f8398df144f7",
  "change": {
    "application": "devices",
    "maybeDeauthorizedBy": {
      "userId": "4f01b95f-4764-492a-9465-31a999a81b7e",
      "userName": "Mia Davis",
      "userIp": "1.1.255.1"
    },
    "name": "DeviceDeauthorized",
    "info": {
          "model": "iPhone7,2",
          "brand": "Verizon",
          "osVersion": "5.1.1",
          "appVersion": "2.0.37"
    },
    "affectedPerson": {
      "personId": "fa3997c7-4b70-44fa-b819-bc039daf7944",
      "fullName": "Ethan Rodriguez",
      "personIp": "167.1.13.232"
    },
    "deviceId": "469295d4-779e-4c88-b447-cb9657e6d74d"
  }
}

All Devices De-authorized

An FI employee de-authorized all the registered devices for a specific user.

JSON
{
  "eventId": "565dc014-08a2-426d-ab42-9c5931d6bcb8",
  "date": "1979-11-12T14:07:12.089Z",
  "institutionId": "8ae890d6-ee08-473a-a10c-781681eb95f3",
  "change": {
    "affectedPerson": {
      "personId": "2d34d457-12cd-4774-87fd-cc55ef04bad9",
      "fullName": "Olivia Smith",
      "personIp": "1.110.103.6"
    },
    "maybeDeauthorizedBy": {
      "userId": "cd367cc0-ca8f-48da-81da-1113b9a4e361",
      "userName": "Emma Wilson",
      "userIp": "1.1.206.46"
    },
    "name": "AllDevicesDeauthorized",
    "application": "devices"
  }
}

High Risk - New Device Blocked

A high risk was identified with an attempt to register a new device and the new device was blocked for security.

JSON
{
  "account": null,
  "affectedConsumerUser": {
    "deviceInformation": null,
    "fullName": "Wife Banno",
    "personId": "bdfe7ee9-deb5-4f8d-b3be-de2e3b0fa946",
    "personIp": null
  },
  "affectedEnterpriseUser": null,
  "application": "apps-authorization",
  "change": {
    "challengeType": "device",
    "deviceDescription": "iOS - iPhone16,1",
    "deviceDetailsId": "a522d3052a0765862b669477464bfb244923763eac5a513c65cb8369579b1ad5",
    "httpRequestId": "907553b04fee1ab7c85833ee22cf591eb69f2c5b762c66ed0e4dfcd94b1ea906",
    "state": "failure",
    "success": false,
    "userAgent": "",
    "userName": "wife"
  },
  "company": null,
  "date": "2024-07-02T19:10:47.990Z",
  "eventId": "fed3c5ce-74e4-4376-8562-8dd166f86af0",
  "institutionId": "5db40b7a-ee76-42b3-acb9-eb7045011c2a",
  "name": "HighRiskBlockedNewDevice",
  "organization": null,
  "performedByConsumerUser": {
    "deviceInformation": {
      "appVersion": "3.14.0",
      "brand": "Apple",
      "browser": null,
      "browserEngine": null,
      "browserEngineVersion": null,
      "browserVersion": null,
      "deviceId": "EC4E9B5C-F51A-4139-9BAD-F4DE8030854F",
      "model": "iPhone16,1",
      "os": "iOS",
      "osVersion": "17.2"
    },
    "fullName": "Wife Banno",
    "personId": "bdfe7ee9-deb5-4f8d-b3be-de2e3b0fa946",
    "personIp": "174.87.77.200"
  },
  "performedByEnterpriseUser": null,
  "permission": null,
  "providerEntitlement": null
}

Have a Question?
  • Have a how-to question? Seeing a weird error? Get help on Discourse page.
  • Register for the Developer Office Hours where we answer technical Q&A, in real time, from the audience.

Did this page help you?

Last updated Thu Aug 7 2025