Sorry, you need to enable JavaScript to visit this website.

3 Get Verification Status by InstructionIdentification

Action

Using the InstructionIdentification you received in the previous call, proceed to make a get status by InstructionIdentification call to receive status details using the endpoint and values below.

Method GET
Endpoint https://b2b-api.nedbank.co.za/apimarket/b2b-sb/bank-verification/v1/verify/account/<InstructionIdentification>
Request
Headers
Header Value Description
x-ibm-client-id <YOUR CLIENT ID> The client ID you received when creating the app on the portal.
x-ibm-client-secret <YOUR CLIENT SECRET> The client secret you received when creating the app on the portal.
x-fapi-financial-id OB/2017/001 Financial ID.
x-fapi-customer-ip-address 101.12.212.99 Customer IP address.
x-fapi-interaction-id <RANDOM GUID> Replace with random value.
Content-Type application/json The data type being sent to the endpoint.
Response JSON
                    
{
    "Data": {
        "InstructionIdentification": "9bbcea09-cebc-4402-8146-1098918dc701",
        "VerificationStatus": "COMPLETED",
        "VerificationResult": {
            "LastNameMatched": "Y",
            "IdentificationNumberMatched": "Y",
            "InitialsMatched": "N",
            "AccountExists": "Y",
            "AccountActive": "Y",
            "AccountDormant": "N",
            "CanCreditAccount": "Y",
            "CanDebitAccount": "Y",
            "AccountTypeMatched": "Y",
            "CompleteMatch": "U",
            "EmailIDMatched": "N",
            "CellNumberMatched": "N",
            "AccountActive3Months": "Y"
        },
        "VerifiedOn": "2025-07-31T06:05:06.949Z"
    },
    "Links": {
        "Self": "https://b2b-api.nedbank.co.za/apimarket/b2b-sb/bank-verification/v1/verify/account/9bbcea09-cebc-4402-8146-1098918dc701"
    },
    "Meta": {}
}
                            
                        
Possible bank responses for each field
StatusDescription
Y Yes. The bank confirms that the field value is true.
N No. The bank confirms that the field value is false.
U Unprocessed. The bank did not process this field.