📄Return a Single Statement

Return a single PDF bank statements stored on a Bank Account Record.

GET {{baseUrl}}/bank-accounts/:bank_account_id/statements/:statement_id

Path Variables

Key	Type	Description
bank_account_id*	String	The UUID for a Bank Account that gets generated and returned in the POST Create new Bank Account response.
statement_id*	String	The UUID for a Bank Account that gets generated and returned in the POST Upload Bankstatement V1.0 , POST Upload Bankstatement V1.1, or Get Return All Statements of a Bank Account response.

API Responses

200 - OK

Online Login

{
    "data": [
        {
            "id": "{{statementId}}",
            "bank_account_id": "{{bankAccountId}}",
            "statement_date": "2023-01-09",
            "start_date": "2022-12-09",
            "end_date": "2023-01-09",
            "temp_url": "https://fincheck-onboarding.s3.eu-west-1.amazonaws.com/testing/client_8de80ed8-8495-428d-a6a8-acd30a9ab01a/statements/9001145117080/c5a6beab-727c-4019-a654-cd5ceaf2f543/bank_account/62796664946-0.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAQOIKJL7BXFF7LDWP%2F20230118%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20230118T170012Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=868205de3c818e119b73b10e8ea4248e95e15cdafe8096bd71ef21465809d4c3",
            "expires_in": "60m",
            "file": {
                "id": 2718,
                "name": "62796664946-0.pdf",
                "type": "pdf",
                "url": "https://dev.apply.fincheck.co.za/fincheck/documents/62796664946-0.pdf"
            },
            "transaction_count": 101,
            "month": "Dec 2022",
            "fraud": null
        }
    ]
}

Manual Upload

{
    "data": [
        {
            "id": "{{statementId}}",
            "bank_account_id": "{{bankAccountId}}",
            "statement_date": "2023-03-28",
            "start_date": "2023-02-28",
            "end_date": "2023-03-28",
            "temp_url": "https://fincheck-onboarding.s3.eu-west-1.amazonaws.com/uat/client_67ec56bb-0901-4dd6-91a3-4d9d4231cd9e/bank_accounts/9208010020089/a0938ebc-decc-4060-873b-953d0ec7630c/bank_account/1.8-FNB_PREMIER_CURRENT_ACCOUNT_13.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAQOIKJL7BXFF7LDWP%2F20230502%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20230502T105323Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=54b29dea69b10a6706a75142ea1cb5330517adafaf39c097d2ee043de2f646e9",
            "expires_in": "60m",
            "file": {
                "id": 1041,
                "name": "1.8 FNB_PREMIER_CURRENT_ACCOUNT_13.pdf",
                "type": "pdf",
                "url": "http://uat.apply.fincheck.co.za/gathr/documents/1.8%20FNB_PREMIER_CURRENT_ACCOUNT_13.pdf"
            },
            "transaction_count": 75,
            "month": "Feb 2023",
            "fraud": {
                "fraud_checks": {
                    "statement_balance": false,
                    "create_date": false,
                    "meta_mod_date": false,
                    "meta_producer": false,
                    "meta_creator": false,
                    "meta_author": false
                },
            "processed": true
        }
    ]
}

USSD

400 - Bad Request

Inactive Online Login Session

{
    "data": "Online Banking Login Session has not been activated."
}

Incomplete Online Login Session

{
    "data": "Online Banking Login Session Incomplete."
}

Failed Online Session

{
    "data": "Online Banking Login Session Failed."
}

Expired Online Session

{
    "data": "Online Banking Login Session has expired."
}

404 - Not Found

Invalid Parameter

{
    "errors": {
        "code": "entity_not_found",
        "message": "Record not found in module_bank_accounts"
    }
}