URL

post

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

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/url. 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

url

uri

required

HTTPS URL of the receipt or invoice, reachable by Taggun. HTTP, localhost, loopback, link-local, and private-network targets are rejected.

headers

object

Optional headers to forward while downloading the receipt URL.

validation

object

required

Receipt validation rules for this request. The generated example uses date and merchant name criteria; other receipt validation rule families are also accepted.

additionalExtractionFields

array of strings, unique

Additional fields to expose on extracted objects. 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