Skip to main content

Get Statement Analysis​

POST https://api.sat.tausi.africa/v2/tigo/2d_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/tigo/2d_analysis'
 -F fullname=Hussein \ 
 -F 'file=@TigoPesa_7865432_Statement.pdf' \
 -H 'Authorization: Bearer XXXXXXXXXXX' \

Response Sample​

  1. Status OK Response
200 OK
{
  "cash_in_transactions": {
    "agent_deposits": {
      "total_amount": 170500,
      "percentage_of_total": 28.94
    },
    "peer_to_peer": {
      "total_amount": 50260,
      "percentage_of_total": 8.53
    },
    "bank_to_wallet": {
      "total_amount": 90000,
      "percentage_of_total": 15.27
    },
    "loan_disbursements": {
      "total_amount": 0,
      "percentage_of_total": 0
    },
    "others": {
      "total_amount": 65150,
      "percentage_of_total": 11.05
    }
  },
  "total_cash_inflow": 325107,
  "cash_out_transactions": {
    "agent_withdrawals": {
      "total_amount": 6500,
      "percentage_of_total": 4.23
    },
    "peer_to_peer": {
      "total_amount": 0,
      "percentage_of_total": 0
    },
    "wallet_to_bank": {
      "total_amount": 0,
      "percentage_of_total": 0
    },
    "bill_payments": {
      "total_amount": 24500,
      "percentage_of_total": 15.87
    },
    "loan_repayments": {
      "total_amount": 50966,
      "percentage_of_total": 33.01
    },
    "others": {
      "total_amount": 76141,
      "percentage_of_total": 49.26
    }
  },
  "total_cash_outflow": 154607
}


  1. Bad Request Response
400 Bad Request
message: "<The specific error message>"

  1. Unprocessable Entity
422 Unprocessable file entity
message: "Unprocessable File Entity"

  1. Rate Limit Error
429 Rate Limited Error
message: "Rate limited resource",
nexttime:"19876543"

Rate Limiting!

Rate Limited Resource Continous Access will lead to blocking an account.

  1. Internal Server Error
500 Internal Server Error
message: "An Internal server error",