Quickstart - Manka API

This walkthrough submits a PDF for asynchronous analysis and retrieves the result.

Prerequisites

curl https://gateway.manka.tz/v1/api/health-check

You should see:

{ "status": "ok", "latency": "12ms" }

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

Response

{
  "status": "processing",
  "task_id": "3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718"
}

Save the task_id — you’ll need it for polling.

curl https://gateway.manka.tz/v1/api/analysis/3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718 \
  -H "Authorization: Bearer $MANKA_API_TOKEN"

The response moves through three terminal states:

{
  "status": "processing",
  "task_id": "3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718"
}

{
  "status": "completed",
  "task_id": "3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718",
  "result": { "...": "..." }
}

{
  "status": "failed",
  "task_id": "3f7a1c2e-8b4d-4e9f-a1b2-c3d4e5f60718",
  "error": "Unable to process this PDF"
}

Skip polling entirely by passing a callback_url when submitting — Manka will POST the final payload to that URL. See Callback payload.

Full reference for /analysis and polling.

Get the raw transaction list in a single request.

Analyse two or more statements together.

The error response shape and common status codes.