Quick Start Guide

Start scanning receipts and invoices with Taggun's API in a few minutes.

1. Sign up

Create your Taggun account at taggun.io/sign-up.

2. Get your API key

After signing in, your API key is sent to your email inbox.

If you do not see it, check your spam folder.

3. Upload your first receipt

Use Upload File (simple) to send a receipt or invoice file and receive a compact JSON response.

The file upload endpoint accepts PDF, JPG, PNG, GIF, and HEIC files up to 20 MB.

curl --request POST \
     --url https://api.taggun.io/api/receipt/v1/simple/file \
     --header 'accept: application/json' \
     --header 'apikey: YOUR_API_KEY' \
     --header 'content-type: multipart/form-data' \
     --form extractTime=false \
     --form refresh=false \
     --form incognito=false \
     --form file='@example-file.png'

Replace YOUR_API_KEY with your API key and update @example-file.png to the path of the receipt or invoice file you want to scan.

4. Read the JSON response

The simple endpoint returns the most common receipt fields with confidence scores.

{
  "totalAmount": {
    "data": 5.98,
    "confidenceLevel": 0.92
  },
  "taxAmount": {
    "data": 0.27,
    "confidenceLevel": 0.92
  },
  "confidenceLevel": 0.898,
  "date": {
    "data": "2024-03-22T12:00:00.000Z",
    "confidenceLevel": 0.92
  },
  "merchantName": {
    "data": "Chemist Warehouse",
    "confidenceLevel": 0.81
  }
}

For more fields, use Upload File (verbose).

Beyond your first scan

The simple file endpoint is the fastest way to test extraction. From there, you can:

• Extract richer receipt and invoice data with verbose responses
• Capture line items and other fields with detailed data extraction
• Validate receipts against campaign rules with receipt validation

For the full request schema, see the Upload File (simple) API reference.