Bank Account Updated

Example Use Case

Updating the Bank Account record with the latest account balance or status to be used in ongoing monitoring.

Request Specifications

Required API Field	Definition	Notes
`timestamp`	Timestamp of the event.
One of: `external_account_id` `account_token`	Unique identifier for the Bank Account being updated.	The `account_token` is Alloy's assigned identifier for the Account record, returned in the response for `bank_account_created`/ `external_account_created` events.
One of: `external_entity_id` `entity_token`	Unique identifier of one of the Entities associated with the Account.	Not strictly required if the event is not being monitored, but recommended to include for future proofing your integration. This field has no impact on which Entities are attached to the Account, although it should match at least one of the Entities that the Account belongs to.

Required API Field

Definition

Notes

timestamp

Timestamp of the event.

One of:
external_account_id
account_token

Unique identifier for the Bank Account being updated.

The account_token is Alloy's assigned identifier for the Account record, returned in the response for bank_account_created/ external_account_created events.

One of:
external_entity_id
entity_token

Unique identifier of one of the Entities associated with the Account.

Not strictly required if the event is not being monitored, but recommended to include for future proofing your integration.

This field has no impact on which Entities are attached to the Account, although it should match at least one of the Entities that the Account belongs to.

Example Request/Response:

{
    "event_type": "bank_account_updated",
    "event_lifecycle_id": "X99-43jf-434klj",
    "event_status": "successful",
    "data": {
        "external_account_id": "105a61e2-0dd9-4c63-858b-e9d7009cdd1d",
        "external_entity_id": "9e82d5e7-ada0-4957-a8fd-4d937c99bae8",
        "timestamp": "2024-03-25T22:44:52.284Z",
        "account_balance": 185000,
        "status": "Frozen",
        "status_detail": "Awaiting verification",
        "supplemental_data": {}
    }
}

{
    "status_code": 201,
    "event_request_token": "EV-74ddyRtVhBq3eF1EuyAk",
    "_links": {
        "self": {
            "href": "/v1/events/EV-74ddyRtVhBq3eF1EuyAk"
        }
    },
    "event": {
        "event_type": "bank_account_updated",
        "event_status": "PROCESSED",
        "data": {
            "account_number": "10426757",
            "account_number_encrypted": "b848f6488f3568c8c8ef90ad4...",
            "account_number_hashed": "de92be6b6473badcec68d9a6c23f...",
            "cif_number": null,
            "account_type": null,
            "product_code": "DDA01",
            "product_name": "Alloy Business Checking",
            "opening_date": "2023-03-22T00:00:00.000Z",
            "maturity_date": null,
            "closing_date": null,
            "activation_date": null,
            "expiration_date": null,
            "meta": {
                "somedata": "string"
            },
            "routing_number": "000123456789",
            "external_ingestion_identifier": null,
            "card_network": "visa",
            "account_name": "John Doe Business",
            "tokenization_method": null,
            "merchant_category_code": null,
            "name_on_card": null,
            "account_number_last4": null,
            "avs": null,
            "account_class": "deposit",
            "country_code": "US",
            "description": null,
            "program_name": null,
            "mcc_description": null,
            "is_linked_account": false,
            "link_timestamp": null,
            "unlink_timestamp": null,
            "currency": "USD",
            "account_hash": null,
            "account_balance": "0.00",
            "credit_limit": null,
            "status": "Frozen",
            "status_detail": "Awaiting verification",
            "as_of_date": "2024-03-25T00:00:00.000Z",
            "external_account_id": "105a61e2-0dd9-4c63-858b-e9d7009cdd1d",
            "account_token": "A-veYTeL4YRlFnRsxinwt7"
        },
        "evaluations": [],
        "journey_applications": []
    }
}