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
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
{
"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.
{
"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.
| STATUS | MEANING |
|---|---|
| MATCHED | Records agree within your tolerances. |
| SUPPORTED | The records support it. |
| CONTRADICTED | Records disagree. Both sides are returned. |
| INCOMPLETE | A required record is missing. |
| UNRESOLVED | The 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.