Via PDF (Step 2: Analysis Result)
Get PDF Analysis Status
Endpoint: https://api.indicina.co/api/v3/client/pdf/extract/{jobId}/status
Method: GET
Authentication: Bearer <Token>
Content Type: application/json
Note: {jobId}
in the Endpoint
Use this endpoint to retrieve the status and results of a PDF statement analysis based on an existing Job ID. The Job ID is provided in the response when you submit a PDF for analysis.
Sample Request
To get the analysis status and results, simply make a GET
request to the endpoint, replacing {jobId}
with the actual Job ID you received during the PDF statement analysis process.
Status Updates: PDF Analysis Progress
After submitting a PDF for extraction (Phase 1), you can use the Job ID to check the progress of the analysis using the endpoint mentioned earlier. Below are two possible status responses you might encounter:
1. Status: IN_PROGRESS
When the analysis is still ongoing, you will receive a response like the following:
{
"status": "success",
"data": {
"jobId": "80abdfbf-0ad4-4340-abf5-f2082f6f92f5",
"status": "IN_PROGRESS",
"scoreCardIds": [],
"message": ""
}
}
The
status
field is marked asIN_PROGRESS
, indicating that the PDF analysis is still processing. No results are available yet. The results will be available once the extraction process is completed.
2. Status: DONE
Once the analysis is complete, you will receive a DONE
status along with detailed analysis results:
{
"status": "success",
"data": {
"jobId": "80abdfbf-0ad4-4340-abf5-f2082f6f92f5",
"status": "DONE",
"scoreCardIds": [],
"message": "",
"decideResponse": {
"data": {
"id": "3d19cf61-6be9-4e48-b263-304546200bda",
"country": "Nigeria",
"currency": "NGN",
"breakdowns": [
{
"name": "salary",
"values": [
{
"date": "2022-09",
"amount": 419570.14
},
{
"date": "2022-10",
"amount": 480837.37
},
{
"date": "2022-11",
"amount": 629131.79
},
{
"date": "2023-04",
"amount": 505966.17
},
{
"date": "2023-05",
"amount": 496864.36
}
]
},
{
"name": "otherIncome",
"values": []
},
{
"name": "individualSalary",
"values": [
{
"date": "2022-09-23",
"amount": 419570.14
},
{
"date": "2022-10-21",
"amount": 480837.37
},
{
"date": "2022-11-24",
"amount": 629131.79
},
{
"date": "2023-04-20",
"amount": 505966.17
},
{
"date": "2023-05-24",
"amount": 496864.36
}
]
},
{
"name": "loan",
"values": []
},
{
"name": "loanRepayment",
"values": []
}
],
"spendAnalysis": {
"expenseChannels": [
{
"key": "atmSpend",
"value": 0
},
{
"key": "webSpend",
"value": 0
},
{
"key": "posSpend",
"value": 0
},
{
"key": "ussdTransactions",
"value": 20.94
},
{
"key": "mobileSpend",
"value": 0
},
{
"key": "spendOnTransfers",
"value": 272992.17
},
{
"key": "internationalTransactionsSpend",
"value": 0
}
],
"expenseCategories": [
{
"key": "bills",
"value": 1000
},
{
"key": "entertainment",
"value": 0
},
{
"key": "savingsAndInvestments",
"value": 0
},
{
"key": "gambling",
"value": 0
},
{
"key": "airtime",
"value": 3750
},
{
"key": "bankCharges",
"value": 1017.53
},
{
"key": "chequeWithdrawal",
"value": 0
},
{
"key": "cashWithdrawal",
"value": 0
},
{
"key": "shopping",
"value": 0
},
{
"key": "eatingOut",
"value": 1610.75
}
],
"hasRecurringExpense": "Yes",
"averageMonthlyExpenses": 456378.36,
"averageRecurringExpense": 171000
},
"accountDetails": {
"isPdfMetaDateModified": true
},
"incomeAnalysis": {
"dsr": 0,
"microSME": "No",
"gigWorker": "No",
"pensioner": "No",
"medianIncome": 488850.87,
"salaryEarner": "Yes",
"averageSalary": 506473.97,
"salaryRecency": 678,
"averagePension": 0,
"lastSalaryDate": "2023-05-24",
"salaryFrequency": "1",
"expectedSalaryDay": 24,
"averageOtherIncome": 0,
"numberSalaryPayments": 6,
"numberOtherIncomePayments": 0,
"numberSalaryInLast3Months": 0,
"numberSalaryInLast4Months": 0,
"confidenceIntervalonSalaryDetection": 0.59
},
"cashFlowAnalysis": {
"lastDay": "2023-08-07",
"firstDay": "2022-09-23",
"debitCount": 219,
"creditCount": 16,
"monthPeriod": "September - August",
"affordability": 0,
"averageDebits": 22923.114,
"averageBalance": 131009.13,
"averageCredits": 161773.114,
"closingBalance": 4425.19,
"harmonicMeanCR": 6894.96,
"harmonicMeanDR": 4.04,
"openingBalance": 0,
"accountActivity": 0.19,
"yearInStatement": "2022,2023",
"maxEmiEligibility": 45821,
"totalMonthlyDebit": [
{
"month": "2023-05",
"amount": 629261.5
},
{
"month": "2023-06",
"amount": 187203.51
},
{
"month": "2022-09",
"amount": 400053.75
},
{
"month": "2022-11",
"amount": 641612.88
},
{
"month": "2023-02",
"amount": 259818.25
},
{
"month": "2023-04",
"amount": 449236.7
},
{
"month": "2023-07",
"amount": 782428.27
},
{
"month": "2022-10",
"amount": 515130.62
},
{
"month": "2022-12",
"amount": 500000
},
{
"month": "2023-01",
"amount": 276712.26
},
{
"month": "2023-03",
"amount": 378704.26
}
],
"emiConfidenceScore": 0.08,
"totalDebitTurnover": 5020162,
"totalMonthlyCredit": [
{
"month": "2023-02",
"amount": 4000
},
{
"month": "2023-04",
"amount": 505966.17
},
{
"month": "2023-06",
"amount": 8000
},
{
"month": "2023-07",
"amount": 4000
},
{
"month": "2022-09",
"amount": 419570.14
},
{
"month": "2022-11",
"amount": 637131.79
},
{
"month": "2022-12",
"amount": 4000
},
{
"month": "2023-08",
"amount": 4000
},
{
"month": "2022-10",
"amount": 500837.37
},
{
"month": "2023-03",
"amount": 4000
},
{
"month": "2023-05",
"amount": 496864.36
}
],
"averageMonthlyDebit": [
{
"month": "2023-05",
"amount": 31463.08
},
{
"month": "2023-06",
"amount": 8509.25
},
{
"month": "2022-09",
"amount": 133351.25
},
{
"month": "2022-11",
"amount": 37741.93
},
{
"month": "2023-02",
"amount": 25981.83
},
{
"month": "2023-04",
"amount": 18718.2
},
{
"month": "2023-07",
"amount": 13726.81
},
{
"month": "2022-10",
"amount": 73590.09
},
{
"month": "2022-12",
"amount": 500000
},
{
"month": "2023-01",
"amount": 11068.49
},
{
"month": "2023-03",
"amount": 11475.89
}
],
"totalCreditTurnover": 2588369.83,
"averageMonthlyCredit": [
{
"month": "2023-02",
"amount": 4000
},
{
"month": "2023-04",
"amount": 505966.17
},
{
"month": "2023-06",
"amount": 4000
},
{
"month": "2023-07",
"amount": 4000
},
{
"month": "2022-09",
"amount": 419570.14
},
{
"month": "2022-11",
"amount": 159282.95
},
{
"month": "2022-12",
"amount": 4000
},
{
"month": "2023-08",
"amount": 4000
},
{
"month": "2022-10",
"amount": 250418.69
},
{
"month": "2023-03",
"amount": 4000
},
{
"month": "2023-05",
"amount": 496864.36
}
],
"noOfTransactingMonths": 12,
"netAverageMonthlyEarnings": 50095.61
},
"statementAccuracy": {
"checks": {
"airtimeOutlier": false,
"balanceAccuracy": false,
"transactionFeeOutlier": true
}
},
"behaviouralAnalysis": {
"loanAmount": 0,
"accountSweep": "No",
"cardRequests": 0,
"gamblingRate": 0,
"loanInflowRate": 0,
"loanRepayments": 0,
"returnedCheque": 0,
"inflowOutflowRate": "Negative Cash Flow",
"lateLoanRepayments": 0,
"selfTransferActivity": 0,
"loanRepaymentInflowRate": 0,
"topIncomingTransferAccount": "Tajudeen/David",
"topTransferRecipientAccount": "David/Tito"
},
"transactionPatternAnalysis": {
"NODWBalanceLess": {
"count": 32,
"amount": 5000
},
"lastDateOfDebit": "2023-07-31",
"highestMAWODebit": {
"month": "October",
"week_of_month": 5
},
"lastDateOfCredit": "2023-08-07",
"recurringExpense": [
{
"amount": 5000,
"description": "ref:391235623 tito george fuel"
},
{
"amount": 5000,
"description": "nip transfer tito teju interbank ref: 45312160"
},
{
"amount": 51000,
"description": "nip transfer ifo rccg city of joy parish interbank ref: 411972125"
}
],
"highestMAWOCredit": {
"month": "November",
"week_of_month": 4
},
"transactionRanges": [
{
"max": 100000,
"min": 10000,
"count": 37
},
{
"max": 500000,
"min": 100000,
"count": 17
},
{
"max": 10000,
"min": null,
"count": 179
},
{
"max": null,
"min": 500000,
"count": 2
}
],
"NODWBalanceLess5000": 32,
"transactionsLess10000": 179,
"MAWWZeroBalanceInAccount": {
"month": "March",
"week_of_month": 13
},
"mostFrequentBalanceRange": "100000-500000",
"transactionsGreater500000": 2,
"mostFrequentTransactionRange": "<10000",
"transactionsBetween10000And100000": 37,
"transactionsBetween100000And500000": 17
}
},
"status": "success",
"message": ""
}
}
}
The status
field is marked as DONE
, indicating that the analysis has completed successfully. The response contains detailed results such as income analysis, spend analysis, transaction patterns, cash flow, and more. This data can be used to assess the financial health or behavior of the customer based on the bank statement analysis.