Upload File

post

https://api.taggun.io/api/validation/v1/receipt-validation/file

Validates a submitted receipt against a validation rule set supplied inline with this request — no stored campaign required. Returns pass/fail with the reasons per rule. Full route: POST https://api.taggun.io/api/validation/v1/receipt-validation/file. For stored-campaign validation, use Validate Receipts; see Receipt Validation Overview for choosing between the two modes.

🚧
Beta
Receipt Validation is in beta: request and response details may change, and the feature must be enabled on your account. Contact [email protected] to discuss enabling it or to give feedback.

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.

validation

string

required

Receipt validation rules for this request, encoded as a JSON string (multipart form fields carry text, so serialise the rules object before sending).

additionalExtractionFields

string

Optional JSON array. Currently supports ["modelNumber"].

containerId

string

length ≤ 50

Namespace for receipt similarity checks when no campaign ID is used.

incognito

boolean

Defaults to false

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

ipAddress

string

IPv4 or IPv6 address of the end user.

near

string

Geographic hint for merchant search, typically city, state, country.

referenceId

string

length ≤ 50

Caller-supplied identifier. See Duplicate & Similarity Detection.

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.

subAccountId

string

length ≤ 100

Attribute usage to a client or other subdivision within your Taggun account for reporting. Maximum 100 characters on receipt-validation requests. This does not create a separate Taggun account or subscription.

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.

Responses

200Success

400Bad request — invalid parameters, or the feature is not enabled on the account

401Missing API key

403Invalid API key