Your first request

Five minutes from zero to a structured JSON receipt.

Grab a test key

From the portal, create an sk_test_… key. Sandbox keys never bill and return the same shape as production, so it is safe to leave one in CI.

Pick a sample receipt

Use any JPG, PNG, HEIC, or PDF up to 15 MB. If you do not have one handy, download our sample NFCe (opens in a new tab).

Extract it

curl https://api.receipts.oligontech.com/v1/extract \
  -H "X-API-Key: $OLIGON_API_KEY" \
  -F "file=@receipt.jpg" \
  -F "type=nfce"

Inspect the result

Every extraction returns a Receipt with:

id — stable identifier (use this to look up the receipt later)
status — pending, processing, completed, or failed
merchant_*, total, tax, line_items — structured fields
confidence — overall score in [0, 1]
raw (SDKs only) — verbatim server JSON, so you never lose info

Persist + react

Save id and wire a webhook to receive receipt.completed events. See the webhook handler guide for runnable examples in every language.

Latency: typically 1.8–2.6 s for JPG/PNG, 2.5–4.5 s for multi-page PDF. All extract calls are idempotent on the SHA-256 of the file — retrying the same file within 24 h returns the cached result and is not billed twice.

Authentication Organizations