Skip to main content
POST
/
analysis
Submit Statement for Analysis
curl --request POST \
  --url https://api.manka.ai/v1/api/analysis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "password": "<string>",
  "callback_url": "<string>"
}
'
{
  "status": "processing",
  "task_id": "3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718"
}

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.

Submits a bank statement PDF for asynchronous analysis. The endpoint returns a task_id immediately. Results are delivered via the optional callback_url and/or by polling GET /analysis/:task_id.
Request body must be multipart/form-data. One analysis credit is deducted on successful submission.

Request body

file
file
required
Bank statement PDF.
password
string
Password for protected PDFs. Required if the file is encrypted.
callback_url
string
URL to receive the final result payload when analysis completes. See Callback payload.

Response

status
string
required
Always "processing" on initial submission.
task_id
string
required
Identifier for the analysis job. Use it to poll for results or correlate the callback payload.
{
  "status": "processing",
  "task_id": "3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718"
}

Error responses

StatusReason
400PDF is password-protected but no password was provided
401Missing or invalid API token
402Insufficient analysis credits

Example

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