The following form allows you to search all of BT.

    1. Help
    2. Open Banking
    Open Banking
    1. Help
    2. Open Banking
    Open Banking

    Enhanced Error Handling

    The version 1.10.0 onwards of the Open Banking Data Standards requires CDR participants to support standard error codes by February 1st, 2022. The participants may continue to support any custom error codes where applicable.

    This page contains mappings between our custom error codes and the CDR standard error codes for our Open Banking APIs.

    See the Error Codes section in the consumer data standards for more information.

    Error Mapping

    This section contains mappings between our custom error codes and the CDR standard error codes. 

    Consumer Data Request Service APIs

    Applicable APIs HTTP code Error code New standard error code
    • Get Accounts
    • Get Account Detail
    • Get Bulk Balances
    • Get Balances for Specific Accounts
    • Get Account Balance
    • Get Transaction for Account
    • Get Transaction Detail
    • Get Direct Debits for Accounts
    • Get Bulk Direct Debits
    • Get Direct Debits For Specific Accounts
    • Get Scheduled Payments for Account
    • Get Scheduled Payments Bulk
    • Get Scheduled Payments For Specific Accounts
    • Get Payees
    • Get Payee Detail
    • Get Customer
    • Get Customer Detail

    400

    1001

    urn:au-cds:error:cds-all:Header/Missing
    urn:au-cds:error:cds-all:Header/Invalid

    1002

    urn:au-cds:error:cds-all:Field/Missing
    urn:au-cds:error:cds-all:Field/Invalid

    1003

    urn:au-cds:error:cds-all:Field/Invalid

    1081

    urn:au-cds:error:cds-all:GeneralError/Expected

    1086

    urn:au-cds:error:cds-all:Header/InvalidVersion

    403

    1021

    urn:au-cds:error:cds-all:Authorisation/RevokedConsent

    1041

    urn:au-cds:error:cds-all:Authorisation/InvalidConsent

    1090

    urn:au-cds:error:cds-all:Authorisation/RevokedConsent

    1091

    urn:au-cds:error:cds-all:Authorisation/InvalidConsent

    406

    1087

    urn:au-cds:error:cds-all:Header/UnsupportedVersion

    1088

    urn:au-cds:error:cds-all:Header/UnsupportedVersion

    429

    1091

    urn:au-cds:error:cds all:GeneralError/Expected

    500

    10001

    urn:au-cds:error:cds-all: GeneralError/Unexpected

    503

    10021

    urn:au-cds:error:cds-all:Service/Unavailable

    504

    10031

    urn:au-cds:error:cds-all:GeneralError/Unexpected
    • Get Transaction

    400

    1084

    urn:au-cds:error:cds-all:Field/InvalidDateTime
    • Get Payee Detail
    • Get Transaction Detail

    404

    1092

    urn:au-cds:error:cds-all:Resource/Unavailable
    • Get Balance for Specific Accounts
    • Get Direct Debits For Specific Accounts
    • Get Scheduled Payments For Specific Accounts

    422

    1095

    urn:au-cds:error:cds-banking:Authorisation/UnavailableBankingAccount
    • Get Account Balance
    • Get Account Detail
    • Get Transactions For Account
    • Get Transaction Detail
    • Get Direct Debits for Accounts
    • Get Scheduled Payments for Account

    404

    1093

    urn:au-cds:error:cds-banking:Authorisation/UnavailableBankingAccount
    • Get Accounts
    • Get Bulk Balance
    • Get Balance for Specific Accounts
    • Get Transaction for Account
    • Get Direct Debit for Accounts
    • Get Bulk Direct Debits
    • Get Direct Debits For Specific Accounts
    • Get Scheduled Payments for Account
    • Get Scheduled Payments Bulk
    • Get Scheduled Payments For Specific Accounts
    • Get Payees

    400

    1082

    urn:au-cds:error:cds-all:Field/InvalidPageSize
    • Get Accounts
    • Get Bulk Balance
    • Get Balance for Specific Accounts
    • Get Transaction for Account
    • Get Direct Debit for Accounts
    • Get Bulk Direct Debits
    • Get Direct Debits For Specific Accounts
    • Get Scheduled Payments for Account
    • Get Scheduled Payments Bulk
    • Get Scheduled Payments For Specific Accounts
    • Get Payees

    422

    1083

    urn:au-cds:error:cds-all:Field/InvalidPage

    Product Data Request Service

    Get Products API

    HTTP code Error code New standard error code
    400 406 urn:au-cds:error:cds-all:Header/Missing
    406 406 urn:au-cds:error:cds-all:GeneralError/Expected
    400 406 urn:au-cds:error:cds-all:Header/InvalidVersion
    400 406 urn:au-cds:error:cds-all:Header/UnsupportedVersion
    400 422 urn:au-cds:error:cds-all:Field/Invalid
    400 422 urn:au-cds:error:cds-all:Field/Invalid
    400 422 urn:au-cds:error:cds-all:Field/Invalid
    400 422 urn:au-cds:error:cds-all:Field/Invalid
    400 422 urn:au-cds:error:cds-all:Field/InvalidPageSize
    400 400 urn:au-cds:error:cds-all:GeneralError/Expected
    406 406 urn:au-cds:error:cds-all:Header/UnsupportedVersion
    404 422 urn:au-cds:error:cds-all:Resource/Invalid
    422 422 urn:au-cds:error:cds-all:Field/InvalidPage
    500 500 urn:au-cds:error:cds-all:GeneralError/Unexpected
    503 503 urn:au-cds:error:cds-all:Service/Unavailable
    504 504 urn:au-cds:error:cds-all:GeneralError/Unexpected

    Get Products Detail API

    HTTP code Error code New standard error code
    400 406 urn:au-cds:error:cds-all:Header/Missing
    406 406  urn:au-cds:error:cds-all:GeneralError/Expected
    400 406 urn:au-cds:error:cds-all:Header/InvalidVersion
    400 406 urn:au-cds:error:cds-all:Header/UnsupportedVersion
    404 404 urn:au-cds:error:cds-all:Resource/NotFound
    404 422 urn:au-cds:error:cds-all:Resource/NotFound
    500 500 urn:au-cds:error:cds-all:GeneralError/Unexpected
    503 503 urn:au-cds:error:cds-all:Service/Unavailable
    504 504 urn:au-cds:error:cds-all:GeneralError/Unexpected

    Get Status and Get Outages APIs

    HTTP code Error code New standard error code
    400 406 urn:au-cds:error:cds-all:Header/Missing
    406 406  urn:au-cds:error:cds-all:GeneralError/Expected
    400 406 urn:au-cds:error:cds-all:Header/InvalidVersion
    400 406 urn:au-cds:error:cds-all:Header/UnsupportedVersion
    500 500 urn:au-cds:error:cds-all:GeneralError/Unexpected
    503 503 urn:au-cds:error:cds-all:Service/Unavailable
    504 504 urn:au-cds:error:cds-all:GeneralError/Unexpected

    Get Metrics API

    HTTP code Error code New standard error code
    400 1001 urn:au-cds:error:cds-all:Header/Missing
    400 1002 urn:au-cds:error:cds-all:Header/Invalid
    406 - all:GeneralError/Expected
    400 1003 urn:au-cds:error:cds-all:Field/Invalid
    400 1086 urn:au-cds:error:cds-all:Header/InvalidVersion
    406 1087 urn:au-cds:error:cds-all:Header/UnsupportedVersion
    406 1088 urn:au-cds:error:cds-all:Header/UnsupportedVersion
    401 1021 urn:au-cds:error:cds-all: GeneralError/Expected
    403 1041 urn:au-cds:error:cds-all: GeneralError/Expected
    500 10001 urn:au-cds:error:cds-all:GeneralError/Unexpected
    503 10021 urn:au-cds:error:cds-all:Service/Unavailable
    504 10031 urn:au-cds:error:cds-all:GeneralError/Unexpected

    CDR Arrangement Revocation Endpoint API

    HTTP code Error code New standard error code
    422 101 urn:au-cds:error:cds-all: Resource/Invalid
    403 101  urn:au-cds:error:cds-all: Authorisation/InvalidArrangement
    403 102 urn:au-cds:error:cds-all: Authorisation/InvalidConsent
    403 103 urn:au-cds:error:cds-all: Authorisation/AdrStatusNotActive
    500 10001 urn:au-cds:error:cds-all:GeneralError/Unexpected