Nini API

Build on your financial data.

Prototype documentation. Endpoints, fields and responses on this page are illustrative and show the shape of the API. They are not the published reference.

Quickstart

  1. 01Get API accessFree tier, no card.
  2. 02Send a documentPOST /v1/ingest
  3. 03Get clean, structured data backTyped fields, per page.
  4. 04See where each value came fromPage and region for each field.
  5. 05Match recordsPOST /v1/match
  6. 06Connect an AI agentMCP server

Authentication

Send your key as a bearer token.

Ingest

POST/v1/ingestLIVE

Send a file. Ingest returns the document type and its fields. Every field has a source with the page and region it came from.

# Send a document to Ingest
curl https://api.nini.io/v1/ingest \
  -H "Authorization: Bearer $NINI_API_KEY" \
  -F "file=@Invoice-4471.pdf"

Response

200 OK · application/json
{
  "document_id": "doc_7Hq2pX",
  "document_type": "invoice",
  "fields": [
    {
      "name": "invoice_total",
      "value": 6637.72,
      "confidence": "high",
      "source": {
        "page": 1,
        "region": [420, 244, 508, 260]
      }
    },
    {
      "name": "po_number",
      "value": null,
      "flag": "illegible",
      "source": { "page": 1, "region": [40, 96, 180, 110] }
    }
  ]
}

Illustrative response

When a field can’t be read, value is null and flag says why. Nini never guesses.

Match

POST/v1/matchLIVE

Pass document or record IDs. Match returns each transaction with the records matched to it and what each match was based on. Unclear matches come back as suggested for your team to review. Anything that doesn’t line up comes back as a flagged item with both sides and the difference.

200 OK · flagged item
{
  "finding_id": "F-20417",
  "type": "mismatch",
  "status": "contradicted",
  "event": "evt_load_4471",
  "sides": [
    { "field": "net_weight", "value": "21.6 t", "document_id": "doc_St88213" },
    { "field": "net_weight", "value": "18.2 t", "document_id": "doc_7Hq2pX" }
  ],
  "difference": "3.4 t"
}

Illustrative response

MCP server

MCPmcp.nini.ioLIVE

Connect any MCP-compatible AI tool to Nini. Agents can read your matched financial data with the same permissions and source links your team sees.

STATUSMEANING
MATCHEDRecords agree within your tolerances.
SUPPORTEDThe records support it.
CONTRADICTEDRecords disagree. Both sides are returned.
INCOMPLETEA required record is missing.
UNRESOLVEDThe records can’t settle it. Never counted as matched.

Limits and billing

Free keys include 1,000 pages a month. Talk to us about pricing.