Skip to main content
POST
/
transactions
Extract Transactions
curl --request POST \
  --url https://api.manka.ai/v1/api/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "password": "<string>"
}
'
{
  "name": "Jane Doe",
  "account": "0012345678",
  "contacts": "+254712345678",
  "company": "Equity Bank",
  "currency": "KES",
  "currency_code": "KES",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "no_of_transactions": 142,
  "transactions": [
    {
      "date": "2024-01-03",
      "description": "MPESA RECEIVED",
      "amount": 5000,
      "type": "credit",
      "balance": 23450.5
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.manka.tz/llms.txt

Use this file to discover all available pages before exploring further.

Parses a bank statement PDF and returns the raw transaction list along with account metadata. Unlike /analysis, this endpoint is synchronous — the parsed result is returned in the same response.
Request body must be multipart/form-data. One analysis credit is deducted per successful call.

​
Request body

​
file
file
required
Bank statement PDF.
​
password
string
Password for protected PDFs. Required if the file is encrypted.

​
Response

​
name
string
Account holder name as printed on the statement.
​
account
string
Account or mobile number.
​
contacts
string
Contact number on file with the issuer.
​
company
string
Issuing institution, e.g. "Equity Bank", "Vodacom".
​
currency
string
Currency name or ISO code as printed on the statement.
​
currency_code
string
ISO 4217 currency code (e.g. "KES", "TZS").
​
start_date
string
ISO 8601 date of the first transaction in the statement period.
​
end_date
string
ISO 8601 date of the last transaction in the statement period.
​
no_of_transactions
integer
Total number of transactions returned in transactions.
​
transactions
array
Ordered list of parsed transactions.
{
  "name": "Jane Doe",
  "account": "0012345678",
  "contacts": "+254712345678",
  "company": "Equity Bank",
  "currency": "KES",
  "currency_code": "KES",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "no_of_transactions": 142,
  "transactions": [
    {
      "date": "2024-01-03",
      "description": "MPESA RECEIVED",
      "amount": 5000,
      "type": "credit",
      "balance": 23450.5
    }
  ]
}

​
Error responses

StatusReason
400PDF is password-protected or in an unrecognisable format
401Missing or invalid API token
402Insufficient analysis credits

​
Example

curl -X POST https://api.manka.ai/v1/api/transactions \
  -H "Authorization: Bearer $MANKA_API_TOKEN" \
  -F "file=@statement.pdf"