Upload File (simple)

post

https://api.taggun.io/api/receipt/v1/simple/file

Upload a receipt or invoice file and get the core fields back — total amount, tax amount, date, and merchant details — in a compact response. Use it when your integration does not need verbose fields. Need line items, entities, or advanced features? Use Upload File (verbose).

Use a supported file type. A request-size limit applies; see Document Types & File Requirements for the current requirements.

See a complete example simple response, then use Understanding Your Results to interpret it. Authentication and common parameters are defined once in the Taggun API Reference.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

file

required

Supported receipt or invoice file that meets the current Document Types & File Requirements.

extractTime

boolean

Defaults to false

Set to true to return the time when found on the receipt. Otherwise, time is set to 12:00:00.000.

language

string

Optional language hint; leave empty for automatic detection. Recommended for Arabic (ar), Khmer (kh), Thai (th), and Hebrew (he). Full code list: Language detection and hints.

near

string

A location (city, state, country) to help search for the merchant.

ipAddress

string

length ≤ 100

End user's IP address, used for GeoIP lookup. When context is available, a verbose response can include a root location object for this IP; it is separate from the extracted merchant address.

ignoreMerchantName

string

Specify a merchant name to ignore if it is detected on the file, such as a customer name mistaken for the merchant.

refresh

boolean

Defaults to false

Set to true to force reprocessing if the receipt is already stored.

incognito

boolean

Defaults to false

Per-request storage opt-out. See Security, Privacy & Data Residency.

userId

string

length ≤ 50

End-user identifier associated with the submission and returned with matched receipts, when available, so cross-user reuse can be investigated.

containerId

string

length ≤ 50

Scopes duplicate and similarity checks to scans with the same caller-defined value. Omit to compare account-wide.

subAccountId

string

length ≤ 50

Attribute usage to a client or other subdivision within your Taggun account for reporting. This does not create a separate Taggun account or subscription.

referenceId

string

length ≤ 50

Caller-supplied identifier. See Duplicate & Similarity Detection.

Responses

413

Request body exceeds the 20 MiB (20,971,520-byte) HTTP body limit — multipart framing and base64 expansion count toward the measured body. See Document Types & File Requirements.

200Simple extraction result

400Bad request — the required file is missing or the payload is invalid

401Missing API key

403Invalid API key

429API rate limit exceeded

502Upstream processing error — example body illustrative, pending Engineering confirmation of the public envelope