M-Pesa Statement Analysis
This analyses the pdf and generates the report. The response is in a json format.
Header Requirements
- Authorization --required
Body Params
- file --required
- fullname --required
curl example request
curl -X 'POST' 'https://api.sat.tausi.africa/v2/vodacom/1d_analysis'
-F fullname=Hussein \
-F 'file=@M_Pesa_789981_Statement.pdf' \
-H 'Authorization: Bearer XXXXXXXXXXX' \'
Response Sample
- Status OK Response
200 OK
{
"initial_info": {
"owners_number": "25575XXXXXX",
"start_date": "2023-06-30 03:25:00",
"end_date": "2024-02-26 07:12:00",
"total_days": 242,
"total_active_days": 127
},
"profile": {
"wallet_balance": 0.04,
"turnover": 48594106.0,
"number_of_transactions": 953
},
"cashin_flow": {
"total_cashin": 24489861.0,
"cashin_flow_turnover_percentage": 0.5,
"cashin_transactions": 324,
"cashin_trans_total_trans_perc": 34.0
},
"cashout_flow": {
"total_cashout": 24104245.0,
"cashout_flow_turnover_percentage": 0.5,
"cashout_transactions": 629.0,
"cashout_trans_to_total_trans_percentage": 66.0
},
"luku_info": {
"total_amount_used_to_buy_luku": 197000.0,
"maximum_amount_used_to_buy_luku": 40000.0,
"number_of_times_bought_luku": 12,
"average_amount_bought_luku": 16416.67,
"last_date_bought_luku": "2024-02-26 07:12:00"
},
"agent_deposit": {
"total_amount_deposited": 4745000.0,
"max_amount_deposited": 1000000.0,
"number_of_times_deposited": 15,
"average_amount_deposited": 316333.33,
"last_date_deposited": "2023-12-11 10:14:00",
"last_amount_deposited": 290000.0
},
"agent_withdraw": {
"total_amount_withdrawn": 2387000.0,
"max_amount_withdrawn": 1180000.0,
"number_of_times_withdrawn": 17,
"average_amount_withdrawn": 140411.76,
"last_date_of_withdrawal": "2024-02-23 09:53:00",
"last_amount_of_withdrawn": 50000.0
},
"p2p_sent_info": {
"total_amount_sent": 5162300.0,
"max_amount_sent": 665000.0,
"number_of_times_sent": 102,
"average_amount_sent": 50610.78,
"last_date_of_money_sent": "2024-02-05 08:45:00",
"last_amount_sent": 11000.0
},
"p2p_received_info": {
"total_amount_received": 5144845.0,
"max_amount_received": 1470000.0,
"number_of_times_received": 26,
"average_amount_received": 197878.65,
"last_date_of_money_received": "2023-12-16 02:17:00",
"last_amount_received": 1426.0
},
"lipa_info": {
"total_amount_paid_via_lipa": 2640700.0,
"max_amount_paid_via_lipa": 525000.0,
"number_of_times_paid_via_lipa": 94,
"average_lipa_amount": 28092.55,
"last_date_paid_via_lipa": "2024-02-22 07:49:00",
"last_amount_paid_via_lipa": 40000.0
},
"bills_info": {
"total_amount_bill_payment": 4728375.96,
"max_amount_bill_payment": 1100000.0,
"number_of_times_bill_paid": 67,
"average_bill_amount": 70572.78,
"last_date_bill_payment": "2024-02-23 09:49:00",
"last_amount_bill_payment": 602440.0
},
"crdb_info": {
"total_amount_crdb_to_wallet": 2005500.0,
"max_amount_crdb_to_wallet": 650000.0,
"number_of_crdb_to_wallet": 16,
"average_amount_crdb_to_wallet": 125343.75,
"last_date_crdb_to_wallet": "2024-02-15 01:40:00",
"last_amount_crdb_to_wallet": 15000.0
},
"nmb_info": {
"total_amount_nmb_to_wallet": 500000.0,
"max_amount_nmb_to_wallet": 250000.0,
"number_of_nmb_to_wallet": 2,
"average_amount_nmb_to_wallet": 250000.0,
"last_date_nmb_to_wallet": "2023-09-06 06:21:00",
"last_amount_nmb_to_wallet": 250000.0
},
"songesha_info": {
"total_amount_songesha_disbursed": 4612956.0,
"max_amount_songesha_disbursed": 103453.0,
"number_of_songesha_disbursed": 237,
"average_amount_songesha_disbursed": 19463.95,
"last_day_songesha_disbursed": "2024-02-26 07:12:00",
"last_amount_songesha_disbursed": 2040.0,
"total_amount_songesha_repaid": 4965529.0,
"max_amount_songesha_repaid": 111729.0,
"number_of_times_songesha_repaid": 259,
"average_amount_songesha_repaid": 19171.93,
"last_day_songesha_repaid": "2024-02-23 09:14:00",
"last_amount_songesha_repaid": 6245.0
},
"chomoka_info": {
"total_amount_chomoka_repaid": 334150.0,
"max_amount_chomoka_repaid": 73450.0,
"number_of_times_chomoka_repaid": 6,
"average_amount_chomoka_repaid": 55691.67,
"last_day_chomoka_repaid": "2023-12-02 12:53:00",
"last_amount_chomoka_repaid": 34500.0
},
"mpawa_info": {
"total_amount_mpawa_disbursed": 214650.0,
"max_amount_mpawa_disbursed": 56700.0,
"number_of_times_mpawa_disbursed": 4,
"average_amount_mpawa_disbursed": 53662.5,
"last_day_mpawa_disbursed": "2024-02-12 07:23:00",
"last_amount_mpawa_disbursed": 44550.0,
"total_amount_mpawa_repaid": 291000.0,
"max_amount_mpawa_repaid": 77000.0,
"number_of_times_mpawa_repaid": 4,
"average_amount_mpawa_repaid": 72750.0,
"last_day_mpawa_repaid": "2023-12-02 12:52:00",
"last_amount_mpawa_repaid": 77000.0
},
"mgodi_info": {
"total_amount_mgodi_disbursed": 0.0,
"max_amount_mgodi_disbursed": 0.0,
"number_of_loans_mgodi_disbursed": 0,
"average_amount_mgodi_disbursed": 0.0,
"last_day_mgodi_disbursed": "N/A",
"last_amount_mgodi_disbursed": 0.0,
"total_amount_mgodi_repaid": 100000.0,
"max_amount_mgodi_repaid": 100000.0,
"number_of_times_mgodi_repaid": 1,
"averagre_amount_mgodi_repaid": 100000.0,
"last_day_mgodi_repaid": "2023-07-26 01:54:00",
"last_amount_mgodi_repaid": 100000.0
}
}
- Bad Request Response
400 Bad Request
message: "<The specific error message>"
- Unprocessable Entity
422 Unprocessable file entity
message: "Unprocessable File Entity"
- Rate Limit Error
429 Rate Limited Error
message: "Rate limited resource",
nexttime:"19876543"
- Internal Server Error
500 Internal Server Error
message: "An Internal server error",
Rate Limiting!
Rate Limited Resource Continous Access will lead to blocking an account.