v2

latestSwagger 2.02026-08-0610101.9 MB
Bank account restrictions

Apply bank account restriction

Applies a restriction to a bank account.

Reason codes

CodeDescription
customer-requestAccount holder requested temporary restriction pending further instruction.
deceasedAccount holder confirmed deceased. Restricted pending estate administration.
dormantAccount inactive for 2+ years (no customer-initiated transactions).
fraud-1st-partyAccount holder is suspected perpetrator committing fraud against Griffin or third parties.
fraud-3rd-partyAccount holder is victim of account takeover by unauthorised party.
fraud-app-perpetratorAccount holder is perpetrator receiving fraudulent payments from victims.
fraud-app-victimAccount holder is victim tricked into authorising payments to a fraudulent recipient.
law-enforcementRestricted following law enforcement request, court order, or legal obligation.
money-launderingSuspected money laundering detected. Restricted pending investigation.
otherRestriction applied for reasons not covered by standard categories.
risk-appetiteAccount activity exceeds risk appetite thresholds. Restricted pending review.
sanctionsAccount holder or associated party identified on a sanctions list. Restricted pending investigation.
terrorist-financingSuspected terrorist financing. Restricted pending investigation.

Legal status

CodeDescription
suspectedRestriction due to suspicion of offence. No formal charges filed.
formal-charge-filedCustomer formally charged with an offence. Legal proceedings active.
conviction-confirmedCustomer convicted. Deposits connected with the conviction are ineligible for FSCS compensation.
not-applicableLegal status not relevant (e.g. customer requests, dormant accounts).
post/v0/bank/accounts/{bank-account-id}/restrictions

Path parameters

bank-account-idstring required

Request body

restriction-type'block' | 'freeze' required
restriction-reason-code'fraud-app-perpetrator' | 'customer-request' | 'dormant' | 'other' | 'terrorist-financing' | 'law-enforcement' | 'sanctions' | 'risk-appetite' | 'deceased' | 'fraud-app-victim' | 'fraud-3rd-party' | 'money-laundering' | 'fraud-1st-party' required
restriction-legal-status'not-applicable' | 'conviction-confirmed' | 'formal-charge-filed' | 'suspected' required
notesstring required

Response

Created

created-atstring date-time required

ISO 8601 formatted date-time.

Example response

{
  "restriction-applied-by": {
    "user-url": "/v0/users/ur.ICAgICAgICAgdXNlci1pZA",
    "user-username": "user@example.com"
  }
}