> ## 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.

# Introduction

> The Manka API turns bank statement PDFs into structured financial insight.

Welcome to the **Manka API** by Black Swan. Manka equips Financial Service Providers with user-friendly tools for precise credit risk and financial health evaluations.

The API exposes two primary capabilities:

<CardGroup cols={2}>
  <Card title="Bank Statement Analysis" icon="chart-line" href="/api-reference/analysis/submit">
    Submit a PDF and receive credit scoring, fraud signals, and 300+ extracted data points.
  </Card>

  <Card title="Transaction Extraction" icon="arrow-right-arrow-left" href="/api-reference/transactions/extract">
    Parse a PDF and get the raw transaction list with account metadata.
  </Card>
</CardGroup>

## Base URL

All requests are made against:

```
https://gateway.manka.tz/v1/api
```

## How it works

<Steps>
  <Step title="Get an API token">
    Generate a token from the Manka dashboard under **Settings → Access Tokens**.
  </Step>

  <Step title="Submit a statement">
    `POST` a PDF to `/analysis` (async) or `/transactions` (sync).
  </Step>

  <Step title="Receive results">
    Async jobs deliver to your `callback_url` and can also be polled at `GET /analysis/:task_id`.
  </Step>
</Steps>

## What you can build

* **AI credit scoring** — assess affordability and risk in seconds
* **Fraud detection** — flag tampered statements before disbursing
* **Financial analysis** — extract 300+ data points per statement for downstream models and dashboards

<Note>
  Black Swan is a registered Data Controller with the Personal Data Protection
  Commission of Tanzania (Registration Number 0-000-000-049, issued 24 May 2024)
  and is fully compliant with the Personal Data Protection Act, No. 11 of 2022.
</Note>